WhatsApp Business Tools MCP: WhatsApp Business verbinden met een AI-agent

Op 15 september 2026 bracht Meta de officiële WhatsApp Business Tools MCP-server uit. Deze verbindt een AI-agent—Claude Code, Codex, ChatGPT of Cursor—met het WhatsApp Business Platform. In plaats van te schakelen tussen Developer Console, Business Manager en de API-documentatie, beschrijf je de taak aan de agent, waarna die een nummer toevoegt, een berichtsjabloon maakt, webhooks configureert en een testbericht verstuurt.

De server is nog in bèta: de toegang wordt geleidelijk uitgerold en de release is bedoeld voor ontwikkeling en testen, niet voor grootschalige productieberichten. Hieronder vind je de voorbereidingen en verbindingsstappen voor vier clients. De opdrachten en instellingen zijn gecontroleerd aan de hand van Meta’s officiële documentatie van 18 september 2026.

Informatie over werken met Ailoot vind je in de documentatie.

Wat is WhatsApp Business Tools MCP?#

MCP (Model Context Protocol) is een open standaard om externe systemen met AI-agenten te verbinden. Lees er meer over in het artikel MCP-servers voor Claude Code: 7 kant-en-klare integraties. Geverifieerde verbindingen met installatieopdrachten vind je in de MCP-catalogus.

Vóór deze release zag het instellen van een WhatsApp-integratie er zo uit: Developer Console openen, een app maken, een bedrijf koppelen, een telefoonnummer toevoegen, dit met een code verifiëren, een token genereren, een webhook configureren, de API-documentatie raadplegen—en pas daarna de eerste regel code schrijven.

Meta beschrijft het idee achter de server als volgt (vertaald uit het Engels):

Meta heeft nu twee MCP-servers, die gemakkelijk met elkaar te verwarren zijn. Meta Social Technologies MCP is een algemene tool voor ontwikkelaars: documentatie doorzoeken, Graph API-endpoints vinden en app-fouten diagnosticeren. WhatsApp Business Tools MCP is bedoeld om te werken met WhatsApp-accounts, telefoonnummers, sjablonen, webhooks en testberichten. Ze vullen elkaar aan; je kunt ze allebei verbinden als dat nodig is.

Wat kan de agent precies nadat je verbinding hebt gemaakt?#

De tools van de server zijn gegroepeerd onder het voorvoegsel whatsapp_biz_. Volgens de officiële documentatie:

• Overzicht: whatsapp_biz_businesses, whatsapp_biz_accounts, whatsapp_biz_phone_numbers—welke bedrijven, accounts en telefoonnummers voor jou beschikbaar zijn.
• Telefoonnummer instellen: whatsapp_biz_add_phone_number, whatsapp_biz_send_verification_code, whatsapp_biz_verify_phone_number, whatsapp_biz_register_phone_number.
• Sjablonen: whatsapp_biz_list_templates, whatsapp_biz_get_template, whatsapp_biz_create_template, whatsapp_biz_update_template, whatsapp_biz_delete_template.
• Berichten: whatsapp_biz_send_message—vrije tekst binnen het 24-uursvenster van een gesprek of een goedgekeurd sjabloon daarbuiten; de agent bevestigt de ontvanger met je voordat het bericht wordt verstuurd.
• Webhooks: whatsapp_biz_configure_webhooks, whatsapp_biz_subscribe_webhook.
• Account instellen: whatsapp_biz_configure_payments, whatsapp_biz_verify_business, whatsapp_biz_system_user_token—een link om een system user-token te maken voor directe Cloud API-aanroepen.

Wanneer een klant het bedrijf als eerste een bericht stuurt, gaat er een klantenservicevenster open: je kunt 24 uur lang met vrije tekst reageren. Elk nieuw bericht van de klant verlengt het venster. Zodra het sluit, kun je alleen nog contact opnemen met een goedgekeurd sjabloon. De agent kent deze regel en stelt voor om een sjabloon te sturen in plaats van gewone tekst als de ontvanger buiten het venster valt.

