Référence des outils MCP
Le connecteur expose plus de 30 outils pour toutes les connexions d’un compte. list_numbers vient en premier pour WhatsApp, dont les outils utilisent son connection_id, et list_social_accounts pour les autres canaux, dont les outils utilisent un account_id. Six sont bloqués en cas d’impayé : les quatre outils WhatsApp qui agissent sur le monde extérieur, get_api_credentials, qui renvoie le jeton d’accès, et create_connect_link. Les autres restent accessibles.
Outils exposés par le connecteur.
Outils bloqués en cas d’impayé, dont get_api_credentials, qui renvoie le jeton d’accès.
Connexion OAuth couvrant tous les numéros du compte.
Que fait chaque outil ?
Lecture : list_numbers renvoie les numéros connectés avec leur statut, leur note de qualité et leur niveau de messagerie. C’est le point de départ de tous les autres appels. get_number_health renvoie un instantané Meta en direct ainsi que la chronologie récente de surveillance, les événements webhook et les contrôles du poller. get_api_credentials renvoie l’URL de base de la Graph API, le WABA id, le phone number id et, lorsqu’il est disponible, le token d’accès propre au compte.
Envoi : send_message envoie du texte libre dans la fenêtre de 24 heures, pendant laquelle les réponses sont gratuites. send_template envoie un template approuvé, ce qui permet de démarrer une conversation avec une personne qui n’a pas encore écrit. list_templates, create_template et get_template_status couvrent le cycle de vie du template.
Configuration : set_webhook_destination achemine les messages entrants et les échos de l’application vers votre système, et le passage de null le réinitialise. get_connect_link renvoie le lien du dashboard et les étapes pour connecter un nouveau numéro. get_docs renvoie la documentation du produit au format markdown.
Partner API, pour un logiciel ou une agence dont les propres clients connectent des numéros : get_partner_setup indique l’état de la facturation, de la clé API, de l’URL des événements et l’étape suivante. create_api_key émet la clé de la Partner API et ne l’affiche qu’une fois, sans remplacer une clé existante sans confirmation explicite. revoke_api_key la révoque, là aussi après confirmation. set_partner_events_url définit où partent les événements de statut et renvoie une seule fois le secret de signature. create_connect_link crée un lien de connexion hébergé pour un client, valable 1 heure, comme POST /api/v1/connect-sessions.
Pourquoi connection_id est-il important ?
Parce qu’il relie une instruction à un numéro précis, et qu’un assistant ne peut pas le deviner.
Chaque outil qui agit sur un numéro utilise un connection_id, et list_numbers est le seul endroit où en obtenir un. En pratique, un assistant à qui l’on demande d’envoyer un message appellera d’abord list_numbers. C’est pourquoi la première requête d’une session est souvent plus lente que les suivantes.
Cela signifie aussi qu’un compte comportant plusieurs numéros reste dépourvu d’ambiguïté par construction. Il n’existe ni numéro par défaut ni sélection implicite : une instruction qui n’identifie pas le numéro concerné déclenche une demande de précision, plutôt qu’une supposition.
Que se passe-t-il en cas d’impayé ?
Six outils sont bloqués : send_message, send_template, create_template et set_webhook_destination, qui agissent sur le monde extérieur ; get_api_credentials, parce qu’il renvoie le jeton d’accès du compte, avec lequel un compte bloqué pourrait envoyer directement via la Graph API ; et create_connect_link, qui connecte un nouveau numéro. Toutes les autres lectures restent accessibles, tout comme la configuration de la Partner API : get_partner_setup, create_api_key, revoke_api_key et set_partner_events_url.
C’est une décision délibérée, pas un oubli. Un compte qui ne peut pas comprendre pourquoi il est bloqué ou vérifier si ses numéros sont opérationnels n’a plus d’autre recours qu’une demande au support. Ces mêmes lectures alimentent aussi la surveillance de l’état, et les bloquer désactiverait cette surveillance au moment où elle est la plus nécessaire.
En pratique, un compte en impayé continue de répondre aux questions sur son propre état et reste surveillé. Seul s’arrête ce qui atteint un client.
Erreurs courantes
- S’attendre à ce que le connecteur reçoive des messages. MCP fonctionne par requêtes et réponses ; le trafic entrant nécessite un webhook.
- Coder en dur un connection_id. Il provient de list_numbers et ne doit pas être noté manuellement.
- Supposer qu’un compte en impayé est totalement hors ligne. Les lectures et la surveillance continuent volontairement, sauf les identifiants, qui contiennent le token d’envoi.
Un connecteur couvre tous les numéros d’un compte, autorisé via OAuth sans clé à copier. À partir de US$ 9 par numéro connecté et par mois, jusqu’à US$ 0,75 à mesure que vous ajoutez des numéros, avec les 3 premiers jours gratuits.
Questions fréquemment posées
Dois-je choisir l’outil à appeler ?
Non. Vous formulez votre demande en langage courant et l’assistant choisit l’outil, conformément à la fonction prévue pour ses descriptions.
Peut-il lire mes conversations ?
Non. Les messages entrants sont acheminés vers la destination webhook que vous indiquez. Le connecteur lit l’état du compte et des numéros.
get_docs est-il utile ?
Plus qu’il n’y paraît. Il transmet notre documentation à l’assistant au format markdown, afin que les réponses sur les règles de Coexistence proviennent de nos documents plutôt que de sa mémoire.
Un connecteur peut-il couvrir plusieurs clients ?
Oui. Un compte peut contenir autant de numéros que nécessaire et list_numbers les renvoie tous.
Poursuivre la lecture
Prêt à commencer ?
Configurez WhatsApp Coexistence en quelques minutes, pas en quelques mois. L’application continue de fonctionner sur le téléphone.
Commencer l'essai gratuitVérifié le