Se connecterCommencer l’essai gratuit
Meta Tech Provider

Créez un bot WhatsApp avec Claude Code ou Codex, sur le numéro que vous gardez dans l'application

Ajoutez un serveur MCP WhatsApp à Claude Code ou Codex et laissez l'agent de code faire la mise en place : il lit les identifiants Cloud API du numéro, génère un récepteur de webhook, y achemine les messages entrants et envoie une réponse de test à quelqu'un qui a écrit dans les dernières 24 heures. Vous obtenez votre propre agent, qui tourne comme votre code sur votre serveur.

easyCoexistence connecte le numéro WhatsApp Business que vous gardez dans l'application à la Cloud API de Meta via Coexistence, et donne à Claude Code et Codex plus de 30 outils MCP pour construire : identifiants, routage, templates, envois de test et automatisations.

--scope user

Option de Claude Code qui charge un serveur dans tous vos projets ; la portée locale par défaut ne le charge que là où il a été ajouté.

codex mcp login

Commande de Codex qui enregistre la connexion OAuth d'un serveur ; sans identifiant, Codex peut se connecter sans authentification.

HTTPS

Ce que doit utiliser une destination webhook directe : elle doit renvoyer hub.challenge lors de la poignée de main GET de Meta.

20 seconds

Durée d'attente d'une étape Call my webhook pour que votre endpoint renvoie {"reply"}, avant l'échec de l'étape.

24 hours

Fenêtre de service client après le dernier message de l'utilisateur ; au-delà, Meta n'accepte que les messages basés sur un template.

20 msg/s

Débit fixe d'un numéro utilisé à la fois avec l'application WhatsApp Business et la Cloud API.

De quoi un agent de code a-t-il besoin pour créer un agent WhatsApp ?

Quatre éléments. Un numéro WhatsApp Business connecté à la Cloud API de Meta via Coexistence, pour que l'application reste sur le téléphone pendant que le code peut envoyer et recevoir. Une connexion MCP entre Claude Code ou Codex et ce numéro, qui permet à l'agent de code de lire les identifiants, de modifier le routage et d'envoyer des messages de test sans ouvrir de dashboard. Une adresse HTTPS publique pour le récepteur, depuis un hébergeur où vous déployez ou un tunnel pendant le développement. Et une clé de modèle pour l'agent que vous construisez.

Distinguez bien les deux agents. Claude Code ou Codex est le constructeur : il n'agit que pendant que vous travaillez avec lui dans le terminal. Le programme qu'il écrit est celui qui répond aux clients, et il continue de tourner après la fermeture de la session.

Comment ajouter les outils WhatsApp à Claude Code et Codex ?

Chacun prend une seule URL depuis le terminal et se connecte par OAuth, de sorte qu'aucune clé ne va dans un fichier. Dans Claude Code, ajoutez le serveur avec --scope user pour qu'il se charge dans chaque projet, puis lancez claude, exécutez /mcp, choisissez easycoexistence et connectez-vous dans le navigateur. Dans Codex, ajoutez le serveur puis exécutez codex mcp login, qui enregistre la connexion ; codex mcp list affiche ce qui est configuré. Codex conserve l'entrée dans ~/.codex/config.toml, que l'application de bureau ChatGPT et l'extension IDE Codex lisent aussi.

Vérifiez que tout fonctionne en demandant quelque chose que seuls les outils peuvent fournir, par exemple « liste mes numéros WhatsApp ». L'agent appelle list_numbers et obtient le connection_id de chaque numéro, que tous les autres outils utilisent.

Add the server, then sign in
# Claude Code: then start claude and run /mcp to sign in
claude mcp add --transport http easycoexistence --scope user https://easycoexistence.com/api/mcp

# Codex: add, store the OAuth sign-in, check
codex mcp add easycoexistence --url https://easycoexistence.com/api/mcp
codex mcp login easycoexistence
codex mcp list

Quel parcours l'agent doit-il construire ?

Trois parcours acheminent le message d'un client vers votre code, et ils diffèrent par la charge que le code doit gérer. Pour une première version, l'étape Call my webhook est la plus courte : easyCoexistence ignore les doublons, s'efface lorsque vous répondez depuis le téléphone et vérifie la fenêtre de 24 heures avant d'appeler votre endpoint, si bien que votre code n'écrit que la réponse. Passez à une Forward URL ou à une destination directe lorsque l'agent a besoin de chaque événement, et non seulement des messages qu'une automatisation retient.

Call my webhook stepAn automation POSTs the message and the chat's last 10 messages, signed; return {"reply": "..."} within 20 seconds
Forward URL (Automations on)A signed copy of each Meta event goes to your code; automations keep running; you send through the Graph API
Direct destinationMeta posts straight to your endpoint; easyCoexistence never sees the messages; automations stop for that number

Que faut-il demander à l'agent de code ?

Donnez-lui d'emblée le parcours, la langue et les règles, et demandez un plan avant qu'il n'écrive du code. Précisez les appels d'outils qu'il peut faire seul : lire les identifiants et la documentation est sans risque, alors que modifier la destination des messages touche le numéro en service. get_docs renvoie la documentation d'easyCoexistence, y compris la façon dont un récepteur authentifie les livraisons, afin que l'agent lise les règles au lieu de les deviner. Une demande de ce type produit un récepteur que vous pouvez relire en une seule séance :

A request for Claude Code or Codex
Build a WhatsApp agent in Node.js for my number +55 11 4000 1234.
1. Call list_numbers, then get_api_credentials for that number.
   Put send_endpoint and access_token in .env, never in code.
