پشتیبانک — Poshtibank

همه پشتیبانی سایت، در یک افزونه. سیستم چت آنلاین حرفه‌ای و رایگان وردپرس متصل به تلگرام و بله، بدون سرور واسط.

by آرمان محبعلی · github.com/rmaawn/poshtibank · website

★ 0stars

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/rmaawn/poshtibank/archive/refs/heads/main.zip

No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.

Readme github.com/rmaawn/poshtibank ↗

شعار: همه پشتیبانی سایت، در یک افزونه

پشتیبانک (Poshtibank) یک افزونه چت آنلاین و هاب پشتیبانی مشتریان برای وردپرس به صورت ۱۰۰٪ رایگان، متن‌باز (Open-Source) و بدون نیاز به هیچ‌گونه سرور واسط (SaaS-Free) است.

در این افزونه، تمام پیام‌های کاربران سایت به صورت زنده از طریق API رسمی به ربات‌های تلگرام و پیام‌رسان بله ارسال شده و ادمین با ریپلای زدن روی پیام در تلگرام یا بله، مستقیماً به کاربرِ داخل سایت پاسخ می‌دهد.

🌟 قابلیت‌های برجسته

ارتباط دوطرفه پایدار با تلگرام و بله:
- پاسخگویی همزمان در تلگرام (api.telegram.org) و بله (tapi.bale.ai).
- دور زدن تضمینی فیلترینگ تلگرام در هاست‌های ایران با ورکر اختصاصی کلودفلر (Cloudflare Worker Reverse Proxy).
- پشتیبانی از تاپیک‌های سوپرگروه تلگرام (Forum Topics) برای مدیریت چند اپراتوره بدون تداخل گفتگوها.
- دکمه‌های شیشه‌ای عملیاتی زیر پیام‌ها (مسدودسازی، مشاهده مشخصات کاربر و بستن گفتگو).
ویجت فرانت‌اند فوق سبک (Vanilla JS & Modern CSS):
- بدون وابستگی به jQuery یا فریم‌ورک‌های سنگین (۱۰۰٪ Pure Vanilla JS).
- Adaptive Short Polling: پولینگ هوشمند ۳ ثانیه‌ای در حالت فعال، افزایش پلکانی به ۱۰ و ۳۰ ثانیه در زمان بی‌حرکتی، و توقف کامل در زمان بسته بودن پنجره.
- صدای نوتیفیکیشن با Web Audio API: تولید نغمه ملایم ۲ صدایی بدون نیاز به دانلود فایل صوتی.
- چشمک‌زن شدن داینامیک عنوان تب مرورگر در زمان دریافت پیام در تب‌های پس‌زمینه.
تعاملات چندرسانه‌ای (Rich Media):
- ضبط و ارسال ویس دوطرفه با MediaRecorder API در مرورگر و ارسال مستقیم با sendVoice.
- پخش پیام‌های صوتی ادمین با Audio Player مینیمال و اختصاصی.
- اسکرین‌شات سریع از صفحه فعلی کاربر و ارسال به ادمین با sendPhoto.
- آپلود امن تصاویر و فایل‌ها با اعتبارسنجی MIME و مسدودسازی اجرای اسکریپت‌ها با .htaccess.
یکپارچگی عمیق با ووکامرس (WooCommerce Integration):
- تشخیص خودکار صفحه محصول و ارسال نام، قیمت، وضعیت موجودی و عکس شاخص به سربرگ پیام ادمین.
- نمایش سبد خرید زنده (Live Cart) و تعداد اقلام در صفحه تسویه‌حساب و سبد خرید.
- استخراج تعداد کل سفارشات قبلی مشتری لاگین‌شده و وضعیت آخرین سفارش.
- دستورات تعاملی ربات:
  - ارسال /product <شناسه یا نام> در تلگرام/بله برای درج آنی کارت محصول با دکمه خرید در چت کاربر.
  - ارسال /coupon <کد تخفیف> برای ارسال کارت کوپن تخفیف با دکمه کپی فوری.
