Mesora is an open-source live chat plugin built for fast, contextual, pre‑sales conversations on WordPress.
Website: https://milmit.net
Mesora is designed for live pre‑sales support, not for turning a simple chat into a heavy ticketing system.
It keeps the visitor experience inside WordPress while allowing operators to answer from supported messaging platforms.
- ⚡ Fast website chat experience
- 🛍️ WooCommerce product context
- 💬 Telegram Forum Topics
- 🟣 Bale integration
- 🟢 Eitaa integration
- 🟩 WhatsApp Business Cloud API
- 🌍 Optional self‑hosted Relay
- 🎙️ Voice notes and file attachments
- 🔐 Secure signed media links
- 👤 Visitor context and IP controls
- 🧠 Quick replies and internal notes
- 🌐 WPML / Polylang ready
- 🛡️ WordPress privacy exporter / eraser integration
- 🚫 No telemetry sent to MilMit by default
| Feature | Status |
|---|---|
| WordPress live chat | ✅ |
| WooCommerce context | ✅ |
| Telegram two-way messaging | ✅ |
| Telegram Forum Topics | ✅ |
| Bale | ✅ |
| Eitaa | ✅ |
| WhatsApp Business Cloud API | ✅ |
| Self-hosted Relay | ✅ |
| Voice messages | ✅ |
| File / image attachments | ✅ |
| Secure signed URLs | ✅ |
| Visitor blocking | ✅ |
| IP context | ✅ |
| Quick replies | ✅ |
| Internal notes | ✅ |
| WPML / Polylang support | ✅ |
| Privacy export / erase | ✅ |
flowchart LR
V[Website Visitor] --> W[WordPress + Mesora]
W --> T[Telegram]
W --> B[Bale]
W --> E[Eitaa]
W --> WA[WhatsApp Business]
W --> R[Optional Self-Hosted Relay]
R --> T
R --> WA
T --> W
B --> W
E --> W
WA --> W
Mesora can communicate with supported services directly or use an optional Relay when the WordPress server has restricted or unreliable connectivity.
When a visitor opens chat from a product page, Mesora can provide useful product context to the operator, including:
- Product name
- Price
- Stock state
- Product URL
- Current page
- Visitor details
This helps operators answer purchase questions without asking the visitor to repeat what they are viewing.
Mesora can organize website conversations inside Telegram Forum Topics.
Each visitor can have a dedicated Topic with a clean operator card containing:
- Visitor information
- IP / block status
- Current page
- WooCommerce product context
- Conversation controls
- Quick replies
For hosting environments where direct access to some external APIs is unreliable, Mesora supports an optional self-hosted Relay.
WordPress Server
│
▼
Self‑Hosted Relay
│
├── Telegram
└── WhatsApp Business
The Relay is hosted and controlled by the site owner.
Mesora does not require a MilMit-hosted relay service.
- Download the latest release.
- Open WordPress Admin.
- Go to Plugins → Add New → Upload Plugin.
- Upload the Mesora ZIP.
- Activate Mesora.
- Open Mesora → Settings.
git clone https://github.com/milmit/mesora-wordpress-live-chat.gitThen copy the plugin directory into:
wp-content/plugins/
- WordPress 5.8+
- PHP 7.4+
- HTTPS recommended for webhook integrations
Optional:
- WooCommerce
- WPML
- Polylang
- Telegram Bot
- Bale
- Eitaa
- WhatsApp Business Cloud API
- Self-hosted Relay
Mesora may store data required to provide live chat functionality, including:
- Message content
- Timestamps
- Visitor name
- Phone number
- Email address
- IP address / IP fingerprint
- Browser user agent
- Landing page and referrer context
- Attachments
- Conversation state
If an optional messaging integration is enabled, relevant chat information can be transmitted to that configured provider.
Mesora does not send chat telemetry or analytics to MilMit by default.
Site owners should update their privacy policy and comply with applicable privacy requirements.
Mesora only communicates with external services explicitly configured by the administrator.
| Service | Documentation |
|---|---|
| Telegram Bot API | https://core.telegram.org/bots/api |
| Bale | https://docs.bale.ai/ |
| Eitaa / EitaaYar | https://eitaayar.ir/ |
| WhatsApp Business Platform | https://developers.facebook.com/docs/whatsapp/ |
| Relay | Self-hosted |
Never commit real credentials to the repository.
Do not publish:
bot tokens
access tokens
webhook secrets
generated Relay config.php
.env files
phone number IDs
private chat IDs
For security reports, use GitHub private vulnerability reporting when available or contact MilMit through:
- Core WordPress live chat
- WooCommerce context
- Telegram Forum Topics
- Bale integration
- Eitaa integration
- WhatsApp Business integration
- Optional Relay
- Secure media
- Voice messages
- Privacy tools
- More operator analytics
- More customization options
- Additional messaging integrations
Contributions, bug reports and focused pull requests are welcome.
Before opening a pull request:
- Test changes on a clean WordPress installation.
- Run PHP syntax checks.
- Do not commit secrets.
- Keep compatibility with the minimum supported PHP and WordPress versions.
Current public release:
Mesora is licensed under the GPL-2.0-or-later license.