Connecter Claude à WhatsApp avec whatsapp-mcp-go

Vous tenez entre vos mains un guide complet pour transformer votre compte WhatsApp en outil de productivité, alimenté par l’intelligence artificielle de Claude. Aujourd’hui, le 24 février 2026, whatsapp-mcp-go devient votre allié pour automatiser, analyser et enrichir vos échanges, mais à une condition : disposer d’une préparation technique irréprochable. Sans cela, même le meilleur script Python ou la meilleure API restera lettre morte. Nous allons aborder cette phase avec la même rigueur qu’un mécanicien assemble un moteur, en choisissant les bons outils et en suivant une méthode claire.

Les conversations WhatsApp sont devenues un canal stratégique : avec chaque client, collègue ou partenaire, vous échangez des informations qui pourraient être analysées, enrichies et automatisées par une IA de pointe. C’est précisément ce que permet whatsapp-mcp-go, un outil open source qui connecte WhatsApp à Claude, l’un des modèles d’IA les plus performants du marché. Avant d’aborder le code et les fichiers de configuration, une étape s’impose : préparer votre environnement pour une intégration fluide et sécurisée. Sans cette phase, même l’architecture la mieux pensée finira par se gripper. Voici comment poser des bases solides dès le départ.

Préparer la connexion entre WhatsApp et Claude

L’intégration de WhatsApp avec Claude via whatsapp-mcp-go repose sur trois piliers : une vision claire des bénéfices, une vérification rigoureuse des prérequis techniques et une collecte méthodique des bons outils. En négliger un seul, et c’est l’ensemble du projet qui se fragilise. Prenons les choses dans l’ordre, comme on documente un déploiement en production.

Comprendre les bénéfices de l’intégration

Pourquoi connecter WhatsApp à Claude ? L’enjeu se résume en trois notions : efficacité opérationnelle, automatisation à grande échelle et maîtrise des données. Avec ses 2,4 milliards d’utilisateurs actifs mensuels (chiffres Meta 2025), WhatsApp s’est imposé comme canal de communication privilégié pour entreprises, associations et administrations. Ses fonctions natives restent toutefois limitées : pas de traitement automatique des requêtes, peu d’analyse sémantique et une gestion des conversations qui repose encore largement sur l’humain.

C’est là qu’intervient Claude. Grâce à des modèles de langage avancés comme Claude 3.5 Sonnet (octobre 2025), l’IA peut :

• Analyser en temps réel le ton, l’intention et les besoins d’un interlocuteur dans une conversation WhatsApp (par exemple détecter une demande urgente ou un client mécontent).
• Automatiser les réponses usuelles pour les requêtes récurrentes (FAQ, confirmations de rendez-vous, suivi de commandes), libérant jusqu’à 40 % du temps des équipes (étude McKinsey, 2025).
• Enrichir les données clients en extrayant les informations clés (dates, noms, montants) et en les injectant dans vos outils métiers (CRM, ERP, bases internes).
• Assurer une traçabilité complète des échanges, avec historique, tags et alertes personnalisables, un avantage net pour la conformité RGPD.

« L’automatisation de WhatsApp devient un levier central pour rester compétitif. »
Jean‑Marc Lasry, PDG de Bpifrance, Forum IA & Entreprise 2025

Concrètement, cette intégration produit des résultats mesurables :

• Réduction des coûts support : jusqu’à 30 % d’économie sur la gestion des demandes clients (source : Gartner, 2025).
• Amélioration du temps de réponse : temps de prise en charge divisé par deux, avec une satisfaction client en hausse de 25 % en moyenne (enquête Satisfy, 2025).
• Capacité de montée en charge : gestion de dix fois plus de conversations sans recruter, grâce à l’automatisation.

Ces gains ne sont pas automatiques : ils supposent une préparation technique rigoureuse, sans quoi le projet peut se heurter dès les premiers tests à des limites techniques ou réglementaires.

Vérifier les prérequis techniques

Avant de télécharger whatsapp-mcp-go ou de paramétrer Claude, passez au crible votre environnement. Ce contrôle préalable évite des heures de débogage plus tard. Voici la checklist minimale pour partir sur des bases saines.

1. Compatibilité avec WhatsApp Business API

WhatsApp Business API est le socle de cette intégration. Sans elle, impossible d’accéder aux messages de manière programmatique. Deux options existent :

1. Utiliser un compte WhatsApp Business officiel (recommandé pour les organisations).
   • Votre entreprise doit être enregistrée auprès de Meta via le Business Verification Program (coût indicatif : 25 € à 500 € par mois selon le volume).
   • Vous devez disposer d’un numéro de téléphone dédié (pas de ligne personnelle) et d’une adresse email professionnelle.
   • Le processus de vérification prend généralement 2 à 5 jours ouvrés (délai constaté en 2025).
2. Passer par un fournisseur de solutions tierces (par exemple Twilio, MessageBird, 360dialog).
   • Ces plateformes servent d’intermédiaires officiels entre vous et Meta, simplifiant la mise en place.
   • Coût : 0,005 € à 0,01 € par message (tarifs 2025), avec des frais mensuels de 50 € à 200 € selon le volume.
   • Exemple : Twilio propose un sandbox gratuit pour tester l’API avant tout engagement.

« Une grande partie des échecs d’intégration vient d’une sous‑estimation des contraintes de WhatsApp Business API. »
Raphaël Bensoussan, responsable produit Twilio France

