Desktop "Local" mode crashed with ERR_MODULE_NOT_FOUND because electron-builder's pnpm collector drops `deduped` subtrees, so engine's transitive closure (@modelcontextprotocol/sdk, pi-ai provider SDKs, etc.) was never packed. Stage the complete flat prod closure with `pnpm deploy --legacy --config.node-linker=hoisted` and package it via `electron-builder --projectDir deploy`, bypassing the lossy collector entirely. Also make the dashboard-imported example plugins loadable under plain Node (the Electron main runtime): cursor/droid/roadmap now expose compiled `dist` on the `import` condition (keeping `source`→src for the bun CLI) and are built during the desktop build. Add `source` conditions to paperclip/agent-browser/even-cards/ even-realities-glasses/whatsapp-chat so the bun `--conditions=source` Windows CLI compile resolves them from source. Validated on macOS: @fusion/core|engine|dashboard import cleanly from the staged deploy; packing yields a complete 705-package asar; bun-windows-x64 cross-compiles with all plugin dist removed. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
WhatsApp Chat Plugin
WhatsApp Web (Baileys) bridge for Fusion. It pairs with your phone (QR or pairing code), keeps a background connection alive, forwards inbound direct text messages to a Fusion AI session, and sends the assistant reply back to WhatsApp.
No Meta Cloud app, webhook URL, verify token, or Graph API credentials are required.
Setup
- Enable/install the plugin in Plugin Manager.
- Configure
allowedSenders(empty means nobody is allowed). - Choose
pairingMode:qr(default): fetch QR from/api/plugins/fusion-plugin-whatsapp-chat/qrand scan in WhatsApp.code: setpairingPhoneNumber(E.164 digits without+) and request code via/pair-code.
- Confirm
/statusreportsconnected.
Settings
pairingMode:qrorcode.pairingPhoneNumber: E.164 digits without+(used forcodemode).allowedSenders: allowed WhatsApp JIDs or E.164 digits.agentSystemPrompt: system prompt for replies.historyTurnLimit: persisted turn window (default40).dedupeRetentionDays: replay-protection retention window for inbound message IDs (default7days). Rows older than this are pruned lazily whenever a new inbound message is processed.
Routes
GET /api/plugins/fusion-plugin-whatsapp-chat/statusGET /api/plugins/fusion-plugin-whatsapp-chat/qrPOST /api/plugins/fusion-plugin-whatsapp-chat/pair-codePOST /api/plugins/fusion-plugin-whatsapp-chat/logout
Storage and lifecycle
- Starts socket on
onLoad, stops ononUnload. - Persists transcript and dedupe state in:
whatsapp_chat_sessionswhatsapp_chat_dedupe
- Persists Baileys auth state in:
whatsapp_auth_credswhatsapp_auth_keys
- After restart, plugin reconnects automatically when auth is valid.
Troubleshooting
- Stuck
awaiting-qr: fetch a fresh QR and scan promptly. loggedOut: call/logout(or wait for clear) and re-pair.- Pair code not generated: ensure
pairingPhoneNumberis E.164 digits without+. - No replies: check
allowedSenders; empty list blocks all inbound messages by design.
Compliance warning
Baileys is an unofficial WhatsApp Web protocol client. Use may violate WhatsApp Terms of Service. This plugin is intended for self-hosted, single-user use at your own risk.