Description
ChatJox provides a self-hosted live-chat widget for WordPress. Chat messages are stored on the WordPress site. The plugin does not require a ChatJox account, license key, paid activation, or an external ChatJox service.
Main features:
- Responsive live-chat interface for desktop, Android and iOS.
- RTL-first interface suitable for Persian websites.
- Full-screen mobile mode with iOS Visual Viewport and Safe Area handling.
- Operator inbox inside the WordPress dashboard.
- Open, close, archive, search and delete conversations.
- Three availability modes: scheduled working hours, always online and always offline.
- Configurable working days, start time, end time and overnight shifts.
- Keyword-based automated replies with per-rule enable/disable controls.
- Configurable quick replies for visitors.
- Optional visitor name, email and mobile-number collection before starting a chat.
- Separate local database archive for unique email addresses and mobile numbers.
- File uploads with configurable size and extension limits.
- Clickable URLs inside chat messages.
- Text and file metadata can be delivered as one Telegram notification.
- Optional Telegram Bot integration for receiving website messages and replying from Telegram.
- Optional floating contact menu for chat, phone, WhatsApp, Telegram, Rubika and custom links, with icon/compact/card layouts, per-channel colors, descriptions, ordering and icon-only mode.
- Advanced launcher customization including position, desktop/mobile size, shape, animation, label mode, colors, preset icon, emoji or uploaded image.
- Custom desktop and mobile chat dimensions, bubble/input radii, shadows, typography and detailed color controls.
- Persian-oriented typography choices for Vazirmatn, Estedad and Shabnam when those fonts are available locally or supplied by the active site/theme; no mandatory external font CDN is used.
- Selective cleanup for chats, files and logs.
- Lazy loading, adaptive polling and polling suspension in hidden browser tabs.
All functionality included in the plugin is available without artificial feature gating, usage quotas, trial periods, or license checks.
External services
ChatJox works without any external ChatJox service. It contacts an external service only when the site administrator explicitly enables and configures the Telegram integration.
Telegram Bot API
When Telegram integration is enabled, ChatJox communicates with the Telegram Bot API at api.telegram.org to register a webhook, validate the configured bot, deliver visitor messages and uploaded-file links to the connected administrator chat, and receive administrator replies.
Data that may be sent to Telegram when this optional integration is enabled includes the visitor display name, conversation ID, message text, uploaded-file URL and file name, plus the administrator bot/chat identifiers required for message delivery. The plugin does not enable this connection by default.
Telegram Terms of Service: https://telegram.org/tos
Telegram Privacy Policy: https://telegram.org/privacy
Telegram Bot API documentation: https://core.telegram.org/bots/api
The optional WhatsApp, Telegram and Rubika contact buttons are ordinary administrator-configured links. ChatJox does not call those services merely by displaying the buttons; a visitor chooses whether to open a configured link.
Privacy
ChatJox can store chat messages, uploaded files, visitor IP addresses and browser user-agent strings on the WordPress site. Depending on administrator settings, it can also collect visitor names, email addresses and mobile numbers.
When email or mobile collection is enabled, unique email addresses and mobile numbers are additionally retained in a separate ChatJox contact-archive table in the local WordPress database. Normal chat cleanup does not remove this archive. If the administrator disables the plugin’s keep-data option before uninstalling ChatJox, the archive table is removed together with the other ChatJox tables.
ChatJox also adds suggested privacy-policy text to WordPress Privacy settings so site owners can adapt it to their site and jurisdiction.
If Telegram integration is enabled, see the External services section above for information about data sent to Telegram.
Screenshots
Installation
- Upload the
chatjoxfolder to/wp-content/plugins/, or install the ZIP from Plugins > Add New > Upload Plugin. - Activate ChatJox.
- Open the ChatJox menu in the WordPress dashboard.
- Configure the widget, working hours, automated replies, file settings and optional communication channels.
- If Telegram replies are needed, explicitly enable the Telegram integration and enter a BotFather token.
FAQ
-
Does ChatJox require an account or license?
-
No. The plugin runs on the WordPress site and does not include a license check, trial period, or paid feature gate.
-
Is Telegram required?
-
No. Telegram integration is disabled by default and is only used after the site administrator explicitly enables it and provides a bot token.
-
Why does the Telegram webhook require HTTPS?
-
Telegram must be able to reach the WordPress REST endpoint from the internet, so the site needs a valid HTTPS connection and an accessible REST API.
-
Can the online or offline status be controlled manually?
-
Yes. ChatJox provides scheduled working hours, always-online and always-offline modes.
-
Can the floating chat launcher be customized?
-
Yes. The launcher can be positioned on the right, center or left, and its size, icon, emoji or custom image can be changed.
-
Does chat cleanup remove the email and mobile contact archive?
-
No. The local contact archive is stored separately in the WordPress database. It is removed on uninstall only when the administrator has disabled the keep-data option.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“ChatJox – چت آنلاین و پشتیبانی” is open source software. The following people have contributed to this plugin.
Contributors
Translate “ChatJox – چت آنلاین و پشتیبانی” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
0.0.3
- Fixed clipping of custom launcher emoji/icons on Windows browsers.
- Added a cross-platform emoji font fallback stack for the launcher.
- Improved custom launcher image fitting so uploaded icons are contained instead of cropped.
0.0.2
- Rebuilt the frontend chat UI around one consistent design system.
- Added advanced color controls for header, messages, composer, input, launcher, badge, quick replies and action menu.
- Added Persian-oriented typography choices, font weights and font-size controls without requiring an external font CDN.
- Consolidated the floating launcher/action menu into one implementation with icon, compact and card layouts.
- Added independent desktop/mobile launcher and action-item sizing, offsets, launcher shapes and lightweight animations.
- Added per-channel title, description, color, order and icon-only controls plus richer custom-link settings.
- Added optional WhatsApp prefilled text.
- Improved mobile/iPhone viewport, safe-area, keyboard and composer handling while preserving existing chat logic.
0.0.1
- Initial public release of ChatJox.
- Live chat, operator inbox, working-hours availability and manual online/offline override.
- Keyword auto replies and quick replies.
- Optional Telegram Bot reply workflow.
- Optional visitor name, email and mobile collection with permanent local contact archives.
- File uploads, clickable message links and chat cleanup tools.
- Custom launcher position, size and preset or custom icon/image.
- Configurable floating contact menu with chat, phone, WhatsApp, Telegram, Rubika and custom links.
- Responsive mobile UI including iOS viewport handling.
- Frontend and dashboard polling optimizations.