How-To Series · Episode 27 / 59 · Module 5: Everywhere You Are

Hermes · On WhatsApp

Pair a number, scan a QR, chat. No Meta account required.

After this videoYou can now use Hermes in WhatsApp DMs (dedicated number recommended).

WhatsApp has no bot API outside its Business product, so Hermes uses a bridge called Baileys that emulates WhatsApp Web. It works, but it is unofficial, so there is a small risk of account limits: use a dedicated number, keep it conversational, and avoid outbound blasting. Two modes: bot (a separate number people message directly, recommended) and self-chat (message yourself, for testing). Setup is one wizard, hermes whatsapp, which installs the bridge and prints a QR code in your terminal; scan it from WhatsApp under Settings, Linked Devices, Link a Device. For a second number, use Google Voice (free, US), a prepaid SIM, or an internet calling app. Set WHATSAPP_ALLOWED_USERS (country code, no +) or *, or the gateway denies everything. The session lives at ~/.hermes/platforms/whatsapp/session, survives restarts, and grants full account access, so protect it. If a WhatsApp update breaks the bridge, update Hermes and re-pair.

About these resources. Every command in this video comes from the WhatsApp messaging doc.

Sources · What this video distills

1 docs page · every command below traces to one of them
Primary · Baileys bridge, ban-risk caveat, bot/self-chat modes, QR wizard, second-number options, access control, session persistence, re-pairing
WhatsApp Setup
Read ↗

Commands shown · Copy and paste

each shows the source doc it came from
Pair (QR wizard)from source ↗
hermes whatsapp
hermes gateway # or: hermes gateway install
Access control (~/.hermes/.env)from source ↗
WHATSAPP_ALLOWED_USERS=15551234567 # country code, no + · or =* for everyone
Stay silent to strangers (config.yaml)from source ↗
unauthorized_dm_behavior: ignore # under whatsapp:

Going deeper · Related Hermes docs

further reading · not sources of facts shown above

Next in the series · Episodes that build on this

E25
Hermes on Discord
E26
Hermes on Slack
E28
Hermes on Signal