2. Environnement de développement adapté

whatsapp-mcp-go est un outil open source écrit en Go, un langage pensé pour la performance et la simplicité. Pour l’exécuter dans de bonnes conditions, prévoyez :

• Un système d’exploitation compatible :
  • Linux (recommandé : Ubuntu 22.04 LTS ou Debian 12).
  • macOS (version 13 « Ventura » ou supérieure).
  • Windows via WSL 2 (Windows Subsystem for Linux) pour une compatibilité confortable.
• Go 1.21 ou supérieur, téléchargeable sur golang.org. Vérifiez la version avec : go version
• Git (pour cloner le dépôt) et Docker (optionnel mais recommandé pour isoler l’environnement).
  • Sous Linux : sudo apt-get install git docker.io
  • Sous macOS : brew install git docker
• Un éditeur de code adapté : VS Code (avec extensions Go et Docker), GoLand ou Sublime Text.

Sécurité : installez whatsapp-mcp-go dans un environnement isolé (machine virtuelle ou conteneur Docker) plutôt que sur un poste partagé. Cela limite les risques de fuite de données ou de compromission. Évitez d’exécuter le code en tant que super‑utilisateur avant d’avoir vérifié les permissions.

3. Accès à l’API de Claude

Pour que Claude traite vos messages WhatsApp, vous devez :

• Disposer d’une clé API valide pour Claude.
  • Si vous utilisez Claude.ai, créez un compte sur anthropic.com et générez votre clé dans la section API Access.
  • Si vous passez par un hébergeur (par exemple AWS Bedrock ou Google Vertex AI), suivez leur procédure d’émission de clés.
• Vérifier vos quotas d’utilisation :
  • Le plan gratuit de Claude.ai limite à environ 10 000 tokens par mois, soit près de 5 000 messages courts.
  • Pour un usage professionnel, anticipez un budget de 0,008 € à 0,03 € pour 1 000 tokens (tarifs 2026).
• Configurer les règles de sécurité côté API :
  • Restreignez l’accès à votre clé via des adresses IP autorisées ou des domaines précis.
  • Activez la journalisation des appels API pour tracer les usages et repérer d’éventuels abus.

Astuce : testez votre clé API avec un outil comme Postman ou cURL avant de l’intégrer à whatsapp-mcp-go. Envoyez par exemple :

curl https://api.anthropic.com/v1/messages -H "Content-Type: application/json" -H "x-api-key: VOTRE_CLE_API" -d '{"model": "claude-3-5-sonnet", "max_tokens": 100, "messages": [{"role": "user", "content": "Bonjour, test de l'API."}]}'

Si la réponse contient un message généré par Claude, votre clé est opérationnelle.

4. Stockage et bases de données

Les conversations WhatsApp traitées par Claude manipulent souvent des données personnelles sensibles (coordonnées, historique, préférences). Leur gestion doit respecter :

• Le cadre RGPD :
  • Les données personnelles doivent être anonymisées ou chiffrées dès lors qu’elles sont stockées.
  • Les utilisateurs doivent être informés via une politique de confidentialité claire, exigée par WhatsApp Business API.
• Un système de stockage adapté :
  • Pour de petits volumes : un fichier JSON ou CSV local peut suffire, mais reste peu scalable.
  • Pour un projet sérieux : optez pour une base de données relationnelle (PostgreSQL, MySQL) ou NoSQL (MongoDB) hébergée dans le cloud (AWS RDS, Google Cloud SQL).
  • Exemple de schéma pour une base PostgreSQL :

Sécurité : si vous stockez des données clients, chiffrez-les au repos et en transit. Utilisez TLS 1.3 pour les communications et un chiffrement robuste comme AES‑256 côté stockage. Évitez absolument de conserver vos clés API en clair dans le code : passez par des variables d’environnement ou un gestionnaire de secrets comme Vault ou AWS Secrets Manager.

Rassembler le matériel et les outils nécessaires

Une fois le socle technique validé, reste à préparer la partie logistique. Quelques choix matériels et logiciels bien pensés évitent la plupart des blocages en cours de route. L’objectif : disposer d’un environnement de travail stable et reproductible, aussi bien pour les tests que pour la production.

1. Matériel informatique

Les besoins en puissance dépendent directement du volume de messages. Voici des repères pour dimensionner votre infrastructure :

Pourquoi ajouter un GPU ? Les modèles de langage utilisés par Claude tirent fortement parti de l’accélération matérielle. Sans GPU, les temps de réponse peuvent être multipliés par deux sur des conversations longues ou complexes, ce qui peut dégrader l’expérience utilisateur.

2. Outils logiciels

En complément des prérequis techniques déjà cités, ces outils simplifieront nettement la mise en place et l’exploitation quotidienne :

• Docker Desktop pour containeriser whatsapp-mcp-go et éviter les conflits de dépendances.
  • Téléchargement sur docker.com. La version gratuite suffit largement pour des tests et un premier déploiement.
  • Commande type pour lancer un conteneur : docker run -d --name whatsapp-mcp -p 8080:8080 -v ./config:/app/config whatsapp-mcp-go
• Postman ou Insomnia pour tester les API WhatsApp et Claude sans écrire de code.
  • Permet d’envoyer des requêtes, de vérifier les réponses et de documenter vos endpoints.
  • Des collections prêtes à l’emploi existent pour WhatsApp Business API sur la Postman API Network.
