deploy-hermes-agent-on-whatsapp

title: "Hermes Agent auf WhatsApp bereitstellen: So geht's" description: "Eine Schritt-für-Schritt-Anleitung, um Hermes Agent auf WhatsApp zu betreiben: die Einrichtung der Business Cloud API, die tatsächlichen Kosten und Limits und wann Telegram der vernünftigere Weg ist." date: 2026-05-27 author: "Hermify Team" tags: ["Hermes", "WhatsApp", "Deployment", "AI Agents"] coverImage: "cover.jpg" socialImage: "og.jpg" coverAlt: "Dunkle Szene mit dem grünen WhatsApp-Sprechblasen-Logo, das mit einem leuchtenden Server-Knoten verbunden ist, mit dem fett gedruckten Text „Hermes on WhatsApp""

WhatsApp ist die Messaging-App, die zwei Milliarden Menschen jeden Tag öffnen, also fühlt es sich wie der naheliegende Ort an, um Ihren KI-Agenten unterzubringen. Dann beginnen Sie mit der Einrichtung und stellen fest, dass es der mit Abstand schwierigste Kanal ist, um einen persönlichen Agenten bereitzustellen, und Meta hat 2026 damit verbracht, es noch schwieriger zu machen.

Diese Anleitung führt durch das, was es tatsächlich braucht, um Hermes Agent auf WhatsApp zum Sprechen zu bringen: die Zugangsdaten und den Webhook, die Sie benötigen, die Kosten und Limits, die viele überraschen, und die ehrliche Antwort darauf, ob Sie es überhaupt tun sollten.

Bevor Sie beginnen: WhatsApp ist nicht Telegram

Wenn Sie Hermes Agent auf Telegram bereitstellen: So geht's gelesen haben, vergessen Sie den Fünf-Minuten-Zeitplan. WhatsApp bietet Ihnen zwei Wege hinein, und beide haben einen Haken:

Die offizielle WhatsApp Business Cloud API (betrieben von Meta). Dies ist der unterstützte, dauerhafte Weg. Er erfordert ein Meta Business-Konto, eine Geschäftsverifizierung, eine dedizierte Telefonnummer, einen öffentlichen Webhook und eine Abrechnung pro Nachricht.
Inoffizielle Bibliotheken (WAHA, Baileys und ähnliche), die WhatsApp Web automatisieren. Kostenlos und schnell, aber sie verstoßen gegen die Nutzungsbedingungen von WhatsApp und bergen ein reales Risiko einer dauerhaften Sperre der Nummer, dazu unten mehr.

Für eine Bereitstellung, auf die Sie sich verlassen können, brauchen Sie die offizielle Cloud API. Alles im Abschnitt zur Einrichtung setzt diesen Weg voraus.

Was Sie benötigen, um Hermes auf WhatsApp bereitzustellen

Eine funktionierende Bereitstellung umfasst vier Zugangsdaten und ein Stück Infrastruktur. Sammeln Sie alle davon, bevor Sie die Hermes-Konfiguration anfassen.

1. Ein Meta Business-Konto und eine Cloud-API-App

Melden Sie sich bei Meta for Developers an, erstellen Sie eine Business-App und fügen Sie ihr das WhatsApp-Produkt hinzu. Meta stellt Ihnen sofort eine Sandbox-Testnummer zur Verfügung, sodass Sie experimentieren können, bevor Sie ein echtes Unternehmen verifizieren.

2. Eine Phone Number ID und eine WhatsApp Business Account ID

Registrieren Sie innerhalb der WhatsApp-Einrichtung der App die geschäftliche Telefonnummer, über die die Nachrichten laufen werden. Meta zeigt Ihnen dann zwei Werte, die Sie speichern müssen: die Phone Number ID und die WhatsApp Business Account (WABA) ID. Diese identifizieren, über welche Nummer und welches Konto Hermes sendet, sie sind nicht die Telefonnummer selbst.

3. Ein dauerhaftes Zugriffstoken

Das temporäre Token, das Meta auf dem Einrichtungsbildschirm anzeigt, läuft nach 24 Stunden ab, was für einen ersten Test in Ordnung und für eine Bereitstellung nutzlos ist. Für etwas Echtes erstellen Sie einen System User in den Business Settings, weisen Sie ihm Ihre App und Ihr WhatsApp-Konto mit voller Kontrolle zu und generieren Sie ein dauerhaftes Token. Dies ist das Zugangsdatum, mit dem Hermes jeden Versand authentifiziert.

4. Ein öffentlicher Webhook-Endpunkt

Dies ist der Teil, den Telegram nicht benötigt. WhatsApp sendet eingehende Nachrichten an eine URL, die Sie hosten, daher benötigt Hermes einen öffentlichen HTTPS-Endpunkt mit einem gültigen Zertifikat. Sie registrieren die URL plus ein Verify-Token Ihrer Wahl im Meta Business Manager, und Meta führt einen einmaligen Handshake durch, indem es Ihren Endpunkt mit einem hub.challenge-Wert aufruft, den Sie zurücksenden müssen. Sobald verifiziert, wird jede eingehende Nachricht als Webhook zugestellt, den Ihr Gateway innerhalb von 30 Sekunden mit HTTP 200 beantworten muss.

