WhatsApp Business MCP : connecter un agent IA

Le 15 septembre 2026, Meta a publié le serveur MCP officiel WhatsApp Business Tools. Il connecte un agent IA — Claude Code, Codex, ChatGPT ou Cursor — à la WhatsApp Business Platform. Au lieu de passer de la Developer Console au Business Manager, puis à la documentation de l’API, vous décrivez la tâche à l’agent. Il ajoute un numéro, crée un modèle de message, configure les webhooks et envoie un message de test.

Le serveur est encore en version bêta : l’accès est déployé progressivement et cette version est destinée au développement et aux tests, et non à l’envoi de messages en production à grande échelle. Vous trouverez ci-dessous les préparatifs et les étapes de connexion pour quatre clients. Les commandes et les paramètres ont été vérifiés à partir de la documentation officielle de Meta le 18 septembre 2026.

Les informations sur l’utilisation d’Ailoot sont disponibles dans la documentation.

Qu’est-ce que WhatsApp Business Tools MCP ?#

MCP (Model Context Protocol) est une norme ouverte qui permet de connecter des systèmes externes à des agents IA. Pour en savoir plus, consultez l’article Serveurs MCP pour Claude Code : 7 intégrations prêtes à l’emploi. Les connexions vérifiées avec leurs commandes d’installation figurent dans le catalogue MCP.

Avant cette publication, la configuration d’une intégration WhatsApp ressemblait à ceci : ouvrir la Developer Console, créer une application, associer une entreprise, ajouter un numéro de téléphone, le vérifier avec un code, générer un jeton, configurer un webhook, consulter la documentation de l’API — et seulement ensuite écrire la première ligne de code.

Meta décrit ainsi l’idée derrière le serveur (traduit de l’anglais) :

Meta propose désormais deux serveurs MCP, qu’il est facile de confondre. Meta Social Technologies MCP est un outil généraliste pour les développeurs : il permet de rechercher dans la documentation, de trouver des points de terminaison Graph API et de diagnostiquer les erreurs d’application. WhatsApp Business Tools MCP sert à gérer les comptes WhatsApp, les numéros de téléphone, les modèles, les webhooks et les messages de test. Ils sont complémentaires, et vous pouvez connecter les deux si nécessaire.

Que peut faire exactement l’agent après la connexion ?#

Les outils du serveur sont regroupés sous le préfixe whatsapp_biz_. Selon la documentation officielle :

• Vue d’ensemble : whatsapp_biz_businesses, whatsapp_biz_accounts, whatsapp_biz_phone_numbers — les entreprises, les comptes et les numéros de téléphone auxquels vous avez accès.
• Configuration du numéro de téléphone : whatsapp_biz_add_phone_number, whatsapp_biz_send_verification_code, whatsapp_biz_verify_phone_number, whatsapp_biz_register_phone_number.
• Modèles : whatsapp_biz_list_templates, whatsapp_biz_get_template, whatsapp_biz_create_template, whatsapp_biz_update_template, whatsapp_biz_delete_template.
• Messages : whatsapp_biz_send_message — texte libre pendant la fenêtre de conversation de 24 heures ou modèle approuvé en dehors de cette fenêtre ; l’agent confirme le destinataire avec vous avant l’envoi.
• Webhooks : whatsapp_biz_configure_webhooks, whatsapp_biz_subscribe_webhook.
• Configuration du compte : whatsapp_biz_configure_payments, whatsapp_biz_verify_business, whatsapp_biz_system_user_token — un lien permettant de créer un jeton d’utilisateur système pour les appels directs à Cloud API.

Lorsqu’un client écrit en premier à l’entreprise, une fenêtre de service client s’ouvre : vous pouvez répondre en texte libre pendant 24 heures. Chaque nouveau message du client prolonge cette fenêtre. Une fois celle-ci fermée, vous ne pouvez contacter le client qu’avec un modèle approuvé. L’agent connaît cette règle et, si le destinataire se trouve hors de la fenêtre, il suggère d’envoyer un modèle plutôt qu’un texte ordinaire.