2. Scaffold an HTTPS server with POST /wa/<long random path>.
   Verify X-EC-Signature (HMAC-SHA256 of "<t>.<raw body>").
   Skip message ids already handled.
   On smb_message_echoes, stay quiet on that chat for 4 hours.
3. Reply with my model only within 24 hours of the
   customer's last message.
4. Write tests for the signature check and the 24-hour rule.
Do not call set_inbound_mode or set_webhook_destination
until I say so.

Comment connecter le récepteur et le tester ?

Démarrez le serveur à un endroit où Meta et easyCoexistence peuvent l'atteindre en HTTPS, puis laissez l'agent gérer le routage. Pour le parcours Forward URL, il appelle set_inbound_mode avec votre URL sur un numéro en mode Automations ; le secret de transfert n'est renvoyé qu'une fois, et l'agent l'écrit dans votre .env. Pour le parcours direct, l'endpoint doit d'abord répondre à la poignée de main GET de Meta, puis l'agent appelle set_webhook_destination avec l'URL, un long secret aléatoire dans son chemin et votre verify token.

Pour tester, écrivez au numéro WhatsApp de l'entreprise depuis votre propre téléphone et surveillez les journaux : le récepteur doit voir l'événement, le modèle doit répondre et la réponse doit apparaître dans la conversation. Comme vous venez d'écrire, la fenêtre de 24 heures est ouverte, si bien que l'agent de code peut aussi tenter send_message vers votre propre numéro.

L'agent finalisé a-t-il encore besoin du serveur MCP ?

Non. Le serveur MCP est l'outil du constructeur, connecté sous votre identité. L'agent que vous déployez envoie via l'API Graph de Meta avec le send_endpoint et l'access_token renvoyés par get_api_credentials, le token propre à l'entreprise, limité à ses actifs WhatsApp, et il reçoit par le parcours que vous avez configuré. Si access_token est revenu à null, reconnectez le numéro depuis le dashboard : un token est alors émis sans remplacer celui qui fonctionne déjà.

Gardez la connexion MCP pour le travail autour de l'agent : créer des templates avec create_template, vérifier get_number_health lorsque quelque chose semble anormal, et lire le journal d'exécution de toute automatisation qui transmet des messages à votre code.

Comment le configurer

  1. Connect your numberAt easycoexistence.com, run Meta's Embedded Signup and scan the code with the WhatsApp Business app; the app keeps its chats.
  2. Add the server to your coding agentRun the claude mcp add or codex mcp add command, then sign in with /mcp in Claude Code or codex mcp login in Codex.
  3. Ask for credentials and a planHave the agent call list_numbers and get_api_credentials, store the values in .env and propose the receiver before writing it.
  4. Expose the receiver over HTTPSDeploy it, or run a tunnel while developing, and confirm the URL answers from outside your machine.
  5. Route the messagesLet the agent call set_inbound_mode with a Forward URL, or set_webhook_destination for the direct route, once you approve.
  6. Test from your phoneSend the business number a message and check that your agent's reply arrives in the same chat.

Erreurs courantes

  • Enregistrer un tunnel jetable comme destination directe dans les premières 24 heures. L'import unique des contacts et jusqu'à 6 mois de conversations, réalisé par Meta, part vers cette URL et est perdu à la fermeture du tunnel.
  • Définir une destination directe sur un numéro qui fait tourner des automatisations. Le numéro passe en direct et ses automatisations s'arrêtent ; utilisez une Forward URL en mode Automations pour garder les deux.
  • Commiter le .env écrit par l'agent. Ajoutez-le d'abord à .gitignore, car quiconque détient l'access token peut écrire aux clients au nom de l'entreprise.
  • Tester send_message auprès d'un contact qui n'a pas écrit depuis 24 heures. Meta refuse le texte libre hors fenêtre ; écrivez donc d'abord au numéro depuis votre téléphone.
Faire cela avec EasyCoexistence

Votre agent tourne ensuite sur votre propre serveur, et chaque numéro est surveillé 24h/24 avec alertes. De US$ 9 jusqu'à US$ 0,75 par numéro et par mois, dégressif à mesure que vous ajoutez des numéros, avec les 3 premiers jours en essai gratuit.

Questions fréquemment posées

Cela fonctionne-t-il avec Cursor ou d'autres outils de code ?

Oui. Tout client MCP qui se connecte à des serveurs distants en Streamable HTTP avec OAuth peut utiliser la même URL, y compris Cursor, VS Code, Gemini CLI et Antigravity. Seul le format de configuration change d'un client à l'autre.

Dans quel langage l'agent doit-il être écrit ?

Tout langage capable de servir du HTTPS et de calculer un HMAC-SHA256. Node.js et Python sont les choix courants, et des exemples testés pour les deux, avec vérification des signatures, gestion des doublons et mise en pause liée au téléphone, se trouvent sur la page des agents Node.js et Python.

Ai-je besoin de ma propre application Meta ou d'une App Review ?

Non. Le numéro rejoint la Cloud API via l'application Meta d'easyCoexistence et reste dans le Business Portfolio de l'entreprise. Le token avec lequel votre code envoie est celui de l'entreprise, donc aucune application Meta à vous n'intervient.

L'agent de code peut-il créer les templates dont l'agent a besoin ?

Oui, avec create_template, puis get_template_status jusqu'à la réponse de Meta, en général en quelques minutes et au plus environ 24 heures. Votre agent a besoin d'un template approuvé pour démarrer une conversation ou pour écrire après la fermeture de la fenêtre de 24 heures.

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 gratuit

Vérifié le