Si vous voulez envoyer et recevoir des messages WhatsApp depuis une automatisation comme n8n mais que vous ne pouvez pas (ou ne voulez pas) utiliser l’API officielle WhatsApp Business, vous tomberez vite sur les API WhatsApp « non officielles ». Ce sont des passerelles qui se connectent à WhatsApp comme le fait WhatsApp Web et exposent une API HTTP simple que vous pouvez appeler depuis n8n. Ce guide couvre les huit options les plus populaires de bout en bout : ce qu’est chacune, comment l’installer, l’endpoint et le payload exacts pour envoyer un message, une comparaison côte à côte, et, surtout, les compromis à comprendre avant de construire quoi que ce soit.
Ce que « non officielle » veut vraiment dire
L’accès officiel à WhatsApp pour les entreprises passe par l’API WhatsApp Business de Meta (la Cloud API), qui exige une vérification d’entreprise, utilise des modèles de message pré-approuvés et facture à la conversation. Les API non officielles sautent tout cela : elles font tourner une session WhatsApp Web pour un numéro normal (beaucoup s’appuient sur la bibliothèque open source Baileys ou sur un navigateur headless) et l’enveloppent dans une API REST.
Cette commodité s’accompagne d’une vraie réserve. Automatiser ainsi un numéro personnel n’est pas approuvé par Meta et peut violer les Conditions d’utilisation de WhatsApp. Les numéros peuvent être limités ou bannis, le plus souvent quand ils servent à envoyer des messages de masse non sollicités à des gens qui n’ont jamais donné leur accord. Considérez les API non officielles comme idéales pour les projets personnels, les outils internes, les notifications et les échanges bidirectionnels avec des personnes qui s’attendent à vous lire. Pour une communication conforme à grande échelle, l’API officielle via un fournisseur comme Wati est la bonne voie. Et si vous êtes éligible à l’API officielle mais préférez ne rien auto-héberger, des outils entièrement hébergés comme Zapier ou Make connectent WhatsApp via la Cloud API officielle sans aucun serveur à gérer. Voyez notre guide de l’automatisation pour le tableau complet.
La recette que suit chaque passerelle
Une fois que vous avez vu l’une de ces API, vous les avez pratiquement toutes vues. Les différences tiennent à l’hébergement, au prix et aux détails du payload, le déroulé est identique :
- Reliez un numéro. Vous créez une « instance », « session » ou « canal » pour un numéro WhatsApp dédié et scannez un code QR depuis WhatsApp → Appareils connectés, exactement comme pour se connecter à WhatsApp Web.
- Obtenez un identifiant. Le fournisseur vous donne une clé API ou un jeton qui authentifie chaque requête.
- Envoyez via HTTP. Dans n8n, un nœud HTTP Request fait un POST vers l’endpoint d’envoi du fournisseur avec le destinataire et le texte. (Evolution API et Wassenger proposent aussi des nœuds n8n dédiés si vous préférez ne pas construire les requêtes à la main.)
- Recevez via webhook. Vous pointez le webhook du fournisseur vers un nœud Webhook de n8n, de sorte que chaque message entrant déclenche un workflow, la base des répondeurs automatiques et des chatbots.
Les numéros des destinataires sont toujours au format international complet, uniquement des chiffres, le même format qu’un lien click-to-chat. Certains fournisseurs enveloppent le numéro dans un identifiant de discussion comme 15551234567@c.us (individuel) ou @g.us (groupe) ; les sections par fournisseur ci-dessous précisent lesquels.
Passerelles auto-hébergées : Evolution API, WAHA, WPPConnect
Les passerelles auto-hébergées tournent sur votre propre serveur (avec Docker, c’est l’affaire d’une commande sur n’importe quel VPS bon marché). Vous ne payez rien par message ni d’abonnement (seulement votre serveur) et vos données de messages ne transitent jamais par un tiers, ce qui compte si vous manipulez des listes de contacts sensibles. Le prix à payer : vous les exploitez vous-même, mises à jour, sauvegardes, et un nouveau scan de temps en temps quand une session tombe.
Evolution API, le plus grand écosystème n8n
Evolution API est une passerelle gratuite et open source, le choix le plus populaire des équipes techniques. Elle enveloppe Baileys pour le protocole WhatsApp Web (et peut aussi servir de façade à la Cloud API officielle), gère plusieurs instances (chacune liée à un numéro) et dispose à la fois d’un nœud communautaire dédié (n8n-nodes-evolution-api) et d’un vaste écosystème de modèles n8n prêts à l’emploi.
Installation : démarrez le conteneur Docker avec une clé API globale (par exemple la variable d’environnement AUTHENTICATION_API_KEY, le docker-compose du projet montre les noms actuels), créez une instance via l’API ou l’interface du manager, puis demandez le code QR de l’instance et scannez-le. La documentation Swagger est servie sur le même port pour explorer les endpoints.
- Endpoint d’envoi : POST https://votre-serveur/message/sendText/votre-instance
- Auth : apikey: votre-clé-api (en-tête)
- Corps (JSON) : { "number": "15551234567", "text": "Bonjour depuis n8n + Evolution API" }
WAHA, un conteneur, plusieurs moteurs, excellent avec les médias
WAHA (WhatsApp HTTP API) tourne en une seule image Docker et organise les connexions en sessions (celle par défaut s’appelle littéralement “default”). Sa particularité est le choix des moteurs, un moteur WEBJS basé navigateur et des moteurs NOWEB/GOWS plus légers basés websocket, pour arbitrer entre ressources et fonctionnalités. Le cœur est gratuit en auto-hébergement ; le WAHA Plus payant débloque des capacités avancées. Il est particulièrement solide avec les médias (images, fichiers, notes vocales), ce qui convient aux chatbots plus riches.
Installation : lancez l’image (API sur le port 3000 par défaut, avec documentation Swagger interactive), démarrez une session, récupérez son code QR et scannez-le. Quand le statut de la session est “working”, vous pouvez envoyer. Si vous protégez l’instance avec une clé API, passez-la dans l’en-tête attendu par WAHA (par exemple X-Api-Key).
- Endpoint d’envoi : POST http://votre-hôte-waha:3000/api/sendText
- Corps (JSON) : { "session": "default", "chatId": "[email protected]", "text": "Bonjour depuis n8n + WAHA" }
- Remarque : le suffixe du chatId est @c.us pour les individus, @g.us pour les groupes.
WPPConnect, open source avec jeton par session
WPPConnect Server est le frère communautaire des deux autres : gratuit, open source et auto-hébergé, généralement sur le port 21465 avec documentation Swagger. Son modèle d’authentification diffère un peu : vous définissez une SECRET_KEY sur le serveur, appelez l’endpoint de génération de jeton pour frapper un jeton Bearer pour une session nommée, démarrez la session et scannez son QR. Il expose des endpoints pour les médias, fichiers, boutons et groupes en plus du texte simple.
- Endpoint d’envoi : POST http://votre-serveur:21465/api/votre-session/send-message
- Auth : Authorization: Bearer votre-jeton-de-session
- Corps (JSON) : { "phone": "14155550100", "message": "Bonjour depuis n8n + WPPConnect" }
Passerelles cloud : Green API, UltraMsg, Wassenger, Whapi.cloud, Maytapi
Les passerelles cloud hébergent tout pour vous : vous vous inscrivez, reliez un numéro par QR et commencez à appeler une API, souvent en moins de dix minutes, sans rien à maintenir. En échange, vous payez un abonnement et votre trafic transite par les serveurs du fournisseur. Les cinq ci-dessous suivent le même schéma et diffèrent surtout par le prix, la finition et une ou deux fonctions phares.
Green API, le démarrage le plus rapide, offre développeur gratuite
Green API donne à chaque instance deux valeurs (un idInstance et un apiTokenInstance) intégrées directement dans l’URL de la requête, si bien qu’il n’y a aucun en-tête à configurer. Elle propose une offre développeur gratuite pour les tests, une documentation claire, et autorise des messages texte très longs. Les messages entrants arrivent soit par webhook, soit en interrogeant sa file de notifications avec ReceiveNotification ; avec n8n, les webhooks sont le choix le plus propre.
- Endpoint d’envoi : POST https://api.green-api.com/waInstance{idInstance}/sendMessage/{apiTokenInstance}
- Corps (JSON) : { "chatId": "[email protected]", "message": "Bonjour depuis n8n + Green API" }
UltraMsg, l’option la plus simple et économique
UltraMsg est le minimaliste du groupe : vous obtenez un ID d’instance (du type instance12345) et un jeton, et vous envoyez des messages avec une seule requête form-encoded, pas de JSON, pas de nœud spécial. Une réponse réussie ressemble à { "sent": "true", "message": "ok", "id": 497 }. C’est un choix pragmatique pour des notifications simples et de petits chatbots où le coût et le temps d’installation priment.
- Endpoint d’envoi : POST https://api.ultramsg.com/instance12345/messages/chat
- Corps (Form-Urlencoded) : token = votre-jeton, to = 15551234567, body = Bonjour depuis n8n + UltraMsg
Wassenger, fonctions business et nœud n8n natif
Wassenger vise les usages professionnels : il ajoute une boîte de réception d’équipe par-dessus l’API et, point notable, fournit une intégration n8n native, vous pouvez donc poser un nœud Wassenger au lieu de configurer des requêtes HTTP. Vous connectez un appareil par QR, créez une clé API et la passez dans un en-tête Token. Au-delà du texte, il envoie médias, documents, positions, sondages et boutons, et écrit aux groupes.
- Endpoint d’envoi : POST https://api.wassenger.com/v1/messages
- Auth : Token: votre-clé-api (en-tête)
- Corps (JSON) : { "phone": "+14155550100", "message": "Bonjour depuis n8n + Wassenger" }
Whapi.cloud, REST propre avec jetons par canal
Whapi.cloud traite chaque numéro connecté comme un « canal » avec son propre jeton Bearer, un modèle net si vous exploitez plusieurs numéros à des fins différentes. Les endpoints REST sont propres et bien documentés, il existe une offre gratuite pour prototyper, et le champ to accepte des identifiants de groupes et de chaînes en plus des numéros individuels (uniquement des chiffres, sans signe plus).
- Endpoint d’envoi : POST https://gate.whapi.cloud/messages/text
- Auth : Authorization: Bearer votre-jeton-de-canal
- Corps (JSON) : { "to": "14155550100", "body": "Bonjour depuis n8n + Whapi.cloud" }
Maytapi, conçue pour gérer plusieurs numéros
L’atout phare de Maytapi est le multi-numéros : un compte (un « produit ») peut contenir plusieurs instances de téléphone, chacune adressée par son propre phone ID dans l’URL. Vous vous authentifiez avec un jeton dans un en-tête x-maytapi-key, et le même endpoint envoie médias, positions et contacts en changeant le champ type. Les webhooks se configurent une fois par produit.
- Endpoint d’envoi : POST https://api.maytapi.com/api/votre-product-id/votre-phone-id/sendMessage
- Auth : x-maytapi-key: votre-jeton (en-tête)
- Corps (JSON) : { "to_number": "14155550100", "type": "text", "message": "Bonjour depuis n8n + Maytapi" }
Tableau comparatif
Les huit côte à côte. « Auto-hébergé » signifie que vous l’exploitez vous-même (typiquement avec Docker) et ne payez que votre serveur ; « cloud » signifie que le fournisseur héberge et que vous le payez. Aucun prix fixe ici, vérifiez toujours la tarification actuelle du fournisseur.
| Fournisseur | Hébergement | n8n | Modèle de coût | Point fort |
|---|---|---|---|---|
| Evolution API | Auto-hébergé (Docker) | Nœud communautaire + HTTP | Gratuit en auto-hébergement | Le plus grand écosystème n8n ; enveloppe Baileys |
| WAHA | Auto-hébergé (Docker) | HTTP | Cœur gratuit + Plus payant | Plusieurs moteurs, très bon en médias |
| WPPConnect | Auto-hébergé (Docker) | HTTP | Gratuit en auto-hébergement | Open source, contrôle total des données |
| Green API | Cloud | HTTP | Offre gratuite + payant | Démarrage rapide, docs claires |
| UltraMsg | Cloud | HTTP | Payant, bas coût | L’installation la plus simple |
| Wassenger | Cloud | Nœud natif + HTTP | Payant | Boîte d’équipe, nœud n8n natif |
| Whapi.cloud | Cloud | HTTP | Offre gratuite + payant | REST propre, jetons par canal |
| Maytapi | Cloud | HTTP | Payant | Gestion multi-numéros |
Aide-mémoire des endpoints
Pour référence rapide quand vous câblez le nœud HTTP Request de n8n, l’appel d’envoi de texte de chaque fournisseur, condensé :
| Fournisseur | Endpoint d’envoi (POST) | Auth | Champ destinataire |
|---|---|---|---|
| Evolution API | /message/sendText/{instance} | en-tête apikey | number (chiffres seuls) |
| WAHA | /api/sendText | en-tête X-Api-Key (si défini) | chatId (…@c.us) |
| WPPConnect | /api/{session}/send-message | jeton Bearer | phone (chiffres seuls) |
| Green API | /waInstance{id}/sendMessage/{token} | dans l’URL | chatId (…@c.us) |
| UltraMsg | /{instance}/messages/chat | champ token du formulaire | to (chiffres seuls) |
| Wassenger | /v1/messages | en-tête Token | phone (préfixe +) |
| Whapi.cloud | /messages/text | jeton Bearer | to (chiffres seuls) |
| Maytapi | /api/{produit}/{téléphone}/sendMessage | en-tête x-maytapi-key | to_number (chiffres seuls) |
Laquelle choisir ?
- Vous voulez un contrôle total et zéro coût par message, et pouvez exploiter un serveur ? Auto-hébergez Evolution API, WAHA ou WPPConnect.
- Vous voulez zéro infrastructure et le démarrage le plus rapide ? Utilisez une passerelle cloud, Green API, UltraMsg, Whapi.cloud, Wassenger ou Maytapi.
- Vous voulez un vrai nœud n8n plutôt que du HTTP brut ? Evolution API (nœud communautaire) ou Wassenger (intégration native).
- Vous devez gérer plusieurs numéros WhatsApp ? Maytapi est faite pour ça.
- Vous cherchez le plus grand écosystème de modèles/communauté n8n ? Evolution API.
- Vous avez besoin de messages conformes et consentis à vraie grande échelle ? Passez à l’API officielle avec Wati plutôt qu’une passerelle non officielle.
Recevoir des messages et construire un chatbot
Envoyer n’est que la moitié de l’histoire. Chaque fournisseur ci-dessus peut livrer les messages entrants à l’URL de votre choix, pointez ce webhook vers un nœud Webhook de n8n et chaque message WhatsApp entrant devient le déclencheur d’un workflow. Le schéma bidirectionnel classique : message entrant → rechercher l’expéditeur dans vos données (une feuille, un CRM, une base) → éventuellement lancer une étape IA qui rédige un brouillon de réponse → renvoyer la réponse par le même endpoint d’envoi. C’est un répondeur automatique ou un chatbot complet, construit entièrement avec des nœuds n8n. Constructions courantes : un répondeur de FAQ qui passe la main à un humain en cas de doute, des notifications de commandes ou de rendez-vous déclenchées depuis un tableur, et des assistants IA qui peuvent même transcrire les notes vocales entrantes (la gestion des médias de WAHA est particulièrement bonne pour cela).
Rester prudent, quel que soit votre choix
- Utilisez un numéro dédié que vous acceptez de perdre, pas votre ligne personnelle principale.
- Faites-le monter en température, commencez doucement, et n’écrivez qu’à des gens qui vous attendent.
- N’arrosez jamais à froid de messages de masse non sollicités ; c’est la voie la plus rapide vers le bannissement.
- Respectez les désinscriptions, gardez des volumes raisonnables et ajoutez des délais à visage humain entre les messages.
Foire aux questions
Les API WhatsApp non officielles sont-elles légales ?
Elles sont largement utilisées, mais automatiser ainsi un numéro WhatsApp personnel peut enfreindre les Conditions d’utilisation de WhatsApp, et Meta peut bannir des numéros, surtout pour des envois de masse non sollicités. Utilisez-les pour des projets personnels et des échanges bidirectionnels consentis, et l’API officielle pour le marketing à grande échelle.
Faut-il coder pour les utiliser avec n8n ?
Pas vraiment. Dans n8n, vous pouvez toutes les appeler avec le nœud HTTP Request, et Evolution API et Wassenger ont même des nœuds dédiés. Vous configurez l’endpoint et le jeton, aucune programmation traditionnelle requise.
Laquelle est la meilleure pour débuter ?
Si vous ne voulez pas exploiter de serveur, une option cloud comme Green API ou UltraMsg est la plus rapide. Si Docker ne vous fait pas peur et que vous voulez zéro frais par message, Evolution API ou WAHA vous donnent plus de contrôle.
Qu’est-ce que le format d’identifiant @c.us utilisé par certains fournisseurs ?
C’est le numéro du destinataire au format international complet (chiffres seuls) suivi de @c.us pour une discussion individuelle, p. ex. [email protected], ou @g.us pour un groupe. WAHA et Green API l’utilisent ; les autres prennent un simple champ numéro.
Les options auto-hébergées sont-elles vraiment gratuites ?
Oui, Evolution API et WPPConnect sont open source et gratuites en auto-hébergement, et WAHA a un cœur gratuit (plus une offre Plus payante). Vos seuls coûts sont le serveur qui les fait tourner et, le cas échéant, un abonnement n8n. Il n’y a pas de frais par message parce qu’elles utilisent une session WhatsApp Web plutôt que l’API officielle payante.
Peuvent-elles faire bannir mon numéro ?
Toutes le peuvent, si vous envoyez des messages de masse non sollicités, la passerelle ne compte pas, c’est le comportement qui compte. Utilisez un numéro dédié, n’écrivez qu’à des gens qui vous attendent, gardez des volumes modestes et envisagez l’API officielle pour les grandes campagnes.
