1. Connect a number
Use a Kapso number or connect your own WhatsApp.
Connect Hermes Agent to WhatsApp
Give your agent a WhatsApp number through the official WhatsApp API. Connect it in Kapso, install the plugin, and start chatting.
Connect in five minutes
Give Hermes a WhatsApp number with a single API key, and let Kapso handle the connection and webhook setup.
2. Install the plugin
Run the install command and add your Kapso API key.
3. Start chatting
Run setup, restart Hermes, and send your first message.
Kapso handles the WhatsApp setup
Connect your number in Kapso. The plugin takes care of the connection to Hermes.
- One API key connects the plugin to Kapso.
- Setup connects your number, configures the webhook, and generates its secret.
- You’ll need Hermes running and a public HTTPS URL.
Skip the Meta setup
Get a free, pre-verified number with no Meta app to set up.
| Setup task | Hermes Cloud API directly | Hermes with Kapso |
|---|---|---|
| Meta app | Create and configure your Meta app. | No Meta app needed. |
| WhatsApp number | Bring a business number for production. | Get a free, pre-verified Kapso number or use your own. |
| API access | Set up a Meta token, app secret, and number ID. | Add your Kapso API key. |
| Webhooks | Configure in the Meta dashboard. | Created automatically during setup. |
| Hermes hosting | Run Hermes with a public HTTPS URL. | Run Hermes with a public HTTPS URL. |
Compares official Cloud API setup. Hermes also supports a separate QR-code connection.
Talk to your agent on WhatsApp
Your agent is a message away.
Send messages
Chat with Hermes from WhatsApp.
Share images
Send images for your agent to work with.
Send voice notes
Use your configured Hermes transcription provider.
A few things to know
Do I need my own WhatsApp number?
No. Start with a Kapso number or connect your own WhatsApp number.
Explore number options →How is this different from Hermes’ built-in WhatsApp integration?
The Kapso plugin connects Hermes through the official WhatsApp API. Kapso manages the number connection; the plugin setup creates the webhook and generates its secret.
Read about the plugin →Does Kapso host Hermes?
You still run Hermes on your own machine or server. Kapso provides the WhatsApp connection.
See setup requirements →What does setup require?
You’ll need Hermes running, a Kapso API key, a connected number, and a public HTTPS URL. Node.js and npm are needed for the Kapso CLI.
See setup requirements →How much does it cost?
See Kapso pricing for current plans and WhatsApp messaging charges. Your Hermes hosting and model usage are separate.
View pricing →What if my agent doesn’t reply?
Restart Hermes, check gateway status, and confirm your public URL is reachable. The troubleshooting guide covers webhook, number, and voice-note issues.
Troubleshoot setup →Give your Hermes agent a WhatsApp number.
Connect your number. Install the plugin. Start chatting.