InloggenGratis proefperiode starten
Meta Tech Provider

WhatsApp API voor AI-agents: officiële toegang in enkele minuten, zonder Tech Provider te worden

Een AI-agent krijgt officiële WhatsApp-toegang via de Cloud API van Meta. Een nummer dat in de WhatsApp Business-app blijft, sluit daarop aan via een Tech Provider of Solution Partner. Je kunt zelf zo'n partner worden, met bedrijfsverificatie, App Review-video's en een Embedded Signup-build, of verbinden via een provider die dat al is: het nummer is binnen enkele minuten gekoppeld en de agent krijgt MCP-tools of API-inloggegevens.

easyCoexistence is een onafhankelijke Meta Tech Provider: het koppelt een WhatsApp Business-nummer via Coexistence in minuten aan de Cloud API, zodat je agent officiële toegang krijgt terwijl het bedrijf de app behoudt.

Tech Provider

Wat Meta vereist van wie een nummer koppelt dat in de WhatsApp Business-app blijft: de status van Tech Provider of Solution Partner.

2 videos

App Review vraagt om één video van een bericht dat vanuit je app is verzonden, en één van je app die een template aanmaakt.

Advanced access

Wat App Review toekent voor whatsapp_business_messaging en whatsapp_business_management, beide vereist om Tech Provider te worden.

October 15, 2026

Toen Meta Embedded Signup v2 en v3 als verouderd aanmerkte en integraties opdroeg over te stappen naar v4.

20 msg/s

Vaste doorvoer van een nummer dat tegelijk in de WhatsApp Business-app en de Cloud API wordt gebruikt.

1 hour

Hoe lang een gehoste koppellink geldig blijft wanneer een platform het nummer van een klant koppelt via de Partner API.

Wat heeft een AI-agent nodig om WhatsApp officieel te gebruiken?

Vier dingen uit de Cloud API van Meta. Een telefoonnummer-ID en een toegangstoken met de permissie whatsapp_business_messaging, zodat de agent het messages-endpoint kan aanroepen. Een webhook-endpoint waar Meta inkomende berichten aflevert, plus, bij een nummer dat met de app wordt gedeeld, smb_message_echoes voor de antwoorden die iemand op de telefoon typt. Goedgekeurde templates, want een zelf getypt bericht bereikt alleen iemand die de afgelopen 24 uur heeft geschreven. En een manier om te merken wanneer de koppeling breekt, omdat de app op de telefoon blijft werken wanneer de API-kant stopt.

De snelkoppeling die mensen als eerste vinden is automatisering van WhatsApp Web, die inlogt als gekoppeld apparaat. Dat breekt de voorwaarden van WhatsApp en brengt het nummer in gevaar van een ban, wat de agent erbovenop ook doet.

Wat houdt de Tech Provider-route in?

De eigen volgorde van Meta, in deze volgorde. Elke stap is gratis, en geen enkele kan sneller worden gekocht: de reviews lopen volgens het schema van Meta en Meta publiceert geen tijdlijn, dus reken op weken in plaats van dagen voordat het nummer van de eerste klant verbonden is. Daarna moet de backend blijven draaien: de uitwisseling van het token na elke aanmelding, een webhook-ontvanger, routering per nummer en monitoring op verbreking, zoals de inactiviteitsregel van Meta van 14 dagen.

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

Wat is de kortere route?

Verbind het nummer via een provider die dat proces al heeft doorlopen. Met easyCoexistence doet het bedrijf de Embedded Signup van Meta en scant het een code met de WhatsApp Business-app, wat ongeveer twee minuten duurt. Het nummer sluit dan aan op de Cloud API in de eigen Business Portfolio van het bedrijf, terwijl de app blijft werken. De agent krijgt vervolgens toegang in de vorm die bij hem past: MCP-tools voor een assistent zoals ChatGPT, Claude, Claude Code of Codex, of de inloggegevens en webhooks van het nummer voor code die je zelf draait.

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

Hoe krijgt de agent de inloggegevens van het nummer?

Via get_api_credentials, of vanaf de pagina van het nummer in het dashboard. De tool geeft de basis-URL van de Graph API, het WhatsApp Business Account-ID, het telefoonnummer-ID, het send-endpoint en, als die er is, het eigen toegangstoken van het bedrijf, beperkt tot de WhatsApp-assets. Als er geen client-token is uitgegeven, komt het token terug als null, met een melding dat opnieuw verbinden van het nummer vanuit het dashboard er een uitgeeft, zonder een werkend token te vervangen. Er is geen app-secret op te halen, omdat Meta webhooks ondertekent met het app-secret van easyCoexistence, dat nooit wordt gedeeld. De tool vereist een actief abonnement, omdat het token kan verzenden.

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." }
  }'

Hoe komen inkomende berichten bij de agent?

Elk nummer heeft twee modi, die je wisselt met set_inbound_mode of op de pagina van het nummer. Rechtstreeks naar je server: set_webhook_destination richt Meta direct op je HTTPS-endpoint, dat de GET-handshake van Meta moet beantwoorden, en easyCoexistence ziet de berichten nooit, dus automatiseringen staan uit. Omdat Meta die leveringen ondertekent met ons app-secret, zet je een lang willekeurig geheim in het URL-pad en wijs je verzoeken zonder dat geheim af.

