AnmeldenKostenlose Testphase starten
Meta Tech Provider

WhatsApp API für KI-Agenten: offizieller Zugang in Minuten, ohne Tech Provider zu werden

Ein KI-Agent erhält offiziellen WhatsApp-Zugang über die Cloud API von Meta. Eine Nummer, die in der WhatsApp Business App bleibt, wird über einen Tech Provider oder Solution Partner angebunden. Sie können selbst einer werden, mit Business-Verifizierung, App-Review-Videos und einem Embedded-Signup-Build, oder Sie verbinden sich über einen Anbieter, der bereits einer ist: Die Nummer ist in wenigen Minuten angebunden, und der Agent erhält MCP-Tools oder API-Zugangsdaten.

easyCoexistence ist ein unabhängiger Meta Tech Provider: Es verbindet eine WhatsApp-Business-Nummer in wenigen Minuten über Coexistence mit der Cloud API, sodass Ihr Agent offiziellen Zugang erhält, während das Unternehmen die App behält.

Tech Provider

Was Meta von jedem verlangt, der eine Nummer anbindet, die in der WhatsApp Business App bleibt: Status als Tech Provider oder Solution Partner.

2 videos

App Review verlangt ein Video einer Nachricht, die aus Ihrer App gesendet wird, und eines, in dem Ihre App ein Template erstellt.

Advanced access

Was App Review für whatsapp_business_messaging und whatsapp_business_management gewährt, beide erforderlich, um Tech Provider zu werden.

October 15, 2026

Als Meta Embedded Signup v2 und v3 abkündigte und Integrationen aufforderte, auf v4 umzustellen.

20 msg/s

Feste Durchsatzrate einer Nummer, die gleichzeitig mit der WhatsApp Business App und der Cloud API genutzt wird.

1 hour

Wie lange ein gehosteter Verbindungslink gültig bleibt, wenn eine Plattform über die Partner API die Nummer eines Kunden anbindet.

Was braucht ein KI-Agent, um WhatsApp offiziell zu nutzen?

Vier Dinge aus Metas Cloud API. Eine Phone Number ID und ein Access-Token mit der Berechtigung whatsapp_business_messaging, damit der Agent den messages-Endpoint aufrufen kann. Einen Webhook-Endpoint, an den Meta eingehende Nachrichten zustellt, dazu bei einer mit der App geteilten Nummer smb_message_echoes für die Antworten, die eine Person am Telefon tippt. Genehmigte Templates, denn eine getippte Nachricht erreicht nur jemanden, der in den letzten 24 Stunden geschrieben hat. Und eine Möglichkeit zu erkennen, wann die Verbindung abbricht, denn die App auf dem Telefon funktioniert weiter, wenn die API-Seite ausfällt.

Die Abkürzung, die Leute zuerst finden, ist die Automatisierung von WhatsApp Web, die sich als verknüpftes Gerät anmeldet. Das verstößt gegen die Nutzungsbedingungen von WhatsApp und setzt die Nummer dem Risiko einer Sperre aus, ganz gleich, was der Agent darauf macht.

Was umfasst der Tech-Provider-Weg?

Metas eigener Ablauf in dieser Reihenfolge. Jeder Schritt ist kostenlos, und keiner lässt sich beschleunigen: Die Prüfungen laufen nach Metas Zeitplan, und Meta veröffentlicht keinen Zeitrahmen. Planen Sie deshalb Wochen statt Tage, bevor sich die Nummer des ersten Kunden verbinden kann. Danach muss das Backend weiterlaufen: der Token-Austausch nach jeder Anmeldung, ein Webhook-Empfänger, das Routing pro Nummer und die Überwachung auf Trennungen, etwa Metas Regel der 14 Tage Inaktivität.

1Business verificationName, address, phone, email and website checked by Meta
2Meta appThe WhatsApp use case and a connected business portfolio
3App ReviewTwo videos, then advanced access to both WhatsApp permissions
4Embedded SignupVersion 4 or later, with WhatsApp Business app onboarding
5Your backendToken exchange, webhooks, routing and monitoring

Was ist der kürzere Weg?

Verbinden Sie die Nummer über einen Anbieter, der diesen Prozess bereits durchlaufen hat. Mit easyCoexistence startet das Unternehmen Metas Embedded Signup und scannt einen Code mit der WhatsApp Business App, was etwa zwei Minuten dauert. Die Nummer tritt der Cloud API im eigenen Business Portfolio des Unternehmens bei, während die App weiter funktioniert. Der Agent erhält dann Zugriff in der Form, die er spricht: MCP-Tools für einen Assistenten wie ChatGPT, Claude, Claude Code oder Codex oder die Zugangsdaten und Webhooks der Nummer für Code, den Sie selbst betreiben.