• Ngrok pour exposer de façon sécurisée un serveur local vers internet.
  • Très utile si whatsapp-mcp-go tourne en local alors que WhatsApp Business API exige une URL publique.
  • Commande de base : ngrok http 8080
  • Offre gratuite suffisante pour un ou deux tunnels de test.
• Grafana et Prometheus pour suivre performances et erreurs.
  • Indispensables en production pour détecter goulots d’étranglement et pics de charge.
  • whatsapp-mcp-go peut exposer des métriques personnalisées consommables par Prometheus.
• Git avec GitHub ou GitLab pour versionner vos fichiers et collaborer.
  • Créez un dépôt privé pour stocker configuration et adaptations de whatsapp-mcp-go.
  • Travaillez par branches dédiées (ex. : feature/claude-integration) pour isoler vos changements.

3. Documentation et ressources

Avant d’ouvrir votre éditeur de code, prenez le temps de regrouper les ressources utiles. Un dossier bien structuré vous fera gagner des heures lors des phases de test et de maintenance.

• Documentation officielle à garder sous la main :
  • WhatsApp Business API : developers.facebook.com/whatsapp/api
  • Claude API : docs.anthropic.com/claude/api
  • whatsapp-mcp-go : github.com/nom-du-depot/whatsapp-mcp-go/README.md (remplacez par l’URL exacte).
• Guides pratiques complémentaires :
  • « Déployer WhatsApp Business API en 2026 », article Meta for Developers, mis à jour en janvier 2026.
  • « Intégrer une IA comme Claude à une API existante », tutoriel Anthropic, décembre 2025.
  • « Sécuriser son environnement Go en production », billet du blog Gopher Academy.
• Communautés d’entraide :
  • Serveur Discord WhatsApp Business API (lien dans la documentation officielle).
  • Forum Anthropic : community.anthropic.com pour les questions liées à Claude.
  • Stack Overflow (tags : whatsapp-api, golang, anthropic-claude).

Astuce : regroupez ces liens dans un dossier de favoris dédié (par exemple « WhatsApp‑Claude‑Intégration ») et ajoutez‑y vos notes au fil du projet. Des outils comme Notion ou Obsidian facilitent la centralisation de la documentation et des scripts.

4. Compte test et données factices

Pour ne pas perturber vos vrais clients pendant la phase de réglage, montez un environnement de test complet. Cette séparation nette entre test et production vous évitera des erreurs embarrassantes.

• Un compte WhatsApp Business dédié aux tests (par exemple votreentreprise-test).
  • Utilisez un numéro de téléphone virtuel (type Google Voice, Twilio) afin de ne pas mobiliser une ligne réelle.
• Des jeux de données factices :
  • Générez des conversations types avec des outils comme Faker (Python) ou Mockaroo.
  • Exemple de structure pour un fichier JSON de test :

{
  "conversations": [
    {
      "id": "msg_123",
      "sender": "+33612345678",
      "content": "Bonjour, je voudrais un remboursement pour ma commande #4567.",
      "timestamp": "2026-02-20T14:30:00Z",
      "expected_response": "Bonjour ! Votre demande de remboursement pour la commande #4567 est en cours de traitement. Délai : 3 à 5 jours ouvrés. Souhaitez-vous un suivi par email ?"
    },
    {
      "id": "msg_124",
      "sender": "+33687654321",
      "content": "Où en est ma livraison ? Référence : TRK987654",
      "timestamp": "2026-02-20T15:15:00Z",
      "expected_response": "Votre colis (TRK987654) est en transit. Livraison prévue demain entre 9h et 12h. Merci de votre patience !"
    }
  ]
}

• Un script de simulation :
  • Écrivez un petit programme (en Python ou Bash) pour envoyer des messages de test à votre bot via l’API WhatsApp.
  • Exemple avec cURL :

curl -X POST https://graph.facebook.com/v19.0/PHONE_NUMBER_ID/messages 
  -H "Content-Type: application/json" 
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" 
  -d '{
    "messaging_product": "whatsapp",
    "recipient_type": "individual",
    "to": "RECIPIENT_PHONE_NUMBER",
    "type": "text",
    "text": {
      "body": "Test automatique – Veuillez ignorer ce message."
    }
  }'

Pourquoi tester en conditions proches du réel ? Parce que l’immense majorité des bugs dans ce type d’intégration provient de :

• Problèmes de formatage des messages (emojis, pièces jointes, caractères spéciaux).
• Délais de latence réseau entre WhatsApp et votre serveur.
• Erreurs de gestion des webhooks (notifications envoyées par WhatsApp à chaque nouveau message).

À ce stade, votre assistant Claude peut bientôt dialoguer avec vos contacts WhatsApp sans intervention manuelle. Avant d’activer des scénarios complexes, il reste toutefois à installer la brique centrale : whatsapp-mcp-go, le pont logiciel qui relie WhatsApp à l’IA. Nous allons procéder étape par étape, en détaillant chaque commande critique.

Étape 1 : installer whatsapp-mcp-go

Vous entamez ici le premier maillon d’une chaîne qui transformera votre flux de messages en véritable outil de support intelligent. whatsapp-mcp-go est un outil open source, écrit en Go, qui permet d’interfacer WhatsApp avec des API externes. Nous allons l’installer sur une machine locale, qu’il s’agisse d’un Mac, d’un PC sous Linux ou d’un serveur dédié. Prérequis : un minimum d’aisance avec la ligne de commande et un terminal ouvert. Sous Windows, privilégiez WSL 2 pour éviter les difficultés de compatibilité.

