AnmeldenKostenlose Testphase starten
Meta Tech Provider

Einen WhatsApp-Bot mit Claude Code oder Codex bauen, auf der Nummer, die Sie in der App behalten

Fügen Sie einen WhatsApp-MCP-Server zu Claude Code oder Codex hinzu und lassen Sie den Coding-Agenten das Setup übernehmen: Er liest die Cloud-API-Zugangsdaten der Nummer, legt einen Webhook-Empfänger an, leitet eingehende Nachrichten dorthin weiter und sendet eine Testantwort an jemanden, der in den letzten 24 Stunden geschrieben hat. Am Ende steht Ihr eigener Agent, der als Ihr Code auf Ihrem Server läuft.

easyCoexistence verbindet die WhatsApp-Business-Nummer, die Sie in der App behalten, über Coexistence mit der Cloud API von Meta und gibt Claude Code und Codex mehr als 30 MCP-Tools zum Bauen an die Hand: Zugangsdaten, Routing, Templates, Testsendungen und Automatisierungen.

--scope user

Claude-Code-Flag, das einen Server in allen Ihren Projekten lädt; der Standardbereich local lädt ihn nur dort, wo er hinzugefügt wurde.

codex mcp login

Codex-Befehl, der die OAuth-Anmeldung eines Servers speichert; ohne Zugangsdaten kann sich Codex ohne Authentifizierung verbinden.

HTTPS

Was ein direktes Webhook-Ziel verwenden muss; es muss hub.challenge im GET-Handshake von Meta zurückgeben.

20 seconds

Wie lange ein Schritt „Mein Webhook aufrufen“ auf das {"reply"} Ihres Endpoints wartet, bevor der Schritt fehlschlägt.

24 hours

Kundenservice-Fenster nach der letzten Nachricht des Nutzers; danach akzeptiert Meta nur Template-Nachrichten.

20 msg/s

Feste Durchsatzrate einer Nummer, die sowohl mit der WhatsApp-Business-App als auch mit der Cloud API genutzt wird.

Was braucht ein Coding-Agent, um einen WhatsApp-Agenten zu bauen?

Vier Dinge. Eine WhatsApp-Business-Nummer, die über Coexistence mit der Cloud API von Meta verbunden ist, sodass die App auf dem Telefon bleibt, während der Code senden und empfangen kann. Eine MCP-Verbindung von Claude Code oder Codex zu dieser Nummer, mit der der Coding-Agent Zugangsdaten liest, Routing ändert und Testnachrichten sendet, ohne dass Sie ein Dashboard öffnen. Eine öffentliche HTTPS-Adresse für den Empfänger, von einem Host, auf den Sie deployen, oder ein Tunnel während der Entwicklung. Und ein Modellschlüssel für den Agenten, den Sie bauen.

Halten Sie die beiden Agenten gedanklich auseinander. Claude Code oder Codex ist der Baumeister: Er handelt nur, solange Sie im Terminal mit ihm arbeiten. Das Programm, das er schreibt, beantwortet die Kundenanfragen und läuft weiter, nachdem Sie die Sitzung geschlossen haben.

Wie fügen Sie die WhatsApp-Tools zu Claude Code und Codex hinzu?

Jeweils genügt eine URL im Terminal, und die Anmeldung erfolgt per OAuth, sodass kein Schlüssel in einer Datei landet. In Claude Code fügen Sie den Server mit --scope user hinzu, damit er in jedem Projekt geladen wird. Dann starten Sie claude, führen /mcp aus, wählen easycoexistence und melden sich im Browser an. In Codex fügen Sie den Server hinzu und führen codex mcp login aus, was die Anmeldung speichert; codex mcp list zeigt, was konfiguriert ist. Codex legt den Eintrag in ~/.codex/config.toml ab, den auch die ChatGPT-Desktop-App und die Codex-IDE-Erweiterung lesen.

Prüfen Sie, ob es funktioniert, indem Sie etwas abfragen, das nur die Tools beantworten können, etwa „Liste meine WhatsApp-Nummern“. Der Agent ruft list_numbers auf und erhält die connection_id jeder Nummer, die jedes andere Tool verwendet.

Add the server, then sign in
# Claude Code: then start claude and run /mcp to sign in
claude mcp add --transport http easycoexistence --scope user https://easycoexistence.com/api/mcp

