Blog

Connect Hermes Agent to WhatsApp, without the Meta Cloud API

Hermes gives you two ways onto WhatsApp: an unofficial bridge with a ban risk, or Meta's Cloud API with a business account and a webhook. Here is a third that needs neither.

Ben BrookarshUpdated 17 November 20264 min read

Getting Hermes onto WhatsApp is where a lot of setups stop. Hermes offers two routes, and each asks for something most people do not have: a spare phone number, or a Meta business account and a public server. There is a route that needs neither.

Route one: the built-in bridge

The quick route is Hermes' built-in bridge. It pretends to be WhatsApp Web: you run hermes whatsapp, a QR code appears in your terminal, and you scan it from Linked Devices on your phone. No Meta account is involved.

The Hermes docs are frank about the cost. This is not WhatsApp's official API, and they label it with a ban risk. They tell you to use a dedicated phone number, not your own, which means finding a number that is not already on WhatsApp: a Google Voice number, a prepaid SIM, or a VoIP number, some of which WhatsApp blocks. And when WhatsApp updates its web protocol, the bridge can break until you update Hermes and scan again.

Route two: the Meta Cloud API

The stable route is WhatsApp's official Business Cloud API. The docs call it the Meta-supported path, with no ban risk. It is also a project. You need a Meta Business account, an app in Meta's developer dashboard and a dedicated business phone number. Hermes also needs a public HTTPS address so Meta can deliver your messages, which on a home machine means running a tunnel such as Cloudflare Tunnel.

That is the right choice for a company running a WhatsApp bot for customers. For one person who wants to message their own agent, it is a lot of setup for a chat.

You wanted to text your agent. Not to become a WhatsApp developer.

Route three: a number that is already set up

Hermes on Faivelo does the Cloud API part once, for everyone. Faivelo runs one WhatsApp number on Meta's official Cloud API. Your agent is linked to it from the start. You add your phone number to the agent, message the Faivelo number, and your own Hermes answers.

That gives you the stable, official route with none of the work. There is no QR code to rescan, no spare SIM in a drawer and no Meta Business account. Only the phone numbers you add can reach your agent, and long replies arrive in parts like any other WhatsApp message.

What comes with it

The same box links Telegram, Discord and Slack through Faivelo's own apps, so you can talk to one Hermes from all four. It also gets its own email address with Hermes' email gateway already set up, as covered in Hermes Agent email setup.

It runs the Hermes Agent image from Nous Research, unmodified, on a box of its own for $9 a month. You bring your model key and pay the provider directly. If you are still installing Hermes yourself, the fastest way to get started with Hermes Agent covers the first steps.

Found this useful? Share it.

Message your Hermes on WhatsApp today

Your own Hermes, already on WhatsApp through the official API, plus Telegram, Discord, Slack and email. $9 a month, cancel any month.

Set up HermesFree 14-day trial. No card needed.

Keep reading