Télécharger le logiciel

Commencez par vous rendre sur le dépôt officiel GitHub de whatsapp-mcp-go. Le projet, actif depuis 2023, est régulièrement mis à jour pour suivre les évolutions de l’API WhatsApp. Ouvrez votre terminal et exécutez :

git clone https://github.com/your-repo/whatsapp-mcp-go.git

« Remplacez your-repo par le nom exact du dépôt officiel. »
Conseils issus de la communauté GitHub, 2025

Une fois le dépôt cloné, placez‑vous dans le dossier du projet :

cd whatsapp-mcp-go

Astuce : sous macOS ou Linux, vérifiez que Git est bien installé avec git --version. Sous Windows avec WSL 2, mettez à jour votre distribution (par exemple Ubuntu) via sudo apt update && sudo apt upgrade avant de procéder.

Configurer l’environnement d’installation

Avant de compiler le logiciel, assurez‑vous que votre environnement est prêt. Puisque whatsapp-mcp-go est écrit en Go, vous devez disposer d’une version récente du langage. Si besoin, téléchargez‑la sur le site officiel golang.org et suivez les instructions adaptées à votre système.

Une fois Go installé, vérifiez sa version :

go version

Vous devez disposer au minimum de la version 1.21 de Go. Si ce n’est pas le cas, mettez à jour avant d’aller plus loin.

Configurez ensuite votre GOPATH, le répertoire où Go stocke projets et dépendances. Sous Linux ou macOS, ajoutez dans ~/.bashrc ou ~/.zshrc :

export GOPATH=$HOME/go
export PATH=$PATH:$GOPATH/bin

Puis rechargez votre terminal :

source ~/.bashrc  # ou source ~/.zshrc

Sécurité : évitez d’installer les dépendances en tant qu’utilisateur root. Travaillez avec un compte standard pour réduire l’impact potentiel d’une faille. Cette recommandation rejoint celles de l’équipe Go Security depuis 2024.

Valider l’installation avec un test basique

Une fois l’environnement en place, compilez le logiciel puis lancez un test rapide pour vérifier que tout fonctionne. Dans le dossier du projet, exécutez :

go build

La commande produit un exécutable nommé whatsapp-mcp-go (ou whatsapp-mcp-go.exe sous Windows). Pour s’assurer qu’il répond correctement, lancez :

./whatsapp-mcp-go --help

Si une liste d’options s’affiche (par exemple --phone, --session, --api), c’est que l’installation s’est déroulée correctement et que le binaire est prêt à être utilisé.

Astuce : en cas d’erreur de compilation, contrôlez les dépendances système. Sous Linux, installez les outils de base avec :

sudo apt-get install build-essential

Sous macOS, passez par Homebrew si besoin :

brew install go

Dès que le test est concluant, vous pouvez passer à la configuration de whatsapp-mcp-go pour le connecter à votre compte WhatsApp. Avant cela, gardez sous la main un numéro de téléphone valide et la possibilité de scanner un QR code : ces éléments sont indispensables pour l’étape suivante.

À ce stade, whatsapp-mcp-go est installé. Reste à lui donner accès à votre compte WhatsApp et à sécuriser cette liaison. C’est l’objet de l’étape suivante : la configuration fine de l’interface, afin que le logiciel puisse lire et envoyer des messages de manière fiable.

Étape 2 : configurer l’interface WhatsApp

Votre compte WhatsApp est la porte d’entrée vers vos utilisateurs. Pour que whatsapp-mcp-go puisse y accéder en toute sécurité, il doit être configuré comme un « appareil connecté » supplémentaire, avec des droits précisément définis. L’objectif : autoriser la lecture et l’envoi de messages sans exposer inutilement votre compte ni vos données.

Accéder au compte WhatsApp

Pour que whatsapp-mcp-go puisse recevoir et envoyer des messages, il doit d’abord se connecter à votre compte comme un client WhatsApp Web. Cette approche, inspirée de nombreux outils de bots, évite certaines lourdeurs de l’API officielle de Meta, mais impose quelques précautions.

1. Lancez l’interface de configuration de whatsapp-mcp-go. Sur une installation locale, ouvrez un terminal et exécutez :

« ./whatsapp-mcp-go config lance l’assistant de configuration interactif. »
Documentation whatsapp-mcp-go, 2025

Sous Linux ou macOS, vérifiez d’abord que le binaire est exécutable avec chmod +x whatsapp-mcp-go, afin d’éviter les erreurs de permission.

2. Sélectionnez le mode « Web ». L’outil génère un QR code dans votre terminal ou votre navigateur. Ce code est la clé d’association entre votre session WhatsApp Web et whatsapp-mcp-go. Scannez‑le avec l’application mobile WhatsApp (menu « Appareils connectés »), ou ouvrez web.whatsapp.com et utilisez votre téléphone pour lier la session.

« Ne partagez jamais un QR code de session WhatsApp avec un tiers. »
Recommandations de la CNIL, guide messageries 2024

3. Validez la connexion. Une fois le QR code scanné, votre compte apparaît comme connecté. whatsapp-mcp-go stocke les cookies de session de façon temporaire pour maintenir la liaison. Par défaut, ces informations sont purgées après 24 heures, sauf modification explicite du fichier config.yaml.