WhatsApp in Hermes einbinden

Mit den vier Bausteinen in der Hand sieht die Hermes-Seite vertraut aus, wenn Sie das Telegram-Gateway konfiguriert haben. Fügen Sie in der config.yaml Ihren Anbieter und die WhatsApp-Zugangsdaten hinzu:

provider: openrouter
model: anthropic/claude-3-5-sonnet
openrouter_api_key: sk-or-your-key-here

whatsapp_phone_number_id: "123456789012345"
whatsapp_business_account_id: "987654321098765"
whatsapp_access_token: EAAG...your-permanent-token
whatsapp_verify_token: a-long-random-string-you-choose
whatsapp_allowed_users: "15551234567"

Zwei Felder verdienen Aufmerksamkeit. Das whatsapp_verify_token muss exakt mit dem Wert übereinstimmen, den Sie beim Registrieren des Webhooks in den Meta Business Manager eingegeben haben, andernfalls schlägt der Handshake stillschweigend fehl. Das Feld whatsapp_allowed_users ist Ihre Sicherheitssperre: Hermes antwortet nur den hier aufgeführten Nummern (im vollständigen internationalen Format, ohne +), sodass eine fremde Person, die Ihre Geschäftsnummer anschreibt, nicht Ihr Modell-Guthaben verbrennen kann.

Das Gateway starten

Bringen Sie das Messaging-Gateway auf dieselbe Weise hoch, wie Sie es für jeden Kanal tun würden:

hermes gateway start --detach

Das Gateway stellt die Webhook-Route bereit, validiert Metas Signatur bei jeder Anfrage, leitet den Nachrichtentext in die Hermes-Laufzeitumgebung und sendet die Antwort des Agenten über die Cloud API zurück. Bestätigen Sie mit hermes gateway status, dass es läuft, und senden Sie eine Testnachricht von einer erlaubten Nummer.

Die Kosten und Limits, die niemand erwähnt

Hier weicht WhatsApp stark von einer kostenlosen Bot-Plattform ab, und hier zerfallen viele Bereitstellungen still und leise.

WhatsApp ist Mitte 2025 zur Abrechnung pro Nachricht übergegangen. Jede Nachricht, die Ihr Agent initiiert, wird nach Kategorie und Empfängerland abgerechnet, etwa $0,004 bis $0,046 für Utility-Nachrichten und bis zu etwa $0,14 für Marketing-Nachrichten in Ländern mit höheren Kosten. Die offizielle API selbst liegt in einem Bereich von $0-99/Monat vor diesen Gebühren pro Nachricht, und die meisten Teams fügen obendrein einen Aufschlag eines Business Solution Providers hinzu.

Noch schlimmer speziell für einen Agenten ist das 24-Stunden-Kundenservice-Fenster. Nachdem ein Nutzer Ihnen schreibt, können Sie 24 Stunden lang frei antworten. Sobald dieses Fenster geschlossen ist, können Sie keine frei formulierte Nachricht mehr senden, nur eine vorab genehmigte Vorlage, und jeder Vorlagenversand wird abgerechnet. Ein persönlicher Agent ist von Natur aus proaktiv: Er meldet sich bei Ihnen mit einem morgendlichen Standup, teilt Ihnen mit, dass eine lange Aufgabe abgeschlossen ist, erinnert Sie drei Tage später an eine Rechnung. Jede dieser Nachrichten landet außerhalb des Fensters, sodass sie auf WhatsApp zu einem kostenpflichtigen Vorlagenversand wird. Wir schlüsseln das vollständig in Telegram vs. WhatsApp für einen KI-Agenten auf.

Die inoffizielle Abkürzung (und warum sie nach hinten losgeht)

Suchen Sie nach „free WhatsApp bot" und Sie finden WAHA, Baileys und ein Dutzend Wrapper um WhatsApp Web. Sie sind tatsächlich schnell aufgesetzt und kosten nichts an Nachrichtengebühren. Sie sind auch eine Falle für jede Bereitstellung, die Ihnen am Herzen liegt.

Diese Bibliotheken sind durch Reverse Engineering entstanden und verstoßen gegen die Nutzungsbedingungen von WhatsApp. Meta betreibt ein mehrschichtiges Erkennungssystem, Registrierungs-Fingerprinting, Verhaltensanalyse, Nutzermeldungen, Inhaltsmuster, und hat die Durchsetzung gegen Drittanbieter-KI-Chatbots bis Anfang 2026 verschärft. Das realistische Ergebnis des Betriebs eines selbst gehosteten inoffiziellen Gateways bei nennenswertem Volumen ist eine dauerhafte Sperre der Nummer, die Sie verwendet haben. Für einen Wegwerftest mit einer Ersatz-SIM in Ordnung. Für die Nummer, über die Ihre Kontakte Sie tatsächlich erreichen, ist es das nicht wert.

