Blog / channel guide
How to Deploy Hermes Agent on WhatsApp
To deploy Hermes Agent on WhatsApp, choose a model and WhatsApp in the deployment flow, launch the managed runtime, start WhatsApp login, and scan the generated QR code from Linked Devices on your phone. Keep the browser open until the connection is confirmed.
- 01
Choose WhatsApp and a model
Select the model Hermes Agent should use, choose WhatsApp as the first channel, and sign in to the deployment flow.
- 02
Deploy Hermes Agent
Start the managed runtime and wait for deployment to reach the stage where WhatsApp login is available.
- 03
Start QR login
Open the WhatsApp connection panel and generate a fresh QR code for this deployment.
- 04
Scan and verify
On your phone, open WhatsApp Linked Devices, scan the code, and wait until the web flow confirms the connected state.
Four-step path
How do you connect Hermes Agent to WhatsApp?
WhatsApp is connected after the Hermes Agent runtime exists, because the QR session belongs to that running deployment.
- Step 01
Choose WhatsApp and a model
Select the model Hermes Agent should use, choose WhatsApp as the first channel, and sign in to the deployment flow.
- Step 02
Deploy Hermes Agent
Start the managed runtime and wait for deployment to reach the stage where WhatsApp login is available.
- Step 03
Start QR login
Open the WhatsApp connection panel and generate a fresh QR code for this deployment.
- Step 04
Scan and verify
On your phone, open WhatsApp Linked Devices, scan the code, and wait until the web flow confirms the connected state.
What do you need before connecting WhatsApp?
You need an active WhatsApp account on a phone, an authenticated Hermes Agent account, and a deployment plan. Unlike Telegram and Discord, the current WhatsApp flow does not ask you to paste a bot token.
Use a WhatsApp account appropriate for the workflow and review which conversations it can access. Start with a controlled test conversation before relying on the connection for customer or team communication.
How does the WhatsApp QR connection work?
The managed runtime starts a temporary login session and displays a QR code. Scanning it from WhatsApp Linked Devices authorizes that runtime as a connected device.
QR codes expire, so scan the newest code shown in the deployment panel. Wait for the interface to report a connected state rather than assuming the scan completed successfully.
Why is the WhatsApp QR code not working?
The usual causes are an expired QR code, a canceled login session, an interrupted deployment, or scanning from the wrong WhatsApp account. Refresh the session and scan the newest code.
- Confirm the Hermes Agent deployment is still running.
- Generate a fresh QR code if the current one has been visible for too long.
- Use WhatsApp Settings and Linked Devices on the intended phone account.
- Keep the connection panel open until the status changes to connected.
What should you do if WhatsApp disconnects?
Open the deployment connection panel, check the current session state, and start a new QR login if the linked-device authorization is no longer valid.
A disconnected channel does not always mean the Hermes Agent runtime stopped. Treat runtime health and WhatsApp authorization as two separate checkpoints when troubleshooting.
How should you secure a WhatsApp-connected agent?
Use a dedicated or controlled WhatsApp account, review Linked Devices regularly, test with limited conversations, and remove the linked session immediately when access is no longer required.
An AI agent connected to messaging should receive only the access needed for its job. Do not expose confidential conversations simply because a broader account is convenient during setup.
Which primary sources support this page?
Product behavior is checked against the current deployment flow. These external links provide the upstream project or channel documentation used for setup details.
Direct answers
Frequently asked questions
Does WhatsApp setup require a bot token?
No. The current managed flow connects through a QR-based linked-device session after the Hermes Agent runtime is deployed.
Why did the QR code expire?
WhatsApp login QR codes are temporary. Generate a new code in the connection panel and scan the newest version.
Can I remove Hermes Agent from Linked Devices?
Yes. Remove the linked session from WhatsApp on your phone when you no longer want that deployment connected.
Does my browser need to stay open after connection?
No. After the managed runtime is connected, the deployment runs independently of the browser used for setup.
Key takeaways
- To deploy Hermes Agent on WhatsApp, choose a model and WhatsApp in the deployment flow, launch the managed runtime, start WhatsApp login, and scan the generated QR code from Linked Devices on your phone. Keep the browser open until the connection is confirmed.
- Start with one model, one channel, and one controlled test conversation.
- Use managed hosting when deployment speed matters more than operating the server yourself.
Continue the setup
Related Hermes Agent guides
Use case
Managed Hermes Agent Hosting Without the Server Work
Deploy Hermes Agent on managed infrastructure in about 60 seconds. Choose a model, connect Telegram, Discord, or WhatsApp, and skip server setup.
Read nextBlog guide
How to Deploy Hermes Agent on Telegram
Deploy Hermes Agent on Telegram with a guided BotFather token setup, model selection, managed runtime, deployment checks, and practical troubleshooting.
Read nextBlog guide
How to Deploy Hermes Agent on Discord
Deploy Hermes Agent on Discord with a guided bot-token and intent setup, managed runtime, invitation checks, model selection, and troubleshooting steps.
Read next