De server heeft ingebouwde toegangscontroles. Je meldt je aan via je Meta-account en selecteert specifieke bedrijven; tokens worden niet in de gespreksgeschiedenis opgenomen. Elke leesactie wordt uitgevoerd in jouw context, aanroepen worden geregistreerd en voor acties die iets wijzigen is een geauthenticeerde persoon vereist; alleen een serversleutel van de app is niet voldoende.

Wat moet je controleren voordat je verbinding maakt?#

De server handelt namens jou en werkt alleen met jouw resources. Controleer daarom het volgende voordat je de eerste aanroep doet:

1. Je hebt een Meta-bedrijf waarin je beheerder bent (de rol MANAGE).
2. Je hebt een Meta-app waarin het scenario WhatsApp Business Messaging is ingeschakeld (of het WhatsApp-product in oudere apps), en je bent specifiek beheerder van die app; rechten op bedrijfsniveau alleen zijn niet voldoende.
3. De voorwaarden voor de WhatsApp Business Cloud API zijn voor het bedrijf geaccepteerd—zonder die acceptatie worden het registreren van telefoonnummers en het versturen geblokkeerd.

Volgens Meta ontstaan problemen met gebruiksvoorwaarden, betaalmethoden en bedrijfsverificatie vaak zonder duidelijke uitleg. De agent controleert dit vooraf en geeft een directe link waarmee je de voorwaarden kunt accepteren, een betaalmethode kunt opgeven of de bedrijfsverificatie kunt starten.

Hoe verbind je de server met Claude Code?#

Als je Claude Code nog niet hebt geïnstalleerd, begin dan met de handleiding Claude Code installeren vanaf de officiële website.

1. De server toevoegen

   Voer in de terminal het volgende uit:

   claude mcp add --transport http whatsapp_business_tools https://mcp.facebook.com/whatsapp_business_tools
   

   De server is extern, dus je hoeft hem niet lokaal te installeren.

2. Aanmelden via Meta

   Typ in een Claude Code-sessie /mcp en selecteer whatsapp_business_tools. Er wordt een browservenster geopend om je aan te melden bij je Meta-account. Als de browser niet wordt geopend, kopieer je de link vanuit de client en open je die handmatig.

3. Machtigingen verlenen

   Selecteer op het toestemmingsscherm de bedrijven en apps met WhatsApp waartoe je toegang verleent. De server vraagt drie machtigingen: business_management (bedrijven vinden waarvan je beheerder bent), whatsapp_business_management (accounts, telefoonnummers, sjablonen, webhooks) en whatsapp_business_messaging (berichten versturen vanaf je nummers).

4. De verbinding controleren

   Start Claude Code opnieuw, meld je opnieuw aan via /mcp en vraag de agent welke tools hij op de server whatsapp_business_tools ziet. Voer daarna een veilige leesactie uit: “Geef de bedrijven weer die ik kan beheren”—de agent roept whatsapp_biz_businesses aan. Als er geen tools zijn of je een aanmeldfout krijgt, controleer je het serveradres en meld je je opnieuw aan.

Aanmelden via OAuth is gekoppeld aan het starten van de client: nadat je Claude Code opnieuw hebt gestart, moet je je opnieuw aanmelden. Je kunt de toegang op elk moment intrekken in de instellingen op facebook.com, onder “Business Integrations”.

Hoe verbind je Codex, ChatGPT en Claude Desktop?#

Codex App. Open de instellingen (het tandwiel linksonder), ga naar MCP Servers en selecteer Add servers. Kies Streamable HTTP en vul in:

• Name: WhatsApp Business Tools
• URL: https://mcp.facebook.com/whatsapp_business_tools
• Authentication: OAuth

Klik op Authenticate en meld je aan in de browser.

ChatGPT. Ga naar Settings, Plugins, Browse plugins en het pictogram “+” in de rechterbovenhoek. Voer een naam, dezelfde URL en OAuth als authenticatietype in.

Claude Desktop. Ga naar Settings, Connectors, Add custom connector. Name: WhatsApp Business Tools; URL: hetzelfde serveradres.

Volg na het toevoegen in een willekeurige client dezelfde controlevolgorde: opnieuw starten, opnieuw aanmelden, de lijst met tools bekijken en de lijst met bedrijven veilig uitlezen.

Wat gebeurt er in de eerste sessie: van bedrijvenlijst tot testbericht?#

