WhatsApp Business Tools MCP

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

Pour les développeurs qui créent sur la plateforme WhatsApp Business (API Cloud) — le serveur MCP WhatsApp Business Tools permet à votre agent IA et à votre assistant IDE de gérer et 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 gérer des modèles de messages, de configurer des webhooks et d'envoyer des messages — en agissant comme vous, sur les applications et les entreprises que vous administrez.

Remarque : Le serveur MCP WhatsApp Business Tools est déployé progressivement et peut ne pas encore être disponible pour tout le monde. L'interface et l'ensemble des outils sont en version bêta et peuvent changer.

Vue d'ensemble

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

Attribut	Valeur
Nom du serveur	WhatsApp Business Tools
Transport	HTTP streamable
Point de terminaison	https://mcp.facebook.com/whatsapp_business_tools
Authentification	Connexion au compte développeur Meta (OAuth)
Statut	Bêta - l'interface et l'ensemble des outils peuvent changer

Prérequis

Le serveur agit sur vos propres ressources, donc avant qu'un agent puisse utiliser la plupart des outils, vous devez disposer de :

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

Si un prérequis manque, l'outil renvoie une erreur exploitable qui vous indique quoi corriger et fournit un lien vers la page où vous pouvez le corriger.

Configurer votre IDE ou votre client agent

Le serveur MCP WhatsApp Business Tools est un serveur distant. Les clients qui prennent en charge les serveurs MCP distants peuvent se connecter directement au point de terminaison. Pour les clients qui ne prennent en charge que les serveurs locaux (stdio), utilisez le pont mcp-remote, qui relaie le serveur distant via stdio.

Configurez votre client à l'aide de l'une des sections ci-dessous, puis terminez la connexion OAuth pour vous authentifier.

Claude Code et Desktop

Claude Code — exécutez la commande suivante pour ajouter le serveur :

claude mcp add --transport http whatsapp_business_tools https://mcp.facebook.com/whatsapp_business_tools

Ensuite, exécutez /mcp dans une session et sélectionnez whatsapp_business_tools pour vous authentifier.

Claude Desktop — ouvrez Paramètres > Connecteurs > Ajouter un connecteur personnalisé, puis définissez :

• Nom : WhatsApp Business Tools
• URL : https://mcp.facebook.com/whatsapp_business_tools

Application OpenAI Codex et ChatGPT

Application Codex — ouvrez Paramètres (l'icône d'engrenage, en bas à gauche) > Serveurs MCP > Ajouter des serveurs, choisissez HTTP streamable, puis définissez :

• Nom : WhatsApp Business Tools
• URL : https://mcp.facebook.com/whatsapp_business_tools
• Authentification : OAuth

Cliquez sur Authentifier et terminez la connexion OAuth.

ChatGPT — ouvrez Paramètres > Plugins > Parcourir les plugins, cliquez sur + en haut à droite pour ajouter un nouveau plugin, puis définissez :

• Nom : WhatsApp Business Tools
• URL : https://mcp.facebook.com/whatsapp_business_tools
• Authentification : OAuth

Enregistrez le plugin et terminez la connexion OAuth.

Connexion OAuth

Le serveur MCP WhatsApp Business Tools s'authentifie avec votre compte développeur Meta via OAuth, donc le même flux de connexion fonctionne avec chaque client.

Flux de connexion

Après avoir ajouté le serveur à votre client (voir Configurer votre IDE ou votre client agent) :

1. Démarrez la connexion. De nombreux clients commencent le flux OAuth automatiquement lorsque le serveur est ajouté. D'autres nécessitent de cliquer sur Connecter ou Authentifier d'abord.
2. Connectez-vous. Votre navigateur s'ouvre pour vous connecter avec votre compte Meta. S'il ne s'ouvre pas automatiquement, copiez le lien que votre client affiche et ouvrez-le manuellement.
3. Autorisez l'accès. Sur l'écran de consentement, sélectionnez les entreprises et les applications compatibles WhatsApp auxquelles vous souhaitez que le serveur accède.
4. Confirmez. Revenez à votre client et vérifiez votre connexion.

Vous devrez refaire le flux de connexion lorsque vous redémarrez le client.

Portées

Le serveur demande les autorisations suivantes lors du consentement :

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

Vous pouvez consulter ou révoquer l'accès à tout moment sur facebook.com > Paramètres > Intégrations professionnelles.

Vérifier votre connexion

Après avoir ajouté le serveur, confirmez que votre agent peut voir les outils :

1. Redémarrez l'IDE ou le client agent.
2. Demandez à l'agent de lister les outils qu'il possède depuis le serveur whatsapp_business_tools.
3. Exécutez un outil de lecture à faible risque. Par exemple, demandez-lui de lister les entreprises que vous administrez avec whatsapp_biz_businesses.

