Référence des outils MCP
Le connecteur expose onze outils pour tous les numéros d’un compte. list_numbers vient en premier, car tous les autres outils utilisent un connection_id fourni par celui-ci. Quatre agissent sur le monde extérieur et sont bloqués en cas d’impayé ; les sept autres effectuent des lectures et restent accessibles.
Outils exposés par le connecteur.
Outils bloqués en cas d’impayé. Toutes les lectures restent accessibles.
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.
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é ?
Les quatre outils qui agissent sur le monde extérieur sont bloqués : send_message, send_template, create_template et set_webhook_destination. Tout ce qui effectue des lectures reste accessible.
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.
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$ 2 en volume, avec les 7 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