Een gebruikelijke eerste sessie met de verbonden server:

1. “Geef de bedrijven weer die ik beheer”—de agent roept whatsapp_biz_businesses aan en jij kiest het gewenste bedrijf.
2. “Laat de WhatsApp-accounts en telefoonnummers van dit bedrijf zien”—whatsapp_biz_accounts en whatsapp_biz_phone_numbers, met hun statussen.
3. “Voeg mijn testtelefoonnummer toe aan het account”—whatsapp_biz_add_phone_number.
4. “Stuur een verificatiecode per sms”—whatsapp_biz_send_verification_code. De code komt op je telefoon binnen.
5. “Verifieer het nummer met code 123456”—whatsapp_biz_verify_phone_number en registreer het daarna met whatsapp_biz_register_phone_number.
6. “Maak voor ordermeldingen een order_update-sjabloon in de taal die ontvangers verkiezen”—whatsapp_biz_create_template; de agent geeft een link naar de goedkeuringsstatus.
7. “Stuur een testbericht naar mijn nummer”—whatsapp_biz_send_message; de agent bevestigt de ontvanger voordat het bericht wordt verstuurd.
8. “Configureer een webhook op https://example.com/webhook”—whatsapp_biz_configure_webhooks en abonneer je met whatsapp_biz_subscribe_webhook.

Daarna komen binnenkomende berichten van klanten aan op het opgegeven adres—meestal haalt een CRM, klantenservice of bot ze daar op. Je bouwt de verwerking op dat adres afzonderlijk; de server regelt alleen de configuratie.

Wat zijn de beperkingen van de bèta?#

Er zijn vier serverbeperkingen om rekening mee te houden.

Bètastatus. Meta zegt dat de interface en set tools kunnen veranderen en dat de toegang geleidelijk wordt uitgerold. Als je nog geen verbinding met de server kunt maken, is hij mogelijk nog niet voor jou beschikbaar.

Doel. De release is bedoeld voor ontwikkeling en testen; hij is niet bedoeld voor massale productieberichten. Voor productieberichten heb je een volledige integratie met de Cloud API nodig—bijvoorbeeld met een system user-token. De tool whatsapp_biz_system_user_token geeft daarvoor een link.

Limieten. Het aantal verzoeken is voor elke tool per gebruiker beperkt. Als je de limiet overschrijdt, geeft de tool een limietfout—wacht even en probeer het opnieuw.

Regel voor het 24-uursvenster. Buiten het gespreksvenster met de klant kun je alleen goedgekeurde sjablonen versturen.

Waarom is dit belangrijk voor een bedrijf?#

Een gebruikelijk scenario voor een klein bedrijf: klanten sturen berichten via WhatsApp, en je wilt snel antwoorden en meldingen over de bestelstatus versturen. Voorheen betekende de eerste configuratie dat je zelf in verschillende Meta-dashboards aan de slag moest of een ontwikkelaar moest inhuren. Nu kun je dit deel afronden in een gesprek met een agent. Je moet de verwerking van binnenkomende berichten op je eigen adres nog steeds afzonderlijk bouwen—dat is de volgende taak na het configureren van de webhook.

De server is ook handig als je integratie al actief is. Berichtsjablonen moeten regelmatig worden bijgewerkt: een nieuwe actie, een nieuwe meldingstekst. Via de server maakt of bewerkt de agent een sjabloon en toont hij de goedkeuringsstatus, zonder dat je naar het dashboard hoeft.

Een vergelijkbare aanpak—een agent verbindt met een extern systeem en werkt ermee op basis van jouw beschrijving—wordt met documentatie geïllustreerd in de handleiding NotebookLM via MCP verbinden met Claude Code.

Wat nu?#

De aankondiging van de server is drie dagen oud. Je kunt beginnen met één opdracht en je aanmelden via Meta. Vraag daarna de agent om een lijst van je bedrijven. Vervolgens kun je, afhankelijk van je behoeften, aan de slag met telefoonnummers, sjablonen, webhooks en testberichten.

Andere manieren om een agent met externe systemen te verbinden vind je in de verzameling MCP-servers voor Claude Code—er zijn nog zeven werkende integraties voor verschillende taken.

Maak kennis met Ailoot.