Whatsapp

WhatsApp communication channel via WhatsApp Web protocol (QR code login). Use when: (1) replying to WhatsApp messages (DM or group), (2) sending proactive messages or media (images, files) to WhatsApp users or groups, (3) managing DM access control (dmPolicy: open/allowlist/owner, dmAllowFrom list), (4) managing group access control (groupPolicy, per-group allowFrom), (5) configuring the bot (admin CLI, access policies), (6) troubleshooting WhatsApp connection or QR code scanning issues. Config at ~/zylos/components/whatsapp/config.json. Service: pm2 zylos-whatsapp.

zylos-ai Updated

File contents

WhatsApp Channel

Sending Messages

Via C4 bridge:

node ~/zylos/.claude/skills/comm-bridge/scripts/c4-send.js "whatsapp" "<jid>|type:p2p|msg:<msgId>" "Hello"

Media:

node ~/zylos/.claude/skills/comm-bridge/scripts/c4-send.js "whatsapp" "<jid>" "[MEDIA:image]/path/to/image.png"

Admin CLI

node ~/zylos/.claude/skills/whatsapp/src/admin.js show
node ~/zylos/.claude/skills/whatsapp/src/admin.js set-dm-policy <open|allowlist|owner>
node ~/zylos/.claude/skills/whatsapp/src/admin.js add-dm-allow <phone>
node ~/zylos/.claude/skills/whatsapp/src/admin.js set-group-policy <disabled|allowlist|open>
node ~/zylos/.claude/skills/whatsapp/src/admin.js add-group <jid> <name>
node ~/zylos/.claude/skills/whatsapp/src/admin.js clear-auth

QR Code Login

  1. Start the service: pm2 start ecosystem.config.cjs
  2. Check logs: pm2 logs zylos-whatsapp
  3. QR code will be printed in the terminal
  4. Open WhatsApp on your phone → Linked Devices → Link a Device → Scan QR

Auth session is persisted in ~/zylos/components/whatsapp/auth_info/. To re-login: node admin.js clear-auth then restart the service.

zylos-ai/zylos-whatsapp/tree/main/ commit ed5e604905

Frequently asked questions

npx skillmds@latest add zylos-ai/whatsapp