MCP-toolsreferentie
De connector biedt meer dan 30 tools voor elke verbinding in een account. list_numbers komt eerst voor WhatsApp, waarvan de tools een connection_id nodig hebben, en list_social_accounts voor de andere kanalen, waarvan de tools een account_id nodig hebben. Zes worden geblokkeerd bij verlopen betaling: de vier WhatsApp-tools die op de buitenwereld werken, get_api_credentials, dat het toegangstoken teruggeeft, en create_connect_link. De rest blijft beschikbaar.
Tools die de connector beschikbaar stelt.
Tools die bij verlopen betaling worden geblokkeerd, inclusief get_api_credentials, dat het toegangstoken teruggeeft.
OAuth-aanmelding voor elk nummer in het account.
Wat doet elke tool?
Lezen: list_numbers geeft de verbonden nummers terug met status, kwaliteitsbeoordeling en messaging-tier. Hier begint elke andere aanroep. get_number_health geeft samen een live Meta-momentopname, de recente monitoringtijdlijn, webhookgebeurtenissen en pollercontroles. get_api_credentials geeft de Graph API-basis-URL, WABA id, phone number id en, indien beschikbaar, het eigen access token van het account terug.
Verzenden: send_message verstuurt vrije tekst binnen het 24-uursvenster, waarin antwoorden gratis zijn. send_template verstuurt een goedgekeurd template. Zo start je een gesprek met iemand die nog niets heeft geschreven. list_templates, create_template en get_template_status dekken de volledige templatelevenscyclus.
Koppelen: set_webhook_destination stuurt binnenkomende berichten en app-echo's naar je systeem. null instellen zet dit terug. get_connect_link geeft de dashboardlink en stappen om een nieuw nummer te koppelen. get_docs geeft de productdocumentatie als markdown terug.
Partner API, voor software of bureaus waarvan de eigen klanten nummers koppelen: get_partner_setup toont de betaalstatus, de API-sleutel, de URL voor events en de volgende stap. create_api_key maakt de Partner API-sleutel aan en toont die één keer, en vervangt een bestaande sleutel niet zonder uitdrukkelijke bevestiging. revoke_api_key trekt de sleutel in, ook pas na bevestiging. set_partner_events_url stelt in waar statusevents heen gaan en geeft het ondertekeningsgeheim één keer terug. create_connect_link maakt een gehoste koppellink voor één klant, 1 uur geldig, hetzelfde als POST /api/v1/connect-sessions.
Waarom is connection_id belangrijk?
Omdat dit een instructie aan een specifiek nummer koppelt en een assistent het niet kan raden.
Elke tool die op een nummer werkt, heeft een connection_id nodig. Alleen list_numbers levert er een. In de praktijk betekent dit dat een assistent die een bericht moet versturen eerst list_numbers aanroept. Daarom is het eerste verzoek in een sessie vaak trager dan de rest.
Ook bij meerdere nummers in één account blijft alles daardoor eenduidig. Er is geen standaardnummer en geen impliciete selectie. Een instructie die niet aangeeft over welk nummer het gaat, wordt daarom bevraagd in plaats van geraden.
Wat gebeurt er als de betaling verloopt?
Zes tools worden geblokkeerd: send_message, send_template, create_template en set_webhook_destination, die op de buitenwereld werken; get_api_credentials, omdat het het toegangstoken van het account teruggeeft, waarmee een geblokkeerd account rechtstreeks via de Graph API zou kunnen versturen; en create_connect_link, dat een nieuw nummer koppelt. Al het andere leeswerk blijft beschikbaar, net als de Partner API-instellingen: get_partner_setup, create_api_key, revoke_api_key en set_partner_events_url.
Dit is bewust zo ingericht. Een account dat niet kan zien waarom het is geblokkeerd of niet kan controleren of de nummers gezond zijn, heeft geen andere route terug dan een supportticket. Diezelfde leestools zijn ook nodig voor health monitoring. Ze blokkeren zou monitoring uitschakelen op het moment dat iemand die het hardst nodig heeft.
In de praktijk blijft een account met verlopen betaling vragen over de eigen status beantwoorden en wordt het nog steeds gemonitord. Alleen acties die een klant bereiken, stoppen.
Veelgemaakte fouten
- Verwachten dat de connector berichten ontvangt. MCP werkt met verzoeken en antwoorden; binnenkomend verkeer heeft een webhook nodig.
- Een connection_id hardcoderen. Deze komt uit list_numbers en is geen waarde om op te schrijven.
- Aannemen dat een account met verlopen betaling volledig offline is. Lezen en monitoring gaan bewust door, behalve de credentials, die het token bevatten waarmee wordt verstuurd.
Eén connector dekt elk nummer in een account, geautoriseerd via OAuth zonder sleutel om te plakken. Vanaf US$ 9 per nummer per maand, dalend tot US$ 0,75 naarmate je nummers toevoegt, met de eerste 3 dagen gratis.
Veelgestelde vragen
Kies ik zelf welke tool wordt aangeroepen?
Nee. Je vraagt het in gewone taal en de assistent kiest de tool. Daarvoor zijn de toolbeschrijvingen geschreven.
Kan de connector mijn gesprekken lezen?
Nee. Binnenkomende berichten gaan naar de webhookbestemming die je opgeeft. De connector leest de status van het account en de nummers.
Is get_docs nuttig?
Meer dan je zou denken. De tool geeft onze documentatie als markdown aan de assistent, zodat antwoorden over Coexistence-regels uit onze docs komen en niet uit het geheugen.
Dekt één connector meerdere klanten?
Ja. Eén account kan zoveel nummers bevatten als je nodig hebt en list_numbers geeft ze allemaal terug.
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 proefperiodeGeverifieerd op