Astuce : si la connexion échoue, vérifiez que :

• Votre numéro est correctement renseigné dans config.yaml (champ phone_number).
• Votre application WhatsApp est à jour, car certaines mises à jour peuvent rompre des connexions non officielles.
• Votre appareil dispose d’une connexion stable : une latence supérieure à deux secondes peut provoquer des expirations de session.

En cas de blocage persistant, regénérez un QR code propre avec :

« ./whatsapp-mcp-go reset-session supprime et régénère la session active. »
Forum GitHub whatsapp-mcp-go, discussions 2025

Paramétrer les autorisations nécessaires

WhatsApp limite volontairement certaines fonctions, notamment pour les connexions web. Pour que whatsapp-mcp-go puisse exploiter pleinement les notifications et gérer les médias, quelques réglages manuels s’imposent dans l’application mobile.

1. Activez les notifications pour les appareils connectés.

1. Ouvrez WhatsApp sur votre smartphone.
2. Rendez‑vous dans Paramètres > Appareils connectés.
3. Activez l’option « Notifications pour les appareils connectés ». Sans cela, whatsapp-mcp-go ne recevra pas toujours les messages en temps réel.

Cette bascule permet à l’interface de recevoir immédiatement les nouveaux messages, comme un navigateur connecté en permanence.

2. Désactivez temporairement la vérification en deux étapes.

« La vérification en deux étapes peut bloquer certaines connexions automatisées. »
Échanges sur la communauté whatsapp-mcp-go, 2025

1. Dans WhatsApp, ouvrez Paramètres > Compte > Vérification en deux étapes.
2. Désactivez la fonction ou supprimez le code PIN le temps de la configuration.
3. Une fois la liaison stabilisée, vous pourrez la réactiver en ajustant les paramètres de sécurité côté serveur.

Attention : pendant ces quelques minutes, évitez toute connexion douteuse à votre compte. Surveillez les notifications de connexion et réactivez la double authentification dès la fin des réglages.

3. Autorisez la gestion des médias, si nécessaire.

whatsapp-mcp-go peut, selon la configuration, télécharger et traiter des pièces jointes. Pour l’activer :

1. Dans l’interface de configuration de l’outil, ouvrez l’onglet « Permissions ».
2. Cochez « Autoriser le téléchargement des médias » et indiquez un répertoire de stockage (par exemple /var/www/whatsapp_media/ sous Linux).
3. Enregistrez avec l’option Save ou équivalent.

Astuce : sur un serveur, ajustez les droits sur ce dossier avec :

« chmod -R 755 /chemin/vers/le/dossier sécurise les permissions de base. »
Recommandations infrastructure DigitalOcean, 2025

Lier l’interface à whatsapp-mcp-go

Votre compte WhatsApp est désormais accessible, mais il faut encore établir un lien pérenne entre l’interface et whatsapp-mcp-go. Ce pont bidirectionnel garantit que chaque message entrant est intercepté, transmis à l’IA puis renvoyé à l’utilisateur, sans rupture.

1. Configurez un webhook pour les messages entrants.

Un webhook est une URL appelée automatiquement dès qu’un événement survient. Dans notre cas, il servira à transmettre les messages à Claude. Dans le terminal, exécutez :

« ./whatsapp-mcp-go webhook –url « http://votre-serveur:3000/webhook » »
Exemple de commande pour un serveur local en écoute

