About this plugin
KafiChat Lite is a free, lightweight live chat plugin that bridges your WordPress website with the Bale messenger platform. Your visitors can chat with you directly from your website, and you receive and respond to their messages through your Bale bot.
Key Features:
- Real-time Chat: Instant messaging between website visitors and your Bale bot.
- Guest Form: Collect visitor name and phone number before starting the chat.
- Smart Adaptive Polling: Efficient message checking using Page Visibility API (stops polling when the tab is inactive to save server resources).
- RTL Support: Fully optimized for Persian/Farsi websites with built-in Vazirmatn font.
- Mobile Responsive: Works perfectly on all screen sizes with a beautiful overlay.
- Customizable: Change position, header title, and welcome message.
- Secure: Encrypted PII (Name/Phone/IP) using Libsodium/OpenSSL, nonce verification, and advanced rate limiting.
- CDN Compatible: Correctly identifies real client IPs behind Cloudflare and ArvanCloud.
- Lightweight: No jQuery dependency, vanilla JavaScript, minimal footprint.
- Webhook Integration: Automatic message routing from Bale to your website.
- Admin Dashboard: Full settings panel with debug tools, system info, and conversation logs.
—
برای کاربران فارسی‌زبان:
این افزونه کاملاً برای سایت‌های فارسی‌زبان بهینه‌سازی شده است:
✅ ویژگی‌های اختصاصی برای ایران:
– پشتیبانی کامل از RTL (راست‌چین)
– فرم مهمان فارسی با اعتبارسنجی شماره موبایل ایرانی
– پنل ادمین کاملاً فارسی با فونت زیبای وزیر
– اتصال مستقیم به پیام‌رسان بله
– نمایش ساعت به وقت ایران
– سازگاری کامل با شبکه‌های توزیع محتوا (CDN) مانند کلودفلر و آروان
✅ نصب آسان:
1. افزونه را نصب و فعال کنید
2. از @BotFather در بله، توکن ربات بگیرید
3. توکن و شناسه چت ادمین را وارد کنید
4. وب‌هوک را تنظیم کنید
5. ویجت چت به‌صورت خودکار نمایش داده می‌شود
✅ پشتیبانی از هاست‌های ایرانی:
– سازگار با هاست‌های اشتراکی ایرانی
– پشتیبانی از هاست‌هایی که هدرهای امنیتی را حذف می‌کنند
– بهینه‌سازی شده برای سرورهای ایران
How It Works:
- Install and activate KafiChat Lite.
- Create a bot on Bale messenger via @BotFather.
- Enter your bot token and admin chat ID in the plugin settings.
- Configure the webhook to receive messages from Bale.
- The chat widget appears on your website automatically.
Privacy:
KafiChat Lite stores conversation data and messages in your WordPress database. Sensitive guest data (Name, Phone, IP) is encrypted at rest. No data is sent to third-party servers except Bale messenger API.
You can configure data retention periods in the settings.
External services
This plugin connects to the Bale messenger platform to enable live chat between website visitors and site administrators.
What the service is and what it is used for
Bale is an Iranian messaging platform. This plugin uses the Bale Bot API to:
– Send user messages from your website to the administrator’s Bale account
– Receive administrator responses and display them to website visitors
– Set up webhooks for real-time message delivery
What data is sent and when
- When a visitor sends a message through the chat widget, the message content, visitor name (if provided), and phone number (if provided) are sent to the Bale Bot API
- The administrator’s Bale Bot Token and Chat ID are used to authenticate and route messages
- No data is sent unless the administrator has configured a Bale Bot Token in the plugin settings
Links to service terms and policies
- Bale Terms of Service & Privacy Policy: https://bale.ai/terms
- Bale Bot API Documentation: https://docs.bale.ai
License
This plugin is licensed under the GPLv2 or later.
Credits
Developed by Kafgram.