# Codex: add, store the OAuth sign-in, check
codex mcp add easycoexistence --url https://easycoexistence.com/api/mcp
codex mcp login easycoexistence
codex mcp list

Welche Route soll der Agent aufbauen?

Drei Routen bringen die Nachricht eines Kunden zu Ihrem Code, und sie unterscheiden sich darin, wie viel der Code verarbeiten muss. Für eine erste Version ist der Schritt „Mein Webhook aufrufen“ am kürzesten: easyCoexistence überspringt Duplikate, pausiert, wenn Sie vom Telefon antworten, und prüft das 24-Stunden-Fenster, bevor Ihr Endpoint aufgerufen wird, sodass Ihr Code nur die Antwort schreibt. Wechseln Sie zu einer Forward-URL oder einem direkten Ziel, wenn der Agent jedes Ereignis braucht und nicht nur die Nachrichten, die eine Automatisierung auswählt.

Call my webhook stepAn automation POSTs the message and the chat's last 10 messages, signed; return {"reply": "..."} within 20 seconds
Forward URL (Automations on)A signed copy of each Meta event goes to your code; automations keep running; you send through the Graph API
Direct destinationMeta posts straight to your endpoint; easyCoexistence never sees the messages; automations stop for that number

Was sollten Sie den Coding-Agenten bitten zu tun?

Geben Sie ihm die Route, die Sprache und die Regeln vorab und bitten Sie um einen Plan, bevor er Code schreibt. Legen Sie fest, welche Tool-Aufrufe er selbst machen darf: Zugangsdaten und Dokumentation zu lesen ist harmlos, während das Ändern des Nachrichtenziels die Live-Nummer betrifft. get_docs liefert die Dokumentation von easyCoexistence, einschließlich der Authentifizierung von Zustellungen am Empfänger, sodass der Agent die Regeln nachlesen statt sie zu erraten. Eine Anfrage wie diese liefert einen Empfänger, den Sie in einer Sitzung prüfen können:

A request for Claude Code or Codex
Build a WhatsApp agent in Node.js for my number +55 11 4000 1234.
1. Call list_numbers, then get_api_credentials for that number.
   Put send_endpoint and access_token in .env, never in code.
2. Scaffold an HTTPS server with POST /wa/<long random path>.
   Verify X-EC-Signature (HMAC-SHA256 of "<t>.<raw body>").
   Skip message ids already handled.
   On smb_message_echoes, stay quiet on that chat for 4 hours.
3. Reply with my model only within 24 hours of the
   customer's last message.
4. Write tests for the signature check and the 24-hour rule.
Do not call set_inbound_mode or set_webhook_destination
until I say so.

Wie verbinden Sie den Empfänger und testen ihn?

Starten Sie den Server dort, wo Meta und easyCoexistence ihn über HTTPS erreichen können, und lassen Sie dann den Agenten das Routing übernehmen. Für die Forward-URL-Route ruft er set_inbound_mode mit Ihrer URL für eine Nummer in Automatisierungen im Modus on auf; das Forward-Secret kommt einmal zurück, und der Agent schreibt es in Ihre .env. Für die direkte Route muss der Endpoint zuerst den GET-Handshake von Meta beantworten. Dann ruft der Agent set_webhook_destination auf, mit der URL, einem langen zufälligen Secret in ihrem Pfad und Ihrem Verify-Token.

Zum Testen schreiben Sie von Ihrem eigenen Telefon an die WhatsApp-Business-Nummer und beobachten die Logs: Der Empfänger sollte das Ereignis sehen, das Modell sollte antworten, und die Antwort sollte im Chat erscheinen. Da Sie gerade geschrieben haben, ist das 24-Stunden-Fenster offen, sodass der Coding-Agent auch send_message an Ihre eigene Nummer versuchen kann.

Braucht der fertige Agent noch den MCP-Server?

Nein. Der MCP-Server ist das Werkzeug des Baumeisters, angemeldet als Sie. Der Agent, den Sie deployen, sendet über die Graph API von Meta mit send_endpoint und access_token, die get_api_credentials zurückgegeben hat, dem eigenen Token des Unternehmens mit Zugriff nur auf seine WhatsApp-Assets. Empfangen tut er über die Route, die Sie eingerichtet haben. Falls access_token als null zurückkam, stellt das erneute Verbinden der Nummer im Dashboard einen neuen aus, ohne ein bereits funktionierendes Token zu ersetzen.