Connect through easyCoexistenceBecome a Tech Provider
Meta app and App ReviewNot needed: the number joins through oursYours to build and pass
Embedded SignupHosted, with the QR scan in the appYou integrate version 4 and host the flow
First number connectedMinutes after signing upAfter verification and review
Webhook trustA secret in your URL, or X-EC-Signature on forwarded messagesYour app secret signs Meta's deliveries
Disconnection alertsEvery number watched 24/7, 14-day rule includedMonitoring you build and run
Who owns the WhatsApp Business AccountThe business, in its own portfolioThe business

Wie erhält der Agent die Zugangsdaten der Nummer?

Über get_api_credentials oder über die Seite der Nummer im Dashboard. Das Tool gibt die Basis-URL der Graph API, die WhatsApp Business Account ID, die Phone Number ID, den Send-Endpoint und, sofern vorhanden, das eigene Token des Unternehmens zurück, begrenzt auf seine WhatsApp-Assets. Wurde kein Client-Token ausgestellt, kommt das Token als null zurück, mit dem Hinweis, dass ein erneutes Verbinden der Nummer im Dashboard eines ausstellt, ohne ein funktionierendes Token zu ersetzen. Es gibt kein App Secret zum Abrufen, denn Meta signiert Webhooks mit dem App Secret von easyCoexistence, das nie weitergegeben wird. Das Tool benötigt einen aktiven Tarif, da das Token senden kann.

Send a reply with the returned credentials
curl -X POST "$SEND_ENDPOINT" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "messaging_product": "whatsapp",
    "to": "5511999998888",
    "type": "text",
    "text": { "body": "Your order #1042 is ready for pickup." }
  }'

Wie gelangen eingehende Nachrichten zum Agenten?

Jede Nummer hat zwei Modi, umgeschaltet mit set_inbound_mode oder auf der Seite der Nummer. Direkt an Ihren Server: set_webhook_destination richtet Meta direkt auf Ihren HTTPS-Endpoint, der Metas GET-Handshake beantworten muss. easyCoexistence sieht die Nachrichten dabei nie, daher sind Automatisierungen aus. Da Meta diese Zustellungen mit unserem App Secret signiert, legen Sie ein langes, zufälliges Geheimnis in den URL-Pfad und weisen Sie Anfragen ohne dieses ab.

Automatisierungen an: Meta stellt an easyCoexistence zu, Automatisierungen können antworten, und eine optionale Forward URL erhält Metas ursprüngliche Payload unter "value", signiert mit X-EC-Signature: t=<unix>,v1=<HMAC-SHA256 von "<t>.<body>"> mit einem Secret, das einmalig angezeigt wird. Der Schritt Call my webhook einer Automatisierung übergibt außerdem die Nachricht und die letzten 10 Nachrichten des Chats an Ihren Agenten und sendet dessen Antwort, sofern Ihre Antwort {"reply": "..."} innerhalb von 20 Sekunden lautet.

Welche Limits muss der Agent beachten?

Die von Meta, und sie gelten über jeden Anbieter gleich. Ein Agent, der sie im Voraus kennt, vermeidet Fehler, die wie Bugs aussehen:

  • 20 Nachrichten pro Sekunde und Nummer, von Meta festgelegt für Nummern, die mit der WhatsApp Business App geteilt werden.
  • Getippte Nachrichten nur innerhalb von 24 Stunden nach der letzten Nachricht des Kunden; danach ein genehmigtes Template.
  • Templates werden nur über die API versendet, weil die App auf einer Coexistence-Nummer keine senden kann.
  • Antworten, die eine Person in der App tippt, kommen als smb_message_echoes an; pausieren Sie den Agenten für diesen Chat, sonst erhält der Kunde zwei Antworten.
  • Gruppenchats werden nicht mit der API synchronisiert, daher arbeitet der Agent in Einzelchats.
  • Kontakte und bis zu 6 Monate Einzelchats werden einmalig importiert, nur wenn ein direktes Webhook-Ziel innerhalb von 24 Stunden nach der Verbindung gespeichert wird; eine Nummer mit eingeschalteten Automatisierungen erhält den Import nicht.
  • Sprach- und Videoanrufe funktionieren in der App weiter, aber die Cloud API überträgt bei einer Coexistence-Nummer keine Anrufe, daher arbeitet der Agent mit Text.

Kann eine Plattform die Nummern ihrer eigenen Kunden so anbinden?

