WhatsApp Business Tools MCP

npx add-mcp 'https://mcp.facebook.com/whatsapp_business_tools'

Outils MCP WhatsApp Business

Pour les développeurs qui créent des solutions sur la plateforme WhatsApp Business (Cloud API), le serveur WhatsApp Business Tools MCP permet à votre agent IA et à votre assistant IDE de gérer et de déboguer votre intégration WhatsApp Business depuis un seul endroit. Il permet à un agent de découvrir les entreprises et les comptes WhatsApp que vous administrez, d’intégrer et d’enregistrer des numéros de téléphone, de créer et de gérer des modèles de message, de configurer des webhooks et d’envoyer des messages — en agissant en votre nom sur les applications et les entreprises que vous administrez.

Remarque : Remarque : L’interface et l’ensemble d’outils du serveur WhatsApp Business Tools MCP sont en version bêta et peuvent changer.

Présentation

Le tableau suivant récapitule les détails du serveur :

Attribut	Valeur
Nom du serveur	WhatsApp Business Tools
Transport	HTTP avec flux continu
Point de terminaison	https://mcp.facebook.com/whatsapp_business_tools
Authentification	Connexion au compte développeur Meta (OAuth)
ID client	Non requis. Le serveur reconnaît automatiquement les clients pris en charge.
URI de redirection	Non requis. Vous n’avez pas à créer ni à configurer d’application Meta pour ce serveur.
Clients pris en charge	Claude Code, Claude Desktop, ChatGPT, Codex CLI, application Codex
État	Bêta - l’interface et l’ensemble d’outils peuvent changer

Avant de commencer

Pour connecter un client, vous avez besoin de l’un des clients pris en charge répertoriés ci-dessus, dans une version récente.

Le déploiement du serveur est progressif. Il se peut donc qu’il ne soit pas encore disponible pour votre compte, même après la connexion de votre client.

Le serveur agit sur vos propres ressources. Avant qu’un agent puisse utiliser la plupart des outils, vous devez également disposer des éléments suivants :

• Un accès administrateur à une entreprise que vous souhaitez gérer (rôle MANAGE).
• Une application compatible avec WhatsApp dont vous êtes administrateur, connectée à cette entreprise — une application utilisant le cas d’utilisation WhatsApp Business Messaging (ou le produit WhatsApp dans une ancienne application). Vous devez disposer d’un accès administrateur à l’application, et pas seulement à l’entreprise.
• Les conditions d’utilisation de WhatsApp Business Cloud API acceptées pour cette entreprise. L’envoi de messages et l’enregistrement de numéros de téléphone sont bloqués tant qu’un administrateur ne les a pas acceptées.

Si un prérequis manque, l’outil renvoie une erreur exploitable qui vous indique ce qu’il faut corriger et fournit un lien vers la page où vous pouvez le faire.

Connecter votre client

Pour connecter un client pris en charge et terminer l’autorisation OAuth, suivez les instructions de Connexion d’un client MCP à Meta. Utilisez le nom du serveur et son point de terminaison indiqués dans la Présentation. Ce serveur ne nécessite pas d’ID client ; utilisez donc l’inscription automatique.

Autorisations

Le serveur demande les autorisations suivantes lors du consentement :

Autorisation	Accès
business_management	Découvrir les entreprises que vous administrez et que vous avez sélectionnées lors du consentement, et agir sur celles-ci.
whatsapp_business_management	Gérer les comptes WhatsApp Business, les numéros de téléphone, les modèles de message et les webhooks.
whatsapp_business_messaging	Envoyer des messages depuis vos numéros de téléphone enregistrés.

Vous pouvez consulter ces autorisations et révoquer l’accès sur Facebook, sous Paramètres > Votre activité > Intégrations professionnelles.

Vérifier votre connexion

Demandez à l’agent de répertorier les outils dont il dispose sur ce serveur, en utilisant le nom que vous lui avez attribué lors de la connexion. Exécutez ensuite un outil en lecture seule, tel que whatsapp_biz_businesses, pour répertorier les entreprises que vous administrez. La connexion fonctionne si cet appel renvoie vos entreprises plutôt qu’une erreur d’authentification ou d’autorisation.

Limites de débit

Les requêtes sont soumises à des limites de débit par utilisateur et par outil afin de protéger la plateforme. Si vous dépassez la limite, l’outil renvoie une erreur de limitation de débit ; réessayez après un court délai.

Outils