Si l'agent ne signale aucun outil ou une erreur d'authentification, revérifiez l'URL du point de terminaison et confirmez que vous avez terminé le flux de connexion.

Outils

Le MCP WhatsApp Business Tools expose des outils nommés avec le préfixe whatsapp_biz_. La plupart des outils sont limités à une entreprise que vous administrez, donc une session typique commence par lister vos entreprises et en choisir une. L'ensemble des outils évolue pendant la version bêta.

Découverte

• whatsapp_biz_businesses — Liste les entreprises que vous administrez et que vous avez accordées lors du consentement. Utilisez-le d'abord pour choisir une entreprise. Exemple : « Listez les entreprises que je peux gérer sur WhatsApp. »
• whatsapp_biz_accounts — Liste les comptes WhatsApp (et les comptes de messagerie) sous une entreprise. Exemple : « Affichez les comptes WhatsApp pour l'entreprise 1234567890. »
• whatsapp_biz_phone_numbers — Liste les numéros de téléphone sur une entreprise ou un compte WhatsApp, avec le statut et l'état d'intégration. Exemple : « Listez les numéros de téléphone et leur statut pour cette entreprise. »

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

• whatsapp_biz_add_phone_number — Ajoute un numéro de téléphone à un compte WhatsApp. Exemple : « Ajoutez le numéro de téléphone +1 555 010 1234 à mon compte WhatsApp. »
• whatsapp_biz_send_verification_code — Envoie un code de vérification à un numéro de téléphone. Exemple : « Envoyez un code de vérification par SMS à ce numéro. »
• whatsapp_biz_verify_phone_number — Vérifie un numéro de téléphone avec le code reçu. Exemple : « Vérifiez ce numéro avec le code 123456. »
• whatsapp_biz_register_phone_number — Enregistre un numéro vérifié pour qu'il puisse envoyer et recevoir. Exemple : « Enregistrez ce numéro pour la messagerie. »

Modèles de messages

• whatsapp_biz_list_templates / whatsapp_biz_get_template — Liste et inspecte les modèles de messages sur un compte. Exemple : « Listez les modèles approuvés pour ce compte. »
• whatsapp_biz_create_template / whatsapp_biz_update_template / whatsapp_biz_delete_template — Crée, met à jour et supprime des modèles de messages. Exemple : « Créez un modèle marketing nommé order_update en en_US. »

Messagerie

• whatsapp_biz_send_message — Envoie un message texte libre (uniquement livré dans la fenêtre de service client de 24 heures) ou un message de modèle approuvé depuis un numéro enregistré. Confirme la cible avec vous avant l'envoi. Exemple : « Envoyez le modèle order_update au +1 555 010 9999 depuis ce numéro. »

Webhooks

• whatsapp_biz_configure_webhooks — Définit l'URL de rappel et le jeton de vérification pour le sujet WhatsApp et s'abonne aux champs autorisés. Exemple : « Configurez les webhooks pour cette entreprise avec le rappel https://example.com/webhook."
• whatsapp_biz_subscribe_webhook — Abonne un compte WhatsApp aux webhooks de votre application afin que ses événements soient livrés. Exemple : « Abonnez ce compte WhatsApp aux webhooks. »

Configuration du compte

• whatsapp_biz_configure_payments — Configure une méthode de paiement pour que le compte puisse envoyer des messages facturables. Exemple : « Aidez-moi à configurer les paiements pour ce compte. »
• whatsapp_biz_verify_business — Vérifie et démarre la vérification de l'entreprise. Exemple : « Quel est le statut de vérification de l'entreprise, et comment le démarrer ? »
• whatsapp_biz_system_user_token — Obtient un lien pour générer un jeton d'accès utilisateur système pour votre entreprise, afin que vous puissiez créer une solution de messagerie personnalisée qui appelle directement l'API Cloud WhatsApp. La génération du jeton se fait en toute sécurité 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 <a href="/documentation/business-messaging/whatsapp/get-started#step-5-create-a-system-user-and-generate-a-permanent-access-token" target="_blank">Créer un utilisateur système et générer un jeton d'accès permanent</a>. Exemple : « Donnez-moi un lien pour créer un jeton d'accès utilisateur système pour cette entreprise. »

Limites de débit

Les requêtes sont limitées en débit par utilisateur et par outil pour protéger la plateforme. Si vous dépassez la limite, l'outil renvoie une erreur de limite de débit ; réessayez après une courte attente.

Retour d'information

Si vous avez des commentaires ou souhaitez voir plus d'outils, partagez vos commentaires.

Liens connexes

• Vue d'ensemble MCP
• Documentation de la plateforme WhatsApp Business

---

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