اتوماسیون، پیام‌های پیشدستانه و هوش مصنوعی:
- پیام پیشدستانه خروج (Exit-Intent Trigger): باز شدن خودکار پیشنهاد کمک در زمان تشخیص قصد خروج کاربر.
- کاهش سبدهای رهاشده (Checkout Hesitation): پیام راهنمایی در صورت توقف طولانی در صفحه پرداخت.
- هوش مصنوعی خط اول (BYOK AI Responder): پاسخگویی هوشمند اولیه با کلید شخصی Google Gemini یا OpenAI، و انتقال خودکار به اپراتور انسانی در صورت درخواست کاربر.
- انتقال بدون قطعی گفتگو (Seamless Handoff): دیپ‌لینک اختصاصی برای ادامه گفتگو در تلگرام و بله.
- ثبت رضایت مشتری (CSAT Rating): نظرسنجی ۵ ستاره پس از پایان مکالمه.
دیتابیس بهینه و امنیت چندلایه‌ای:
- جداول اختصاصی poshtibank_sessions و poshtibank_messages با dbDelta بدون ایجاد بار روی جدول wp_posts.
- پاکسازی خودکار دوره‌ای تاریخچه چت‌ها با WP-Cron.
- فیلد مخفی ضد ربات (Honeypot) و Rate Limiting هوشمند به همراه بلک‌لیست خودکار آی‌پی‌های مهاجم.

🚀 راهنمای راه‌اندازی و تنظیمات

۱. نصب افزونه

پوشه افزونه را در مسیر wp-content/plugins/poshtibank قرار داده و از منوی افزونه‌های وردپرس آن را فعال کنید.

۲. اتصال به تلگرام

در تلگرام به ربات @BotFather پیام دهید و با دستور /newbot یک ربات جدید بسازید و توکن آن را کپی کنید.
آیدی عددی اکانت خود یا سوپرگروه پشتیبانی را از طریق رباتی مانند @userinfobot به دست آورید.
در پیشخوان وردپرس > پشتیبانک > تب پل تلگرام، توکن و Chat ID را وارد کنید.
روی دکمه «ثبت خودکار وبهوک (Set Webhook)» کلیک کنید (دامنه سایت باید دارای گواهینامه SSL معتبر باشد).

۳. دور زدن فیلترینگ تلگرام در هاست‌های ایران (Cloudflare Worker Proxy)

اگر هاست سایت شما در داخل کشور قرار دارد، یک ورکر رایگان در Cloudflare بسازید و کد زیر را در آن قرار دهید:

export default {
  async fetch(request) {
    const url = new URL(request.url);
    url.hostname = 'api.telegram.org';
    return fetch(url.toString(), {
      method: request.method,
      headers: request.headers,
      body: request.body,
    });
  },
};

سپس آدرس ساب‌دامین ورکر (مثلاً https://my-proxy.workers.dev) را در فیلد «پروکسی معکوس / ورکر کلودفلر» قرار دهید.

۴. اتصال به پیام‌رسان بله

در پیام‌رسان بله به بازوی @BotFather پیام داده و ربات پشتیبانی خود را بسازید.
توکن ربات و شناسه عددی چت را در تب پیام‌رسان بله وارد کنید.
روی دکمه «ثبت خودکار وبهوک بله» کلیک کنید.

⌨️ راهنمای دستورات ادمین در تلگرام و بله

دستور	توضیح	مثال
`/product <id or name>`	ارسال کارت محصول ووکامرس در چت کاربر	`/product 105` یا `/product کفش`
`/coupon <code>`	ارسال کارت کوپن تخفیف با کلید کپی آسان	`/coupon OFF40`
`/close`	بستن گفتگو و ارسال فرم نظرسنجی رضایت به کاربر	`/close`
`/block`	مسدودسازی کامل نشست و آی‌پی کاربر	`/block`
`/help`	مشاهده راهنمای دستورات	`/help`

🛠 معماری مخزن گیت و شاخه‌ها

main: نسخه رسمی، پایدار و تست‌شده.
develop: شاخه فعال توسعه ماژول‌ها.
کامیت‌ها منطبق بر استاندارد Conventional Commits ثبت شده‌اند.

📄 لایسنس

پشتیبانک تحت پروانه نرم‌افزار آزاد GNU General Public License v2 (یا بالاتر) منتشر شده و ۱۰۰٪ رایگان و متن‌باز است. مشاهده متن کامل پروانه: LICENSE