InloggenGratis proefperiode starten
Meta Tech Provider

Bouw een WhatsApp-bot met Claude Code of Codex, op het nummer dat je in de app houdt

Voeg een WhatsApp-MCP-server toe aan Claude Code of Codex en laat de codeeragent de installatie doen: hij leest de Cloud API-gegevens van het nummer, bouwt een webhook-ontvanger, stuurt inkomende berichten daarheen en verstuurt een testbericht naar iemand die de afgelopen 24 uur heeft geschreven. Wat je overhoudt is je eigen agent, die als jouw code op jouw server draait.

easyCoexistence verbindt het WhatsApp Business-nummer dat je in de app houdt met de Cloud API van Meta via Coexistence en geeft Claude Code en Codex meer dan 30 MCP-tools om mee te bouwen: inloggegevens, routering, templates, testberichten en automatiseringen.

--scope user

Claude Code-vlag die een server in al je projecten laadt; de standaard lokale scope laadt hem alleen waar hij is toegevoegd.

codex mcp login

Codex-commando dat de OAuth-aanmelding van een server opslaat; zonder inloggegevens kan Codex zonder authenticatie verbinden.

HTTPS

Wat een directe webhook-bestemming moet gebruiken, en hij moet hub.challenge terugsturen in de GET-handshake van Meta.

20 seconds

Hoe lang een stap Call my webhook wacht op de {"reply"} van je endpoint voordat de stap mislukt.

24 hours

Klantenservicevenster na het laatste bericht van de gebruiker; daarbuiten accepteert Meta alleen templateberichten.

20 msg/s

Vaste doorvoer van een nummer dat zowel met de WhatsApp Business-app als met de Cloud API wordt gebruikt.

Wat heeft een codeeragent nodig om een WhatsApp-agent te bouwen?

Vier dingen. Een WhatsApp Business-nummer dat via Coexistence met de Cloud API van Meta is verbonden, zodat de app op de telefoon blijft terwijl code kan verzenden en ontvangen. Een MCP-verbinding van Claude Code of Codex naar dat nummer, waarmee de codeeragent inloggegevens kan lezen, routering kan wijzigen en testberichten kan sturen zonder dat je een dashboard opent. Een publiek HTTPS-adres voor de ontvanger, van een host waar je naartoe deployt of een tunnel terwijl je ontwikkelt. En een API-sleutel voor het model van de agent die je bouwt.

Houd de twee agents uit elkaar. Claude Code of Codex is de bouwer: die werkt alleen zolang je er in de terminal mee werkt. Het programma dat hij schrijft is het programma dat klanten antwoordt, en dat blijft draaien nadat je de sessie sluit.

Hoe voeg je de WhatsApp-tools toe aan Claude Code en Codex?

Elk krijgt één URL vanuit de terminal en meldt zich aan met OAuth, zodat er geen sleutel in een bestand komt te staan. In Claude Code voeg je de server toe met --scope user, zodat hij in elk project laadt; start daarna claude, voer /mcp uit, kies easycoexistence en meld je aan in de browser. In Codex voeg je de server toe en voer je codex mcp login uit, wat de aanmelding opslaat; codex mcp list toont wat is ingesteld. Codex bewaart de vermelding in ~/.codex/config.toml, dat ook de ChatGPT-desktopapp en de Codex-IDE-extensie lezen.

Controleer of het werkt door iets te vragen wat alleen de tools kunnen beantwoorden, zoals "toon mijn WhatsApp-nummers". De agent roept list_numbers aan en krijgt per nummer een connection_id terug, die elke andere tool nodig heeft.

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

Welke route moet de agent bouwen?

Drie routes brengen het bericht van een klant naar je code, en ze verschillen in hoeveel de code moet afhandelen. Voor een eerste versie is de stap Call my webhook het kortst: easyCoexistence slaat dubbele berichten over, trekt zich terug wanneer je vanaf de telefoon antwoordt en controleert het venster van 24 uur voordat je endpoint wordt aangeroepen, zodat je code alleen het antwoord hoeft te schrijven. Ga over naar een Forward URL of een directe bestemming wanneer de agent elke gebeurtenis nodig heeft, en niet alleen de berichten die een automatisering selecteert.

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

Wat moet je de codeeragent vragen?

Geef de route, de taal en de regels vooraf en vraag om een plan voordat er code wordt geschreven. Zeg welke tool-aanroepen de agent zelfstandig mag doen: inloggegevens en documentatie lezen is onschadelijk, terwijl wijzigen waarheen berichten gaan het live nummer raakt. get_docs geeft de documentatie van easyCoexistence terug, inclusief hoe een ontvanger de leveringen authenticeert, zodat de agent de regels kan lezen in plaats van ze te raden. Een verzoek als dit levert een ontvanger op die je in één zitting kunt nakijken:

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.