Remplacez votre-serveur par l’adresse IP ou le nom de domaine adéquat (par exemple http://192.168.1.100:3000 en réseau local).

Sur un serveur distant type AWS ou OVH, assurez‑vous que :

• Le port 3000 est ouvert dans le pare‑feu (exemple : ufw allow 3000 sous Ubuntu).
• Un reverse proxy (par exemple Nginx) redirige correctement le trafic vers whatsapp-mcp-go.

Exemple minimal de configuration Nginx :

« Utiliser un reverse proxy Nginx simplifie l’exposition sécurisée des webhooks. »
Guide Nginx adapté à whatsapp-mcp-go

server {
    listen 80;
    server_name votredomaine.com;

    location /webhook {
        proxy_pass http://127.0.0.1:3000;
        proxy_set_header Host $host;
    }
}

2. Testez la connexion via un message d’essai.

1. Depuis un second appareil, envoyez un message vers le compte relié, par exemple : « Test connexion IA ».
2. Dans le terminal où tourne whatsapp-mcp-go, surveillez les journaux. Vous devriez voir apparaître une ligne du type :

« [2026-02-24 08:00:00] Message reçu : « Test connexion IA » de +33612345678 »
Sortie de log attendue lors d’un premier test

Si le message n’apparaît pas, vérifiez que le webhook est actif (curl http://votre-serveur:3000/webhook doit renvoyer un état 200 OK) et que whatsapp-mcp-go est bien démarré en mode écoute.

3. Activez le mode de réponse automatique.

Ce mode permet à whatsapp-mcp-go d’envoyer directement les réponses de Claude aux messages reçus. Pour l’activer :

1. Ouvrez config.yaml et ajoutez :

auto_reply:
  enabled: true
  api_key: "votre_cle_api_claude"
  model: "claude-3-opus"

2. Sauvegardez, puis redémarrez l’outil :

« ./whatsapp-mcp-go restart recharge la configuration sans réinstallation. »
Bonnes pratiques d’exploitation ANSSI, synthèse 2025

Sécurité : ne stockez jamais la clé API Claude dans un fichier accessible en lecture à tous les utilisateurs. Placez‑la idéalement dans un fichier dédié, protégé par chmod 600, ou utilisez un gestionnaire de secrets.

Astuce : pour éviter de possibles boucles de réponses automatiques (un message générant une réponse, qui en génère une autre, etc.), ajoutez un filtre dans config.yaml :

filters:
  - pattern: "^Test.*"
    action: "ignore"

Les messages commençant par « Test » seront alors ignorés par le bot, ce qui facilite les essais techniques sans polluer vos statistiques.

4. Contrôlez les logs en direct.

Lancez :

« ./whatsapp-mcp-go logs –follow affiche les échanges en temps réel. »
Commande utile en phase de recette et de production

Vous devriez observer un enchaînement de ce type :

« Message reçu, analyse par Claude, réponse envoyée en quelques secondes. »
Exemple de comportement attendu une fois l’intégration validée

• Si aucun log n’apparaît, vérifiez la connectivité internet du téléphone.
• Redémarrez le service avec ./whatsapp-mcp-go restart si nécessaire.
• En cas de problème récurrent, consultez la rubrique Issues du dépôt GitHub github.com/whatsapp-mcp-go/issues.

Une fois ces vérifications faites, whatsapp-mcp-go sait dialoguer avec votre compte WhatsApp. Il reste à achever la liaison côté IA, en connectant Claude au protocole MCP utilisé par l’outil.

Étape 3 : connecter Claude à WhatsApp via whatsapp-mcp-go

L’objectif de cette étape est double : établir un canal de communication fiable entre Claude et WhatsApp, puis définir les paramètres d’échange pour éviter erreurs de format, délais excessifs ou blocages de compte. Les retours d’expérience de 2025 montrent que près de 60 % des échecs viennent d’une gestion approximative des tokens d’authentification ou des délais de réponse imposés par WhatsApp. Nous allons donc verrouiller ces points un à un.

Initialiser la connexion Claude

Pour que Claude traite les messages issus de WhatsApp, vous devez d’abord générer une clé API dédiée à cet usage. Ce « passeport » authentifie chaque requête.

1. Accédez au tableau de bord de Claude (via l’URL de console ou https://claude.ai/console/api) puis connectez‑vous. Avec une version entreprise ou une clé partagée, assurez‑vous d’avoir les droits administrateur.
2. Dans le menu latéral, ouvrez la rubrique « Clés API » (ou « API Keys »). Cliquez sur « Créer une nouvelle clé » pour afficher le formulaire.
3. Choisissez un nom explicite, par exemple « WhatsApp-MCP-2026 ». Dans la section « Portée (Scope) », cochez uniquement :
   • « Messages » pour l’envoi et la réception de texte.
   • « Webhooks » pour les déclencheurs automatiques.
   • « Authentification MCP » pour le protocole de transport utilisé par whatsapp-mcp-go.

   « Sans le scope MCP, chaque requête issue de WhatsApp sera rejetée par Claude. »
   Documentation API Claude, mise à jour janvier 2026

4. Dans la partie « Délais de réponse », fixez un temps maximum de 10 secondes. WhatsApp impose un délai d’environ 8 secondes pour répondre à un message entrant ; ce paramètre vous donne une marge de sécurité tout en restant conforme. Une fois la clé générée, copiez‑la immédiatement : vous ne pourrez plus l’afficher en entier par la suite.

Conservez cette clé dans un emplacement sécurisé (gestionnaire de mots de passe, coffre‑fort de secrets, etc.). Une seule fuite compromet l’ensemble de votre intégration et peut générer des coûts importants côté API.

Définir les paramètres d’échange

Une fois la clé créée, il faut configurer le pont entre Claude et WhatsApp via whatsapp-mcp-go. Cela suppose une authentification mutuelle et une synchronisation des formats de messages. Ouvrez un terminal et connectez‑vous au conteneur :

sudo docker exec -it whatsapp-mcp-go bash

À l’intérieur du conteneur, lancez l’assistant :

npm run config

Un questionnaire interactif s’affiche. Renseignez les éléments suivants, dans l’ordre :

1. Type de service : sélectionnez l’option correspondant à « Claude AI ». Elle active les règles de formatage compatibles avec les modèles de langage.
2. Clé API Claude : collez la clé générée plus tôt. Prenez le temps de vérifier chaque caractère pour éviter les erreurs 401 liées à une faute de frappe.
3. URL de callback : indiquez une URL accessible publiquement, de type « https://your-domain.com/webhook/claudemcp ». Si votre environnement est local, vous pouvez utiliser un tunnel sécurisé (par exemple via Ngrok) en veillant à activer le HTTPS.

« Les callbacks en HTTP simple sont refusés et bloqués après plusieurs tentatives. »
Notice de sécurité whatsapp-mcp-go, version 2.4.1

4. Délai de réessai : saisissez une valeur autour de 5 secondes. Au‑delà de 7 secondes, WhatsApp peut considérer la connexion comme instable et limiter vos appels.
5. Format des messages entrants : choisissez l’option JSON structuré. Ce format garantit une transmission propre des métadonnées (ID, timestamp, expéditeur) vers Claude.
6. Gestion des médias : dans un premier temps, laissez cette option désactivée. Claude traite principalement le texte dans le cadre de MCP ; les médias attachés pourront être gérés plus tard, via un module complémentaire.

Un récapitulatif est ensuite affiché. Validez avec « Y » pour générer le fichier config.json et redémarrer les services. Laissez une trentaine de secondes au système pour stabiliser la connexion avant de lancer les premiers tests.

Sécurité : pour protéger votre configuration, restreignez immédiatement les droits sur /app/config.json :

chmod 600 /app/config.json

Seul l’utilisateur autorisé pourra alors lire ou modifier ce fichier, ce qui réduit fortement le risque d’exposition de votre clé API.

Tester la communication entre les deux services

Dernière étape de cette partie : vérifier que Claude reçoit bien les messages de WhatsApp et y répond. Un test simple vous permettra de valider le fonctionnement bout en bout.

1. Sur WhatsApp (mobile ou web), envoyez un message à votre propre numéro ou à un contact de test, au format :

   « /test claudemcp » déclenche un scénario de test dans whatsapp‑mcp‑go.
   Commande de vérification intégrée à l’outil

2. Dans un terminal, affichez les journaux :

sudo docker logs -f whatsapp-mcp-go

Vous devriez voir un enchaînement similaire à :

« Message test reçu, transmis à Claude, réponse renvoyée en quelques secondes. »
Scénario de connexion réussie illustré dans les logs

3. En cas d’erreur du type « 401 Unauthorized » ou « MCP Handshake Failed », vérifiez successivement :
   • La clé API (absence d’espace parasite, de caractère coupé).
   • Le choix du format JSON structuré pour les messages entrants.
   • L’accessibilité de l’URL de callback, qui doit renvoyer un statut 200 OK.
4. Pour un test plus proche d’une situation réelle, envoyez une question simple, par exemple :

   « Quel est le taux de change euro‑dollar aujourd’hui ? »
   Exemple de requête utilisateur classique

   La réponse devra inclure une estimation actualisée (par exemple autour de 1 USD pour 0,86 EUR en 2026) et une formulation claire, signe que Claude interprète correctement le contexte.

Astuce : en cas de doute sur le comportement réseau, démarrez whatsapp-mcp-go en mode verbeux pour obtenir plus de détails sur les échanges :

sudo docker run -d --name whatsapp-mcp-go -p 3000:3000 -e VERBOSE=true ghcr.io/your-repo/whatsapp-mcp-go:latest

Les journaux afficheront alors les principaux en‑têtes HTTP et les erreurs MCP détaillées, essentiels pour un diagnostic rapide.

Une fois ces tests validés, vous pouvez aborder la suite : l’optimisation et la sécurisation de l’ensemble, afin de passer d’un prototype fonctionnel à une intégration exploitable au quotidien.

Étape 4 : optimiser et sécuriser l’intégration

Votre environnement whatsapp-mcp-go fait désormais le lien entre WhatsApp et Claude. Pour autant, une intégration de qualité ne se limite pas à « faire fonctionner » les échanges. Il reste à renforcer la sécurité, améliorer les performances et anticiper les incidents. Ce travail de fond est indispensable pour un usage professionnel ou intensif.

Activer les options de sécurité recommandées

Relier une messagerie grand public à une IA capable de traiter des données sensibles impose un niveau de sécurité élevé. whatsapp-mcp-go propose plusieurs mécanismes, mais c’est à vous de les activer et de les paramétrer correctement.

1. Chiffrement des données en transit et au repos

Par défaut, whatsapp-mcp-go s’appuie sur TLS 1.3 pour chiffrer les communications avec WhatsApp. Pour chiffrer aussi les données temporairement stockées (files d’attente, journaux enrichis, etc.), définissez une variable d’environnement ENCRYPTION_KEY. Générez une clé de 256 bits via :

« openssl rand -hex 32 produit une clé hexadécimale de 256 bits. »
Bonnes pratiques cryptographiques sous Linux et macOS

Placez la valeur obtenue dans votre fichier .env au format ENCRYPTION_KEY=VOTRE_CLE_256BITS, et conservez‑la hors de tout dépôt Git public.

2. Authentification renforcée pour l’API WhatsApp

Dans le cas d’un compte professionnel, WhatsApp Business API permet d’activer une authentification à deux facteurs. Depuis le Business Manager, ouvrez les paramètres de sécurité et activez la 2FA par SMS ou via une application dédiée, par exemple Google Authenticator. Ce verrou supplémentaire complique considérablement toute tentative d’usurpation de compte.

3. Restriction des IP autorisées

Limitez l’accès à votre instance à une liste stricte d’adresses IP. Dans config.yaml, ajoutez par exemple :

security:
  allowed_ips:
    - 192.168.1.100
    - 203.0.113.45

« Restreindre les IP réduit drastiquement le risque d’accès non autorisé via l’interface HTTP. »
Retour d’expérience de déploiements en PME

4. Journalisation des activités sensibles

Activez des logs suffisamment détaillés pour détecter les comportements anormaux tout en respectant votre politique de conservation des données. Dans .env, vous pouvez par exemple définir :

LOG_LEVEL=debug
LOG_RETENTION_DAYS=30

Cela enregistrera l’ensemble des actions critiques pendant 30 jours, de quoi reconstituer un incident sans surcharger le stockage.

5. Mise à jour régulière des dépendances

Les bibliothèques tierces sont un vecteur d’attaque fréquent. Planifiez des mises à jour régulières de vos dépendances Go et, le cas échéant, Python :

go get -u ./...
pip list --outdated
pip install --upgrade <package>

« Automatiser les mises à jour de sécurité limite l’exposition aux failles connues. »
Conseils sécurité issus des pratiques DevSecOps

Optimiser les performances d’échange

Une intégration sûre mais lente frustre les utilisateurs. Pour maintenir un temps de réponse court, en particulier au-delà de quelques centaines de messages par heure, travaillez sur trois leviers : réseau, files d’attente et ressources serveur.

1. Réduire la latence réseau

Si vos serveurs sont éloignés des data centers utilisés par WhatsApp, la latence peut vite grimper. Pour optimiser le trajet des paquets, vous pouvez :

• Passer par un proxy ou un CDN géographiquement proche (par exemple Cloudflare Workers ou AWS CloudFront).
• Activer une compression Brotli, plus efficace que gzip pour les payloads JSON volumineux.

Dans config.yaml :

proxy:
  enabled: true
  url: "https://your-proxy-worker.cloudflarestream.com"
  compression: "brotli"

2. Gérer les files d’attente pour lisser les pics

Claude applique des limites de requêtes par minute. Pour absorber un flux élevé sans perte, mettez en place une file Redis intermédiaire :

1. Installez Redis (en local ou via un service managé).
2. Insérez chaque message entrant dans une file, puis consommez cette file via un worker dédié.

En Go, une fonction simple d’enfilement pourra ressembler à :

import "github.com/go-redis/redis/v8"

func enqueueMessage(ctx context.Context, rdb *redis.Client, message string) error {
    return rdb.LPush(ctx, "whatsapp_queue", message).Err()
}

« Surveillez la longueur de la file Redis pour ajuster rapidement le nombre de workers. »
Recommandation issue de déploiements haute charge

3. Dimensionner correctement le serveur

whatsapp-mcp-go est sobre, mais l’ensemble de la chaîne (webhooks, queue, logs, supervision) consomme des ressources. À titre indicatif :

Sur un cloud comme AWS ou GCP, activez l’auto‑scaling pour adapter automatiquement les capacités à la charge observée.

4. Optimiser les appels à l’API Claude

Chaque appel API a un coût et un impact sur la latence. Pour limiter les deux :

• Coupez les messages trop longs avant envoi (par exemple à 2 000 caractères), en expliquant à l’utilisateur que la demande a été résumée.
• Mettez en cache les réponses récurrentes (FAQ, réponses standard) dans Redis ou Memcached.
• Réservez les modèles les plus puissants à des cas complexes, et privilégiez un modèle plus léger (type Claude Instant) pour les requêtes simples.

Surveiller et dépanner les éventuels problèmes

Malgré toutes ces précautions, des incidents finiront par survenir : lenteurs, erreurs 500, webhooks silencieux. Un bon système de monitoring et une procédure de diagnostic claire font la différence entre une panne subie et un incident maîtrisé.

1. Mettre en place des alertes en temps réel

Avec Prometheus et Grafana, suivez en continu :

• La latence moyenne de réponse (objectif : quelques secondes au maximum).
• Le taux d’erreur (visez moins de 1 % sur les traitements).
• La taille de la file d’attente (au‑delà d’une cinquantaine de messages, un ajustement est nécessaire).

2. Structurer les logs pour faciliter l’analyse

Configurez whatsapp-mcp-go pour sortir des logs au format JSON, exploitables dans une pile type ELK ou Loki :

logging:
  format: json
  level: info
  output: /var/log/whatsapp-mcp/go.log

Un exemple de log structuré :

{
  "timestamp": "2026-02-24T08:30:45Z",
  "level": "error",
  "message": "Failed to send message to Claude",
  "error": "429 Too Many Requests",
  "user_id": "12345",
  "message_id": "abc789",
  "retry_count": 3
}

Ce type de données permet de filtrer rapidement par type d’erreur ou par utilisateur impacté, ce qui accélère les investigations.

3. Définir une procédure de dépannage standard

Lorsqu’une alerte tombe, suivez une trame simple :

1. Vérifier la connectivité vers l’API WhatsApp (requête curl de contrôle).
2. Rechercher dans les logs les erreurs récurrentes (429, 500, timeout).
3. Tester un message minimal via le webhook local pour isoler l’origine du problème.
4. Redémarrer au besoin les composants critiques (Redis, conteneur whatsapp-mcp-go, reverse proxy).
5. Si le problème persiste, désactiver temporairement l’intégration et escalader vers les supports Meta ou Anthropic.

4. Prévoir un plan de reprise d’activité

En cas de panne majeure, prévoyez un mode dégradé : message automatique de maintenance côté utilisateurs, mise en file locale des demandes en attente, documentation interne claire pour basculer sur un serveur de secours ou restaurer une sauvegarde.

5. Tester régulièrement la résilience

Programmez des tests de charge sur un environnement de préproduction, par exemple avec k6, pour vérifier que l’infrastructure tient la montée en charge et que les mécanismes de protection (limitation de débit, queues, alertes) se déclenchent correctement.

Une fois ces briques en place, votre intégration WhatsApp – whatsapp-mcp-go – Claude passe du statut de preuve de concept à celui de plateforme fiable, prête à être utilisée en continu, que ce soit pour un support client, des notifications automatisées ou des assistants métier sur mesure.