Automatiseringen aan: Meta levert aan easyCoexistence, automatiseringen kunnen antwoorden, en een optionele Forward URL ontvangt de originele payload van Meta onder "value", ondertekend met X-EC-Signature: t=<unix>,v1=<HMAC-SHA256 van "<t>.<body>"> met een geheim dat één keer wordt getoond. De stap Call my webhook van een automatisering geeft ook het bericht en de laatste 10 berichten uit de chat aan je agent, en stuurt het antwoord wanneer je antwoord {"reply": "..."} is binnen 20 seconden.

Aan welke limieten moet de agent zich houden?

Die van Meta, en die zijn bij elke provider hetzelfde. Een agent die ze vooraf kent, vermijdt de fouten die op bugs lijken:

  • 20 berichten per seconde per nummer, vastgesteld door Meta voor nummers die met de WhatsApp Business-app worden gedeeld.
  • Zelf getypte berichten alleen binnen 24 uur na het laatste bericht van de klant; daarna een goedgekeurd template.
  • Templates gaan alleen via de API, omdat de app op een Coexistence-nummer ze niet kan verzenden.
  • Antwoorden die iemand in de app typt, komen binnen als smb_message_echoes; pauzeer de agent in die chat, anders krijgt de klant twee antwoorden.
  • Groepschats worden niet gesynchroniseerd met de API, dus de agent werkt in één-op-één-chats.
  • Contacten en tot 6 maanden één-op-één-chats worden één keer geïmporteerd, alleen als een directe webhook-bestemming binnen 24 uur na het koppelen is opgeslagen; een nummer met automatiseringen aan krijgt die import niet.
  • Spraak- en videogesprekken blijven werken in de app, maar de Cloud API draagt geen gesprekken op een Coexistence-nummer, dus de agent werkt via tekst.

Kan een platform de nummers van zijn eigen klanten zo koppelen?

Ja, via de Partner API. Zo koppelt een SaaS of bureau zijn klanten zonder eigen Tech Provider-status. Maak de sleutel aan met create_api_key (die begint met ec_live_ en één keer wordt getoond), en roep daarna vanuit je backend POST /api/v1/connect-sessions aan, of create_connect_link vanuit de assistent, voor een gehoste link die 1 uur geldig is. De klant doorloopt daar de pop-up van Meta en de QR-scan en keert terug naar je redirect_url met een connection_id. GET /api/v1/connections/:id?credentials=1 geeft daarna het eigen token van de klant terug, en statusgebeurtenissen zoals connection.disconnected komen binnen, ondertekend met X-EC-Signature. Elk nummer wordt aan jouw account gefactureerd tegen dezelfde per-nummer-schijven.

Veelgemaakte fouten

  • X-Hub-Signature-256 valideren op een directe bestemming. Meta ondertekent met het app-secret van easyCoexistence, dat nooit wordt gedeeld, dus echte leveringen falen de controle; vertrouw op een lang willekeurig geheim in de URL, of gebruik doorsturen met X-EC-Signature.
  • Ontvangen met de WhatsApp Trigger-node van n8n. Die verwacht je eigen Meta-app; gebruik in plaats daarvan de generieke Webhook-node met een geheim in de URL.
  • smb_message_echoes negeren. De agent antwoordt dan bovenop iemand die al vanaf de telefoon heeft geantwoord, en de klant leest twee antwoorden.
  • De directe webhook-bestemming dagen na het koppelen opslaan, of het nummer op automatiseringen laten staan. De eenmalige import van contacten en tot 6 maanden chats van Meta heeft een directe bestemming nodig die binnen 24 uur na de koppeling is opgeslagen.
Dit doen met EasyCoexistence

De agent werkt via meer dan 30 MCP-tools of via de inloggegevens en webhooks van elk nummer, en elk nummer wordt 24/7 bewaakt met waarschuwingen. Van US$ 9 tot US$ 0.75 per nummer per maand, dalend naarmate je meer nummers toevoegt, met de eerste 3 dagen gratis.

Veelgestelde vragen

Heb ik mijn eigen Meta-app nodig?

Nee. Het nummer wordt gekoppeld via de Meta-app van easyCoexistence en blijft in de eigen Business Portfolio en het WhatsApp Business Account van het bedrijf. Je code verzendt met het eigen token van het bedrijf uit get_api_credentials, dus er is geen app van jou bij betrokken, tenzij je er later zelf een bouwt.

Kunnen de agent en het team het nummer tegelijk gebruiken?

Ja. Meta spiegelt berichten tussen de Cloud API en de WhatsApp Business-app, dus wat de agent verstuurt, verschijnt in de chatthread van de app op de telefoon, en wat het team in de app typt, komt bij je systeem aan als smb_message_echoes.

Welke agent-frameworks werken ermee?

Elke client die MCP over HTTP met OAuth spreekt, zoals ChatGPT, Claude, Claude Code, Codex en Cursor, en elke code die de Graph API van Meta aanroept: Node.js, Python, n8n, LangChain, de OpenAI Agents SDK of de Vercel AI SDK. De API eronder is van Meta zelf, dus er zit niets eigens in de agent.

Mag een algemene AI-assistent op WhatsApp?

Artikel 4.7 van de Business Solution Terms van Meta verbiedt aanbieders van algemene AI-assistenten om die aan te bieden op het WhatsApp Business Platform waar de AI de primaire functionaliteit is, zoals Meta bepaalt, van kracht sinds 15 januari 2026. Een bedrijf dat AI voor zijn eigen klanten gebruikt, voor support, verkoop of boekingen, valt er niet onder, en toezichthouders in de EU en Brazilië hebben Meta opgedragen de regel voor concurrerende assistenten op te schorten of terug te draaien.

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