Referenz der MCP-Tools
Der Connector stellt mehr als 30 Tools für jede Verbindung eines Kontos bereit. list_numbers steht bei WhatsApp am Anfang, dessen Tools daraus eine connection_id übernehmen, und list_social_accounts bei den anderen Kanälen, deren Tools eine account_id übernehmen. Sechs werden bei ausbleibender Zahlung gesperrt: die vier WhatsApp-Tools, die auf die Außenwelt zugreifen, get_api_credentials, das den Zugriffstoken zurückgibt, und create_connect_link. Die übrigen bleiben offen.
Vom Connector bereitgestellte Tools.
Bei ausbleibender Zahlung gesperrte Tools, einschließlich get_api_credentials, das den Zugriffstoken zurückgibt.
OAuth-Anmeldung für jede Nummer des Kontos.
Was macht jedes Tool?
Lesen: list_numbers gibt die verbundenen Nummern mit Status, Qualitätsbewertung und Messaging-Stufe zurück. Hier beginnt jeder weitere Aufruf. get_number_health liefert gemeinsam eine aktuelle Meta-Aufnahme sowie die jüngste Monitoring-Zeitleiste, Webhook-Ereignisse und Poller-Prüfungen. get_api_credentials gibt die Graph API base URL, WABA id, phone number id und, falls verfügbar, das eigene access token des Kontos zurück.
Senden: send_message sendet freien Text innerhalb des 24-Stunden-Fensters, in dem Antworten kostenlos sind. send_template sendet ein genehmigtes Template. So beginnt eine Unterhaltung mit jemandem, der noch nicht geschrieben hat. list_templates, create_template und get_template_status decken den gesamten Template-Lebenszyklus ab.
Anbindung: set_webhook_destination leitet eingehende Nachrichten und App-Echos an Ihr System weiter. Die Übergabe von null setzt das Ziel zurück. get_connect_link gibt den Dashboard-Link und die Schritte zum Verbinden einer neuen Nummer zurück. get_docs liefert die Produktdokumentation als Markdown.
Partner API, für Software oder Agenturen, deren eigene Kunden Nummern verbinden: get_partner_setup zeigt den Stand von Abrechnung, API-Schlüssel, Event-URL und den nächsten Schritt. create_api_key stellt den Partner API-Schlüssel aus und zeigt ihn nur einmal an; einen vorhandenen Schlüssel ersetzt es nicht ohne ausdrückliche Bestätigung. revoke_api_key widerruft ihn, ebenfalls erst nach Bestätigung. set_partner_events_url legt fest, wohin Status-Events gehen, und gibt das Signatur-Secret einmal zurück. create_connect_link erstellt einen gehosteten Verbindungslink für einen Kunden, 1 Stunde gültig, genau wie POST /api/v1/connect-sessions.
Warum ist connection_id wichtig?
Weil sie eine Anweisung mit einer bestimmten Nummer verknüpft und ein Assistent sie nicht erraten kann.
Jedes Tool, das auf eine Nummer zugreift, benötigt eine connection_id. Nur list_numbers liefert sie. In der Praxis ruft ein Assistent, der zum Senden einer Nachricht aufgefordert wird, daher zuerst list_numbers auf. Deshalb ist die erste Anfrage einer Sitzung oft langsamer als die folgenden.
Dadurch bleibt auch ein Konto mit mehreren Nummern eindeutig. Es gibt keine Standardnummer und keine implizite Auswahl. Eine Anweisung, die keine Nummer nennt, führt daher zu einer Rückfrage statt zu einer Vermutung.
Was passiert bei ausbleibender Zahlung?
Sechs Tools werden gesperrt: send_message, send_template, create_template und set_webhook_destination, die auf die Außenwelt zugreifen; get_api_credentials, weil es den Zugriffstoken des Kontos zurückgibt, mit dem ein gesperrtes Konto direkt über die Graph API senden könnte; und create_connect_link, das eine neue Nummer verbindet. Jeder andere Lesezugriff bleibt verfügbar, ebenso die Einrichtung der Partner API: get_partner_setup, create_api_key, revoke_api_key und set_partner_events_url.
Das ist beabsichtigt und kein Versehen. Ein Konto, das nicht sehen kann, warum es gesperrt ist, oder den Zustand seiner Nummern nicht prüfen kann, hat keinen Weg zurück außer über eine Support-Anfrage. Genau diese Lesezugriffe benötigt auch das Gesundheitsmonitoring. Würden sie gesperrt, fiele es gerade dann aus, wenn es am dringendsten gebraucht wird.
Praktisch beantwortet ein Konto mit ausbleibender Zahlung weiterhin Fragen zu seinem eigenen Zustand und wird weiterhin überwacht. Gestoppt wird nur, was einen Kunden erreicht.
Häufige Fehler
- Zu erwarten, dass der Connector Nachrichten empfängt. MCP arbeitet mit Anfrage und Antwort; eingehender Datenverkehr benötigt einen Webhook.
- Eine connection_id fest zu hinterlegen. Sie stammt aus list_numbers und ist kein Wert zum Aufschreiben.
- Anzunehmen, dass ein Konto mit ausbleibender Zahlung vollständig offline ist. Lesezugriffe und Monitoring laufen absichtlich weiter, außer den Zugangsdaten, die das Token zum Senden enthalten.
Ein Connector deckt jede Nummer eines Kontos ab. Die Autorisierung erfolgt über OAuth, ohne dass Sie einen Schlüssel einfügen müssen. Ab US$ 9 pro Nummer und Monat, mit jeder weiteren Nummer bis auf US$ 0,75 sinkend, mit 3 kostenlosen Tagen zum Start.
Häufig gestellte Fragen
Wähle ich selbst, welches Tool aufgerufen wird?
Nein. Sie fragen in natürlicher Sprache, und der Assistent wählt das passende Tool. Dafür sind die Tool-Beschreibungen geschrieben.
Kann der Connector meine Unterhaltungen lesen?
Nein. Eingehende Nachrichten werden an das von Ihnen angegebene Webhook-Ziel geleitet. Der Connector liest den Zustand des Kontos und der Nummern.
Ist get_docs nützlich?
Mehr, als es zunächst klingt. Das Tool übergibt dem Assistenten unsere Dokumentation als Markdown. Antworten zu Coexistence-Regeln stammen dadurch aus unseren Dokumenten und nicht aus dem Gedächtnis.
Deckt ein Connector mehrere Kunden ab?
Ja. Ein Konto kann so viele Nummern enthalten, wie Sie benötigen, und list_numbers gibt sie alle zurück.
Weiterlesen
Bereit für den Start?
Richten Sie WhatsApp Coexistence in wenigen Minuten statt Monaten ein. Die App funktioniert weiterhin auf dem Telefon.
Kostenlose Testphase startenVerifiziert am