Le serveur WhatsApp Business Tools MCP expose des outils dont les noms sont préfixés par whatsapp_biz_. La plupart des outils sont associés à une entreprise que vous administrez ; une session type commence donc par répertorier vos entreprises et en sélectionner une. L’ensemble d’outils évolue pendant la bêta.

Découverte

• whatsapp_biz_businesses — Répertorier les entreprises que vous administrez et que vous avez autorisées lors du consentement. Utilisez cet outil en premier pour choisir une entreprise. Exemple : "Répertorie les entreprises WhatsApp que je peux gérer."
• whatsapp_biz_accounts — Répertorier les comptes WhatsApp (et les comptes de messagerie) associés à une entreprise. Exemple : "Affiche les comptes WhatsApp de l’entreprise 1234567890."
• whatsapp_biz_phone_numbers — Répertorier les numéros de téléphone d’une entreprise ou d’un compte WhatsApp, avec leur état et leur état d’intégration. Exemple : "Répertorie les numéros de téléphone de cette entreprise et leur état."

Intégration des numéros de téléphone

• whatsapp_biz_add_phone_number — Ajouter un numéro de téléphone à un compte WhatsApp. Exemple : "Ajoute le numéro de téléphone +1 555 010 1234 à mon compte WhatsApp."
• whatsapp_biz_send_verification_code — Envoyer un code de vérification à un numéro de téléphone. Exemple : "Envoie un code de vérification par SMS à ce numéro."
• whatsapp_biz_verify_phone_number — Vérifier un numéro de téléphone à l’aide du code reçu. Exemple : "Vérifie ce numéro avec le code 123456."
• whatsapp_biz_register_phone_number — Enregistrer un numéro vérifié pour qu’il puisse envoyer et recevoir des messages. Exemple : "Enregistre ce numéro pour la messagerie."

Modèles de message

• whatsapp_biz_list_templates / whatsapp_biz_get_template — Répertorier et examiner les modèles de message d’un compte. Exemple : "Répertorie les modèles approuvés pour ce compte."
• whatsapp_biz_create_template / whatsapp_biz_update_template / whatsapp_biz_delete_template — Créer, modifier et supprimer des modèles de message. Exemple : "Crée un modèle marketing nommé order_update en en_US."

Messagerie

• whatsapp_biz_send_message — Envoyer un texte libre (livré uniquement pendant la fenêtre de service client de 24 heures) ou un modèle de message approuvé depuis un numéro enregistré. Vous confirme la cible avant l’envoi. Exemple : "Envoie le modèle order_update à +1 555 010 9999 depuis ce numéro."

Webhooks

• whatsapp_biz_configure_webhooks — Définir l’URL de rappel et le jeton de vérification pour le sujet WhatsApp, puis s’abonner aux champs autorisés. Exemple : "Configure les webhooks de cette entreprise avec l’URL de rappel https://example.com/webhook."
• whatsapp_biz_subscribe_webhook — Abonner un compte WhatsApp aux webhooks de votre application afin que ses événements soient transmis. Exemple : "Abonne ce compte WhatsApp aux webhooks."

Configuration du compte

• whatsapp_biz_configure_payments — Configurer un moyen de paiement pour que le compte puisse envoyer des messages facturables. Exemple : "Aide-moi à configurer les paiements pour ce compte."
• whatsapp_biz_verify_business — Vérifier l’état de la vérification de l’entreprise et la démarrer. Exemple : "Quel est l’état de la vérification de l’entreprise et comment la démarrer ?"
• whatsapp_biz_system_user_token — Obtenir un lien pour générer un jeton d’accès d’utilisateur système pour votre entreprise, afin de créer une solution de messagerie personnalisée qui appelle directement WhatsApp Cloud API. La génération du jeton s’effectue de manière sécurisée dans les paramètres de l’entreprise : l’outil renvoie un lien profond vers la page Utilisateurs système, où vous sélectionnez un utilisateur système et générez le jeton. Pour en savoir plus, consultez Créer un utilisateur système et générer un jeton d’accès permanent. Exemple : "Donne-moi un lien pour créer un jeton d’accès d’utilisateur système pour cette entreprise."

Commentaires

Si vous avez des commentaires ou souhaitez voir davantage d’outils, faites-nous part de vos commentaires.

Articles associés

• Présentation de MCP
• Connexion d’un client MCP à Meta
• Documentation de la plateforme WhatsApp Business

---

Index complet de la documentation de ce produit : https://developers.facebook.com/documentation/mcp/llms.txt