پرش به محتوا
مارکت محصولات دیجیتال و خدمات توسعه
خانهپروژه‌هاmesora-wordpress-live-chat
</>
Open Source Project

mesora-wordpress-live-chat

MilMit/mesora-wordpress-live-chat

★ 0Stars
⑂ 0Forks
0Open Issues
0Watchers
PHPزبان اصلی
GPL-2.0License
README

مستندات مخزن

💬 Mesora

Fast Multi‑Channel Live Chat for WordPress

Typing SVG

Version WordPress PHP License MilMit

Mesora is an open-source live chat plugin built for fast, contextual, pre‑sales conversations on WordPress.

Website: https://milmit.net


✨ Why Mesora?

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.

What makes it different

  • ⚡ 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

🚀 Features

FeatureStatus
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

🧩 Architecture

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
Loading

Mesora can communicate with supported services directly or use an optional Relay when the WordPress server has restricted or unreliable connectivity.


🛍️ WooCommerce Context

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.


💬 Telegram Topics

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

🌍 Self‑Hosted Relay

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.


📦 Installation

From ZIP

  1. Download the latest release.
  2. Open WordPress Admin.
  3. Go to Plugins → Add New → Upload Plugin.
  4. Upload the Mesora ZIP.
  5. Activate Mesora.
  6. Open Mesora → Settings.

From GitHub

git clone https://github.com/milmit/mesora-wordpress-live-chat.git

Then copy the plugin directory into:

wp-content/plugins/

⚙️ Requirements

  • 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

🔐 Privacy

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.


🌐 External Services

Mesora only communicates with external services explicitly configured by the administrator.

ServiceDocumentation
Telegram Bot APIhttps://core.telegram.org/bots/api
Balehttps://docs.bale.ai/
Eitaa / EitaaYarhttps://eitaayar.ir/
WhatsApp Business Platformhttps://developers.facebook.com/docs/whatsapp/
RelaySelf-hosted

🛡️ Security

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:

https://milmit.net


🗺️ Roadmap

  • 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

🤝 Contributing

Contributions, bug reports and focused pull requests are welcome.

Before opening a pull request:

  1. Test changes on a clean WordPress installation.
  2. Run PHP syntax checks.
  3. Do not commit secrets.
  4. Keep compatibility with the minimum supported PHP and WordPress versions.

📌 Release

Current public release:

v1.0.0

GitHub Release


📄 License

Mesora is licensed under the GPL-2.0-or-later license.


Built by MilMit

MilMit

Mesora — Fast conversations. Better pre‑sales support.

RELEASE

آخرین نسخه

v1.0.0شهریور 17, 1405
مشاهده Release ↗