Hoe koppel je de ontvanger en test je hem?

Start de server op een plek waar Meta en easyCoexistence hem via HTTPS kunnen bereiken, en laat daarna de agent de routering instellen. Voor de Forward URL-route roept hij set_inbound_mode aan met jouw URL op een nummer in Automations met modus on; het forward secret komt één keer terug en de agent schrijft het in je .env. Voor de directe route moet het endpoint eerst Meta's GET-handshake beantwoorden; daarna roept de agent set_webhook_destination aan met de URL, een lang willekeurig geheim in het pad en je verify token.

Test door vanaf je eigen telefoon een bericht naar het bedrijfsnummer te sturen en de logs te volgen: de ontvanger moet de gebeurtenis zien, het model moet antwoorden en het antwoord moet in de chat verschijnen. Omdat je net een bericht hebt gestuurd, staat het venster van 24 uur open, dus de codeeragent kan ook send_message naar je eigen nummer proberen.

Heeft de afgeronde agent de MCP-server nog nodig?

Nee. De MCP-server is het gereedschap van de bouwer, aangemeld als jij. De agent die je uitrolt stuurt via de Graph API van Meta met het send_endpoint en het access_token die get_api_credentials heeft teruggegeven, het eigen token van het bedrijf dat beperkt is tot de WhatsApp-assets van het bedrijf, en hij ontvangt via de route die je hebt ingesteld. Als access_token null teruggaf, geeft opnieuw verbinden van het nummer vanuit het dashboard er een uit, zonder een token te vervangen dat al werkt.

Houd de MCP-verbinding aan voor het werk rond de agent: templates maken met create_template, get_number_health controleren als iets niet klopt, en het uitvoeringslogboek lezen van elke automatisering die berichten aan je code doorgeeft.

Zo stel je het in

  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.

Veelgemaakte fouten

  • Een tijdelijke tunnel opslaan als directe bestemming in de eerste 24 uur. De eenmalige import van contacten en tot 6 maanden chats van Meta gaat naar die URL en gaat verloren zodra de tunnel sluit.
  • Een directe bestemming instellen op een nummer dat automatiseringen draait. Het nummer schakelt over naar direct en de automatiseringen stoppen; gebruik een Forward URL in Automations met modus on om beide te behouden.
  • De .env die de agent schreef, in git opnemen. Voeg hem eerst toe aan .gitignore, want wie het access_token heeft, kan klanten sturen namens het bedrijf.
  • send_message testen op een contact dat in de afgelopen 24 uur niet heeft geschreven. Meta weigert vrije tekst buiten het venster, dus stuur eerst een bericht vanaf je eigen telefoon naar het nummer.
Dit doen met EasyCoexistence

Je agent draait daarna op je eigen server, en elk nummer wordt 24/7 bewaakt met meldingen. US$ 9 tot US$ 0,75 per nummer per maand, dalend naarmate je nummers toevoegt, met een gratis proefperiode van 3 dagen.

Veelgestelde vragen

Werkt dit ook in Cursor of andere codeertools?

Ja. Elke MCP-client die via Streamable HTTP en OAuth verbinding maakt met externe servers, kan dezelfde URL gebruiken, waaronder Cursor, VS Code, Gemini CLI en Antigravity. Alleen het configuratieformaat verschilt per client.

Welke taal moet de agent schrijven?

Elke taal die HTTPS kan serveren en een HMAC-SHA256 kan berekenen. Node.js en Python zijn de gangbare keuzes; geteste voorbeelden voor beide, met handtekeningcontroles, afhandeling van dubbele berichten en de telefoonpauze, staan op de pagina over de Node.js- en Python-agent.

Heb ik een eigen Meta-app of App Review nodig?

Nee. Het nummer sluit via de Meta-app van easyCoexistence aan op de Cloud API en blijft in het Business Portfolio van het bedrijf. Het token waarmee je code verzendt is van het bedrijf zelf, dus er komt geen eigen Meta-app bij kijken.

Kan de codeeragent de templates maken die de agent nodig heeft?

Ja, met create_template, daarna get_template_status tot Meta antwoordt, meestal binnen enkele minuten en hooguit ongeveer 24 uur. Je agent heeft een goedgekeurd template nodig om een gesprek te starten of om te schrijven nadat het venster van 24 uur is gesloten.

Lees verder

Klaar om te beginnen?

Stel WhatsApp Coexistence in enkele minuten in, niet maanden. De app blijft op je telefoon werken.

Start je gratis proefperiode

Geverifieerd op