Le serveur intègre des contrôles d’accès. Vous vous connectez avec votre compte Meta et sélectionnez des entreprises précises ; les jetons ne figurent pas dans l’historique des conversations. Chaque lecture est effectuée dans votre contexte, les appels sont consignés et les actions qui apportent des modifications exigent une personne authentifiée ; une clé d’application du serveur ne suffit pas à elle seule.

Que faut-il vérifier avant de se connecter ?#

Le serveur agit en votre nom et n’utilise que vos ressources. Avant le premier appel, vérifiez donc les éléments suivants :

1. Vous disposez d’une entreprise Meta dont vous êtes administrateur (rôle MANAGE).
2. Vous disposez d’une application Meta où le scénario WhatsApp Business Messaging est activé (ou du produit WhatsApp dans les anciennes applications), et vous êtes administrateur de cette application précisément ; les autorisations au niveau de l’entreprise ne suffisent pas.
3. Les conditions de la WhatsApp Business Cloud API ont été acceptées pour l’entreprise — sans cela, l’enregistrement de numéros de téléphone et l’envoi sont bloqués.

Selon Meta, des problèmes liés aux conditions d’utilisation, aux moyens de paiement et à la vérification de l’entreprise surviennent souvent sans explication claire. L’agent les vérifie à l’avance et fournit un lien direct pour accepter les conditions, indiquer un moyen de paiement ou lancer la vérification de l’entreprise.

Comment connecter le serveur à Claude Code ?#

Si Claude Code n’est pas encore installé, commencez par le guide Comment installer Claude Code depuis le site officiel.

1. Ajouter le serveur

   Dans le terminal, exécutez :

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

   Le serveur est distant, vous n’avez donc pas besoin de l’installer localement.

2. Se connecter via Meta

   Dans une session Claude Code, saisissez /mcp et sélectionnez whatsapp_business_tools. Une fenêtre de navigateur s’ouvrira pour vous connecter à votre compte Meta. Si le navigateur ne s’ouvre pas, copiez le lien affiché par le client et ouvrez-le manuellement.

3. Accorder les autorisations

   Sur l’écran de consentement, sélectionnez les entreprises et les applications avec WhatsApp auxquelles vous autorisez l’accès. Le serveur demandera trois autorisations : business_management (trouver les entreprises dont vous êtes administrateur), whatsapp_business_management (comptes, numéros de téléphone, modèles, webhooks) et whatsapp_business_messaging (envoyer des messages depuis vos numéros).

4. Vérifier la connexion

   Redémarrez Claude Code, reconnectez-vous via /mcp, puis demandez à l’agent quels outils il voit sur le serveur whatsapp_business_tools. Effectuez ensuite une lecture sans risque : « Liste les entreprises que je peux gérer » — l’agent appellera whatsapp_biz_businesses. Si aucun outil n’apparaît ou si vous obtenez une erreur de connexion, vérifiez l’adresse du serveur et reconnectez-vous.

La connexion OAuth est liée au lancement du client : après avoir redémarré Claude Code, vous devez vous reconnecter. Vous pouvez révoquer l’accès à tout moment dans les paramètres de facebook.com, sous « Business Integrations ».

Comment connecter Codex, ChatGPT et Claude Desktop ?#

Codex App. Ouvrez les paramètres (l’engrenage en bas à gauche), accédez à MCP Servers et sélectionnez Add servers. Choisissez Streamable HTTP et saisissez :

• Name : WhatsApp Business Tools
• URL : https://mcp.facebook.com/whatsapp_business_tools
• Authentication : OAuth

Cliquez sur Authenticate et connectez-vous dans le navigateur.

ChatGPT. Settings, Plugins, Browse plugins, puis l’icône « + » dans le coin supérieur droit. Saisissez un nom, la même URL et OAuth comme type d’authentification.

Claude Desktop. Settings, Connectors, Add custom connector. Name : WhatsApp Business Tools ; URL : la même adresse de serveur.

Après l’ajout dans n’importe quel client, suivez la même séquence de vérification : redémarrez, reconnectez-vous, affichez la liste des outils et consultez sans risque la liste des entreprises.

Que se passe-t-il lors de la première session : de la liste des entreprises au message de test ?#