Häufige Fehlerursachen

Der Webhook verifiziert nie. Das Verify-Token in der config.yaml stimmt nicht mit dem im Meta Business Manager überein, oder Ihr Endpunkt ist nicht über HTTPS mit einem gültigen Zertifikat erreichbar. Meta muss hub.challenge erfolgreich zurücksenden, bevor es eine einzige Nachricht sendet.

Nachrichten kommen an, aber Hermes antwortet nie. Entweder läuft das Gateway nicht (hermes gateway status) oder der Absender steht nicht in whatsapp_allowed_users. Prüfen Sie, ob die Nummer im vollständigen internationalen Format ohne + vorliegt.

Das Token funktioniert einen Tag lang, dann hört alles auf. Sie haben mit dem temporären 24-Stunden-Token statt mit einem dauerhaften System-User-Token bereitgestellt. Generieren Sie das dauerhafte neu und aktualisieren Sie Ihre Konfiguration.

Proaktive Nachrichten schlagen stillschweigend fehl. Sie versuchen, außerhalb des 24-Stunden-Fensters ohne genehmigte Vorlage zu senden. Dies ist eine Plattformregel, kein Fehler, es ist der Kerngrund, warum Agenten auf WhatsApp Schwierigkeiten haben. Die diagnostische Denkweise aus dem Telegram-Troubleshooting-Leitfaden lässt sich auf jedes Gateway übertragen, das Sie betreiben.

Den Betrieb aufrechterhalten

Selbst nachdem der Bot antwortet, tragen Sie eine fortlaufende Verantwortung, die auf einfacheren Kanälen nicht existiert: einen öffentlichen HTTPS-Endpunkt, der online und zertifikatsgültig bleiben muss, ein dauerhaftes Token, das nicht durchsickern darf, Vorlagengenehmigungen zu verwalten und eine Abrechnung pro Nachricht im Auge zu behalten. Das Gateway funktioniert, solange der Prozess und der Endpunkt gesund sind, und verstummt in dem Moment, in dem eines von beiden ausfällt. Auf einem Laptop oder einem recycelten Container passiert das häufiger, als Ihnen lieb ist.

Telegram ist das bessere Zuhause für einen persönlichen Agenten

Treten Sie von den Mechaniken der Einrichtung zurück, und das Urteil ist schwer zu bestreiten: Für einen persönlichen KI-Agenten gewinnt Telegram auf jeder Achse, die zählt.

Offen und kostenlos. Telegrams Bot API ist öffentlich, dokumentiert und kostet nichts pro Nachricht. WhatsApps Cloud API ist hinter einer Meta-Business-Verifizierung verschlossen und rechnet pro Konversation ab.
Standardmäßig proaktiv. Ihr Agent kann Ihnen in dem Moment schreiben, in dem eine Aufgabe abgeschlossen ist, jeden Morgen oder drei Tage später wegen einer Rechnung, kein 24-Stunden-Fenster, keine vorab genehmigten Vorlagen, keine Gebühr pro Nachricht.
In Minuten statt Wochen live. Keine Geschäftsverifizierung, keine dedizierte Nummer, kein öffentlicher Webhook mit einem gültigen Zertifikat, das am Leben gehalten werden muss.
Kein Sperrrisiko. Sie sind auf einer unterstützten, erstklassigen API, nicht auf einer durch Reverse Engineering entstandenen Bibliothek, die nur einen Erkennungsdurchlauf davon entfernt ist, Ihre Nummer zu verlieren.

WhatsApp kann zum Laufen gebracht werden, wenn Sie diesen spezifischen Kanal wirklich benötigen und die Kosten sowie den betrieblichen Mehraufwand akzeptieren. Für alle anderen ist Telegram schlichtweg der vernünftigere Standard.

Überspringen Sie die Einrichtung: Betreiben Sie Ihren Agenten auf Telegram mit Hermify

Hermify ist ein verwalteter Hermes Agent-Host und integriert sich nativ mit Telegram, dem Kanal, der genau für diese Art von dauerhaft verfügbarem persönlichem Agenten gebaut wurde. Sie bringen einen Modell-Schlüssel mit, die Laufzeitumgebung wird auf verwalteter Infrastruktur bereitgestellt, und Sie schreiben Ihrem Agenten wie jedem anderen Kontakt. Kein Server, den man babysitten muss, kein Webhook, den man am Leben halten muss, keine Abrechnung pro Nachricht.

Das verschafft Ihnen einen dauerhaften Agenten, der sich an Sie erinnert, geplante Skills ausführt und in Ihrer Hosentasche lebt, einsatzbereit in dem Moment, in dem Sie die Anmeldung abschließen, nicht erst nach einer Meta-Verifizierungswarteschlange.

Legen Sie mit Hermify los und Ihr Agent ist in Minuten auf Telegram live.