Behalten Sie die MCP-Verbindung für die Arbeit rund um den Agenten: Templates mit create_template anlegen, get_number_health prüfen, wenn etwas auffällig wirkt, und das Run-Log jeder Automatisierung lesen, die Nachrichten an Ihren Code übergibt.

So richten Sie es ein

  1. Connect your numberAt easycoexistence.com, run Meta's Embedded Signup and scan the code with the WhatsApp Business app; the app keeps its chats.
  2. Add the server to your coding agentRun the claude mcp add or codex mcp add command, then sign in with /mcp in Claude Code or codex mcp login in Codex.
  3. Ask for credentials and a planHave the agent call list_numbers and get_api_credentials, store the values in .env and propose the receiver before writing it.
  4. Expose the receiver over HTTPSDeploy it, or run a tunnel while developing, and confirm the URL answers from outside your machine.
  5. Route the messagesLet the agent call set_inbound_mode with a Forward URL, or set_webhook_destination for the direct route, once you approve.
  6. Test from your phoneSend the business number a message and check that your agent's reply arrives in the same chat.

Häufige Fehler

  • Einen Wegwerf-Tunnel in den ersten 24 Stunden als direktes Ziel speichern. Metas einmaliger Import von Kontakten und bis zu 6 Monaten Chats geht an diese URL und ist verloren, sobald der Tunnel schließt.
  • Ein direktes Ziel auf einer Nummer setzen, die Automatisierungen ausführt. Die Nummer wechselt auf direkt und ihre Automatisierungen stoppen; verwenden Sie eine Forward-URL in Automatisierungen im Modus on, um beides zu behalten.
  • Die .env committen, die der Agent geschrieben hat. Tragen Sie sie zuerst in .gitignore ein, denn wer das Zugriffs-Token besitzt, kann Kunden im Namen des Unternehmens anschreiben.
  • send_message an einen Kontakt testen, der seit 24 Stunden nicht geschrieben hat. Meta lehnt Freitext außerhalb des Fensters ab, also schreiben Sie zuerst von Ihrem eigenen Telefon an die Nummer.
Mit EasyCoexistence

Ihr Agent läuft dann auf Ihrem eigenen Server, und jede Nummer wird rund um die Uhr überwacht, mit Warnmeldungen. US$ 9 bis hinunter zu US$ 0.75 pro Nummer und Monat, sinkend mit jeder weiteren Nummer, mit den ersten 3 Tagen in der kostenlosen Testphase.

Häufig gestellte Fragen

Funktioniert das auch in Cursor oder anderen Coding-Tools?

Ja. Jeder MCP-Client, der sich über Streamable HTTP mit OAuth mit Remote-Servern verbindet, kann dieselbe URL nutzen, darunter Cursor, VS Code, Gemini CLI und Antigravity. Nur das Konfigurationsformat unterscheidet sich von einem Client zum anderen.

Welche Sprache sollte der Agent schreiben?

Jede Sprache, die HTTPS bereitstellen und einen HMAC-SHA256 berechnen kann. Node.js und Python sind die üblichen Wahlen. Getestete Beispiele für beide, mit Signaturprüfung, Duplikatbehandlung und der Pause bei Antwort vom Telefon, finden Sie auf der Agenten-Seite für Node.js und Python.

Brauche ich eine eigene Meta-App oder ein App Review?

Nein. Die Nummer tritt der Cloud API über die Meta-App von easyCoexistence bei und bleibt im eigenen Business Portfolio des Unternehmens. Das Token, mit dem Ihr Code sendet, gehört dem Unternehmen, daher ist keine eigene Meta-App im Spiel.

Kann der Coding-Agent die Templates anlegen, die der Agent braucht?

Ja, mit create_template, danach get_template_status, bis Meta antwortet, meist innerhalb von Minuten und höchstens etwa 24 Stunden. Ihr Agent braucht ein genehmigtes Template, um eine Unterhaltung zu beginnen oder nach Ablauf des 24-Stunden-Fensters zu schreiben.

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