Ja, über die Partner API. So binden eine SaaS oder eine Agentur ihre Kunden an, ohne eigenen Tech-Provider-Status. Erstellen Sie den API-Schlüssel mit create_api_key (er beginnt mit ec_live_ und wird einmal angezeigt) und rufen Sie dann POST /api/v1/connect-sessions aus Ihrem Backend auf oder create_connect_link aus dem Assistenten, für einen gehosteten Link, der 1 Stunde gültig ist. Der Kunde durchläuft dort Metas Popup und den QR-Scan und kehrt mit einer connection_id zu Ihrer redirect_url zurück. GET /api/v1/connections/:id?credentials=1 liefert dann das eigene Token des Kunden, und Statusereignisse wie connection.disconnected kommen signiert mit X-EC-Signature an. Jede Nummer wird über Ihr Konto zu denselben Stufen pro Nummer abgerechnet.

Häufige Fehler

  • X-Hub-Signature-256 bei einem direkten Ziel prüfen. Meta signiert mit dem App Secret von easyCoexistence, das nie weitergegeben wird, daher schlagen echte Zustellungen die Prüfung fehl. Vertrauen Sie einem langen, zufälligen Geheimnis in der URL oder nutzen Sie die Weiterleitung mit X-EC-Signature.
  • Den WhatsApp-Trigger-Knoten von n8n verwenden. Er erwartet Ihre eigene Meta-App; nutzen Sie stattdessen den allgemeinen Webhook-Knoten mit einem Geheimnis in seiner URL.
  • smb_message_echoes ignorieren. Der Agent antwortet dann auf eine Person, die bereits vom Telefon aus geantwortet hat, und der Kunde liest zwei Antworten.
  • Das direkte Webhook-Ziel Tage nach der Verbindung speichern oder die Nummer auf Automatisierungen lassen. Metas einmaliger Import von Kontakten und bis zu 6 Monaten Chats braucht ein direktes Ziel, das innerhalb von 24 Stunden nach der Verbindung gespeichert wurde.
Mit EasyCoexistence

Der Agent arbeitet über mehr als 30 MCP-Tools oder über die Zugangsdaten und Webhooks jeder Nummer, und jede Nummer wird rund um die Uhr mit Warnmeldungen überwacht. Ab US$ 9 pro Nummer und Monat, sinkend auf US$ 0.75 mit jeder weiteren Nummer, die ersten 3 Tage in der kostenlosen Testphase.

Häufig gestellte Fragen

Brauchen Sie eine eigene Meta-App?

Nein. Die Nummer wird über die Meta-App von easyCoexistence angebunden und bleibt im eigenen Business Portfolio und WhatsApp Business Account des Unternehmens. Ihr Code sendet mit dem eigenen Token des Unternehmens aus get_api_credentials, daher ist keine eigene App beteiligt, es sei denn, Sie bauen später eine.

Können der Agent und das Team die Nummer gleichzeitig nutzen?

Ja. Meta spiegelt Nachrichten zwischen der Cloud API und der WhatsApp Business App, sodass gesendete Nachrichten des Agenten im Chatverlauf der App auf dem Telefon erscheinen und was das Team in der App tippt, als smb_message_echoes an Ihr System gelangt.

Mit welchen Agent-Frameworks funktioniert es?

Mit jedem Client, der MCP über HTTP mit OAuth spricht, etwa ChatGPT, Claude, Claude Code, Codex und Cursor, und mit jedem Code, der die Graph API von Meta aufruft: Node.js, Python, n8n, LangChain, das OpenAI Agents SDK oder das Vercel AI SDK. Die darunterliegende API ist die von Meta selbst, daher steckt nichts Proprietäres im Agenten.

Ist ein allgemeiner KI-Assistent auf WhatsApp erlaubt?

Metas Business Solution Terms, Abschnitt 4.7, untersagen Anbietern allgemeiner KI-Assistenten, diese auf der WhatsApp Business Platform anzubieten, wenn die KI nach Metas Feststellung die Hauptfunktion ist. Die Regel gilt seit dem 15. Januar 2026. Ein Unternehmen, das KI für die eigenen Kunden einsetzt, etwa für Support, Vertrieb oder Buchungen, ist nicht die Zielgruppe. Regulierungsbehörden in der EU und in Brasilien haben Meta angewiesen, die Regel für konkurrierende Assistenten auszusetzen oder zurückzunehmen.

Weiterlesen

Bereit für den Start?

Richten Sie WhatsApp Coexistence in wenigen Minuten statt Monaten ein. Die App funktioniert weiterhin auf dem Telefon.

Kostenlose Testphase starten

Verifiziert am