The WhatsApp Manager is a standalone microservice plugin built directly on the WhatsApp Web protocol.
The WhatsApp Manager is a standalone microservice plugin built directly on the WhatsApp Web protocol (whatsmeow library). It bypasses expensive third-party APIs (like Twilio or Meta Business API), allowing the CMS to communicate directly through your personal or business mobile device.
**Direct Device Pairing: Uses dynamic QR code generation in the CMS dashboard to pair securely with your WhatsApp app via the “Linked Devices” feature.
Two-Way Persistent Inbox: Stores all incoming and outgoing messages in an isolated SQLite database (wa_inbox), keeping a complete conversation history separate from the main CMS data.
Live Chat Modal: Injects a global, iOS-style chat window into the bottom-right corner of the administrative panel. It uses live background polling to fetch new messages seamlessly while you work.
User Profile Integration: Automatically injects “Send WhatsApp Message” action buttons onto user profiles in the /admin/users directory, resolving their phone numbers dynamically.
LID Privacy Resolution: Automatically intercepts anonymous Local Identifiers (@lid) sent by WhatsApp’s modern privacy routing, de-anonymizing them back into the sender’s real phone number so chat history links correctly.
Internal REST API: Exposes endpoints (like /api/plugin/whatsapp_manager/send) that other plugins can securely hit to dispatch messages.
Anti-Ban Human Emulation Engine To prevent WhatsApp from flagging the connected number as an automated bot, the plugin runs several stealth protocols:
Presence Broadcasting: Signals an Available (Online) status when connected.
Keystroke Simulation: Triggers a “typing…” indicator on the recipient’s phone and calculates a realistic typing delay (with randomized jitter) based on the exact character count of your message before hitting send.
Read Receipts: Intercepts incoming replies and automatically fires back a “Message Read” packet to give the sender double blue ticks.