Skip to content
Hermes documentation

Connect apps

WhatsApp

Follow the common setup steps, then as hermes:

hermes whatsapp
  1. Choose bot for a dedicated number, or self-chat for a trial.
  2. On the phone, open Settings → Linked Devices → Link a Device.
  3. Scan the terminal QR code.
  4. Check the existing $HERMES_HOME/.env:
WHATSAPP_ENABLED=true
WHATSAPP_MODE=bot
WHATSAPP_ALLOWED_USERS=15551234567
WHATSAPP_GROUP_POLICY=disabled

Use your sender’s country code and digits without +. For self-chat, set WHATSAPP_MODE=self-chat and message yourself. Restart and test using the common steps.

The Baileys Linked Device bridge is unofficial and can break or incur account restrictions. A dedicated number limits the impact. The Business Cloud API is a separate setup requiring Meta credentials and a public webhook.

WhatsApp reference