Une première session type avec le serveur connecté :

1. « Liste les entreprises que je gère » — l’agent appelle whatsapp_biz_businesses et vous choisissez celle dont vous avez besoin.
2. « Montre-moi les comptes WhatsApp et les numéros de téléphone de cette entreprise » — whatsapp_biz_accounts et whatsapp_biz_phone_numbers, avec leurs statuts.
3. « Ajoute mon numéro de test au compte » — whatsapp_biz_add_phone_number.
4. « Envoie un code de vérification par SMS » — whatsapp_biz_send_verification_code. Le code arrive sur votre téléphone.
5. « Vérifie le numéro avec le code 123456 » — whatsapp_biz_verify_phone_number, puis enregistrez-le avec whatsapp_biz_register_phone_number.
6. « Crée un modèle order_update dans la langue préférée des destinataires pour les notifications de commande » — whatsapp_biz_create_template ; l’agent fournira un lien vers son statut d’approbation.
7. « Envoie un message de test à mon numéro » — whatsapp_biz_send_message ; l’agent confirmera le destinataire avant l’envoi.
8. « Configure un webhook à l’adresse https://example.com/webhook » — whatsapp_biz_configure_webhooks, puis abonnez-vous à l’aide de whatsapp_biz_subscribe_webhook.

Ensuite, les messages entrants des clients arriveront à l’adresse indiquée — généralement, un CRM, un service client ou un bot les récupère à cet endroit. Vous configurez séparément le traitement à cette adresse ; le serveur ne s’occupe que de la configuration.

Quelles sont les limites de la version bêta ?#

Le serveur présente quatre limites à garder à l’esprit.

Version bêta. Meta indique que l’interface et l’ensemble des outils peuvent changer, et que l’accès est déployé progressivement. Si vous ne pouvez pas encore vous connecter au serveur, c’est peut-être qu’il ne vous a pas encore été rendu accessible.

Usage prévu. Cette version est destinée au développement et aux tests ; elle n’est pas conçue pour l’envoi massif en production. Pour envoyer des messages en production, vous aurez besoin d’une intégration complète avec Cloud API — par exemple, en utilisant un jeton d’utilisateur système, dont le lien est fourni par l’outil whatsapp_biz_system_user_token.

Limites. Chaque outil est soumis à des limites de requêtes par utilisateur. Si vous dépassez la limite, l’outil renvoie une erreur de limite — attendez, puis réessayez.

Règle de la fenêtre de 24 heures. En dehors de la fenêtre de conversation avec le client, vous ne pouvez envoyer que des modèles approuvés.

Pourquoi est-ce important pour une entreprise ?#

Voici un scénario typique pour une petite entreprise : les clients écrivent sur WhatsApp, et vous voulez leur répondre rapidement et envoyer des notifications sur le statut des commandes. Auparavant, la configuration initiale impliquait de travailler seul dans plusieurs tableaux de bord Meta ou d’embaucher un développeur. Désormais, vous pouvez effectuer cette partie dans une conversation avec un agent. Vous configurez toujours séparément le traitement des messages entrants à votre propre adresse — c’est l’étape suivante après la configuration du webhook.

Le serveur est également utile si votre intégration est déjà opérationnelle. Les modèles de message doivent être mis à jour régulièrement : une nouvelle promotion, un nouveau texte de notification. Avec le serveur, l’agent crée ou modifie un modèle et en affiche le statut d’approbation sans vous renvoyer au tableau de bord.

Une approche similaire — un agent qui se connecte à un système externe et travaille avec lui selon votre description — est illustrée par la documentation du guide Comment connecter NotebookLM à Claude Code avec MCP.

Et ensuite ?#

Trois jours se sont écoulés depuis l’annonce du serveur. Vous pouvez commencer par une seule commande et vous connecter via Meta, puis demander à l’agent la liste de vos entreprises. Ensuite, selon vos besoins : numéros de téléphone, modèles, webhooks, messages de test.

Découvrez d’autres façons de connecter un agent à des systèmes externes dans la collection de serveurs MCP pour Claude Code : elle comprend sept autres intégrations opérationnelles pour différentes tâches.

Découvrez Ailoot.