API WhatsApp pour agents IA : accès officiel en quelques minutes, sans devenir Tech Provider
Un agent IA obtient un accès officiel à WhatsApp via l'API Cloud de Meta, et un numéro qui reste dans l'application WhatsApp Business s'y raccorde par un Tech Provider ou un Solution Partner. Vous pouvez devenir l'un des deux, avec la vérification de l'entreprise, les vidéos App Review et un développement Embedded Signup, ou vous connecter via un fournisseur qui l'est déjà : le numéro rejoint l'API en quelques minutes et l'agent reçoit des outils MCP ou des identifiants API.
easyCoexistence est un Tech Provider Meta indépendant : il raccorde un numéro WhatsApp Business à l'API Cloud via la Coexistence en quelques minutes, pour que votre agent ait un accès officiel pendant que l'entreprise garde l'application.
Ce que Meta exige de quiconque raccorde un numéro qui reste dans l'application WhatsApp Business : le statut de Tech Provider ou de Solution Partner.
App Review demande une vidéo d'un message envoyé depuis votre application, et une vidéo de votre application créant un template.
Ce qu'App Review accorde pour whatsapp_business_messaging et whatsapp_business_management, deux permissions requises pour devenir Tech Provider.
Quand Meta a déprécié Embedded Signup v2 et v3, demandant aux intégrations de passer à la v4.
Débit fixe d'un numéro utilisé à la fois dans l'application WhatsApp Business et dans l'API Cloud.
Durée de validité d'un lien de connexion hébergé lorsqu'une plateforme raccorde le numéro d'un client via l'API Partner.
De quoi un agent IA a-t-il besoin pour utiliser WhatsApp officiellement ?
Quatre éléments de l'API Cloud de Meta. Un ID de numéro de téléphone et un token d'accès avec la permission whatsapp_business_messaging, pour que l'agent puisse appeler l'endpoint messages. Un endpoint webhook où Meta livre les messages entrants, et, sur un numéro partagé avec l'application, smb_message_echoes pour les réponses qu'une personne tape sur son téléphone. Des templates approuvés, car un message saisi n'atteint que quelqu'un qui a écrit dans les dernières 24 heures. Et un moyen de savoir quand la connexion casse, puisque l'application sur le téléphone continue de fonctionner quand le côté API s'arrête.
Le raccourci que l'on trouve en premier est l'automatisation de WhatsApp Web, qui se connecte comme un appareil lié. Cela enfreint les conditions de WhatsApp et expose le numéro à un risque de bannissement, quoi que fasse l'agent par-dessus.
Que suppose la voie Tech Provider ?
La séquence propre à Meta, dans cet ordre. Chaque étape est gratuite, et aucune ne peut s'acheter plus vite : les revues suivent le calendrier de Meta, qui ne publie aucun délai, donc prévoyez des semaines plutôt que des jours avant que le numéro du premier client se connecte. Ensuite, le backend doit rester en marche : l'échange de token après chaque inscription, un récepteur de webhooks, le routage par numéro, et la surveillance des déconnexions, comme la règle d'inactivité de 14 jours de Meta.
Quel est le chemin plus court ?
Connectez le numéro via un fournisseur qui a déjà franchi ce processus. Avec easyCoexistence, l'entreprise lance l'Embedded Signup de Meta et scanne un code avec l'application WhatsApp Business, ce qui prend environ deux minutes ; le numéro rejoint l'API Cloud dans son Business Portfolio, et l'application continue de fonctionner. L'agent accède ensuite sous la forme qu'il utilise : des outils MCP pour un assistant comme ChatGPT, Claude, Claude Code ou Codex, ou les identifiants et webhooks du numéro pour le code que vous faites tourner.
| Connect through easyCoexistence | Become a Tech Provider | |
|---|---|---|
| Meta app and App Review | Not needed: the number joins through ours | Yours to build and pass |
| Embedded Signup | Hosted, with the QR scan in the app | You integrate version 4 and host the flow |
| First number connected | Minutes after signing up | After verification and review |
| Webhook trust | A secret in your URL, or X-EC-Signature on forwarded messages | Your app secret signs Meta's deliveries |
| Disconnection alerts | Every number watched 24/7, 14-day rule included | Monitoring you build and run |
| Who owns the WhatsApp Business Account | The business, in its own portfolio | The business |
Comment l'agent obtient-il les identifiants du numéro ?
Via get_api_credentials, ou depuis la page du numéro dans le dashboard. L'outil renvoie l'URL de base de la Graph API, le WhatsApp Business Account ID, l'ID du numéro de téléphone, l'endpoint d'envoi et, lorsqu'il en existe un, le token propre à l'entreprise, limité à ses actifs WhatsApp. Si aucun token client n'a été émis, le token revient à null avec une note indiquant que reconnecter le numéro depuis le dashboard en émet un, sans remplacer un token qui fonctionne. Il n'existe aucun secret d'application à récupérer, car Meta signe les webhooks avec le secret d'application d'easyCoexistence, qui n'est jamais partagé. L'outil nécessite un forfait actif, puisque le token peut envoyer.
curl -X POST "$SEND_ENDPOINT" \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"messaging_product": "whatsapp",
"to": "5511999998888",
"type": "text",
"text": { "body": "Your order #1042 is ready for pickup." }
}'Comment les messages entrants parviennent-ils à l'agent ?
Chaque numéro a deux modes, changés avec set_inbound_mode ou sur la page du numéro. Direct vers votre serveur : set_webhook_destination pointe Meta directement vers votre endpoint HTTPS, qui doit répondre à la poignée de main GET de Meta, et easyCoexistence ne voit jamais les messages, donc les automatisations sont désactivées. Comme Meta signe ces livraisons avec notre secret d'application, placez un long secret aléatoire dans le chemin de l'URL et rejetez les requêtes qui n'en ont pas.
Automatisations activées : Meta livre à easyCoexistence, les automatisations peuvent répondre, et une URL de transfert facultative reçoit la charge utile d'origine de Meta sous « value », signée avec X-EC-Signature: t=<unix>,v1=<HMAC-SHA256 de "<t>.<body>"> au moyen d'un secret affiché une seule fois. L'étape « Appeler mon webhook » d'une automatisation transmet aussi le message et les 10 derniers messages du chat à votre agent, et envoie sa réponse lorsque votre réponse est {"reply": "..."} dans les 20 secondes.
Quelles limites l'agent doit-il respecter ?
Celles de Meta, identiques quel que soit le fournisseur. Un agent qui les connaît à l'avance évite les échecs qui ressemblent à des bugs :
- 20 messages par seconde et par numéro, fixés par Meta pour les numéros partagés avec l'application WhatsApp Business.
- Messages saisis uniquement dans les 24 heures suivant le dernier message du client ; au-delà, un template approuvé.
- Les templates partent uniquement par l'API, car l'application sur un numéro en Coexistence ne peut pas les envoyer.
- Les réponses qu'une personne tape dans l'application arrivent sous forme de
smb_message_echoes; mettez l'agent en pause sur ce chat, sinon le client reçoit deux réponses. - Les discussions de groupe ne sont pas synchronisées avec l'API, donc l'agent travaille dans les conversations individuelles.
- Les contacts et jusqu'à 6 mois de conversations individuelles s'importent une seule fois, uniquement si une destination webhook directe est enregistrée dans les 24 heures suivant la connexion ; un numéro avec automatisations activées n'obtient pas cet import.
- Les appels vocaux et vidéo restent disponibles dans l'application, mais l'API Cloud ne transporte pas les appels sur un numéro en Coexistence ; l'agent travaille donc par texte.
Une plateforme peut-elle raccorder les numéros de ses propres clients ainsi ?
Oui, via l'API Partner. C'est ainsi qu'un SaaS ou une agence raccorde ses clients sans disposer d'un statut de Tech Provider propre. Créez la clé avec create_api_key (elle commence par ec_live_ et s'affiche une seule fois), puis appelez POST /api/v1/connect-sessions depuis votre backend, ou create_connect_link depuis l'assistant, pour obtenir un lien hébergé valable 1 heure. Le client y lance la fenêtre de Meta et le scan du code QR, puis revient vers votre redirect_url avec un connection_id. GET /api/v1/connections/:id?credentials=1 renvoie alors le token propre au client, et les événements de statut, comme connection.disconnected, arrivent signés avec X-EC-Signature. Chaque numéro est facturé sur votre compte au même barème par numéro.
Erreurs courantes
- Valider X-Hub-Signature-256 sur une destination directe. Meta signe avec le secret d'application d'easyCoexistence, qui n'est jamais partagé ; les livraisons authentiques échouent donc à la vérification. Faites confiance à un long secret aléatoire dans l'URL, ou utilisez le transfert avec X-EC-Signature.
- Recevoir avec le nœud WhatsApp Trigger de n8n. Il attend votre propre application Meta ; utilisez plutôt le nœud Webhook générique avec un secret dans son URL.
- Ignorer smb_message_echoes. L'agent répond alors par-dessus une personne qui a déjà répondu depuis le téléphone, et le client lit deux réponses.
- Enregistrer la destination webhook directe des jours après la connexion, ou laisser le numéro sur les automatisations. L'import unique des contacts et de jusqu'à 6 mois de conversations de Meta exige une destination directe enregistrée dans les 24 heures suivant la connexion.
L'agent passe par plus de 30 outils MCP ou par les identifiants et webhooks de chaque numéro, et chaque numéro est surveillé 24 h/24 et 7 j/7, avec alertes. De US$ 9 à US$ 0,75 par numéro et par mois, dégressif à mesure que vous ajoutez des numéros, avec un essai gratuit de 3 jours.
Questions fréquemment posées
Faut-il ma propre application Meta ?
Non. Le numéro est raccordé via l'application Meta d'easyCoexistence et reste dans le Business Portfolio et le compte WhatsApp Business de l'entreprise. Votre code envoie avec le token propre à l'entreprise obtenu via get_api_credentials, donc aucune application à vous n'intervient, sauf si vous en créez une plus tard.
L'agent et l'équipe peuvent-ils utiliser le numéro en même temps ?
Oui. Meta synchronise les messages entre l'API Cloud et l'application WhatsApp Business : ce que l'agent envoie apparaît dans le fil de discussion de l'application sur le téléphone, et ce que l'équipe tape dans l'application arrive dans votre système sous forme de smb_message_echoes.
Quels frameworks d'agents sont compatibles ?
Tout client qui parle MCP sur HTTP avec OAuth, comme ChatGPT, Claude, Claude Code, Codex et Cursor, et tout code qui appelle la Graph API de Meta : Node.js, Python, n8n, LangChain, l'OpenAI Agents SDK ou le Vercel AI SDK. L'API sous-jacente est celle de Meta, donc rien de propriétaire ne se cache dans l'agent.
Un assistant IA généraliste est-il autorisé sur WhatsApp ?
La section 4.7 des Business Solution Terms de Meta interdit aux fournisseurs d'assistants IA généralistes de les proposer sur la WhatsApp Business Platform lorsque l'IA en est la fonctionnalité principale, selon l'appréciation de Meta, en vigueur depuis le 15 janvier 2026. Une entreprise qui utilise l'IA pour ses propres clients, pour le support, la vente ou les réservations, n'est pas visée, et les régulateurs de l'UE et du Brésil ont ordonné à Meta de suspendre la règle, ou d'revenir dessus, pour les assistants concurrents.
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 gratuitVérifié le