MCP-toolsreferentie

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.

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?

De vier tools die op de buitenwereld werken, worden geblokkeerd: send_message, send_template, create_template en set_webhook_destination. Alles wat leest, blijft beschikbaar.

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.

Veelgestelde vragen

Lees verder