Intégration WhatsApp Business Cloud n8nAutomatiser WhatsApp Business Cloud avec n8n.
Répondre automatiquement sur WhatsApp sans laisser le numéro à l'abandon ? C'est le rôle de l'intégration WhatsApp Business Cloud n8n : un nœud de 6 opérations réparties sur 2 ressources, et un trigger branché sur 10 événements. Les messages entrants et les réponses vivent dans le même workflow.
Avis vérifiés sur Trustpilot · Agence IA, automatisation & growth
À quoi sert l'intégration WhatsApp Business Cloud n8n ?
L'intégration WhatsApp Business Cloud n8n relie un numéro professionnel à un workflow n8n via la Cloud API de Meta. Le nœud envoie des messages, des templates et des fichiers depuis n'importe quelle étape du workflow. Le trigger reçoit les événements par webhook, c'est-à-dire une URL que WhatsApp appelle dès qu'il se passe quelque chose sur le compte. Un client écrit, le workflow démarre dans les secondes qui suivent.
Le premier usage, c'est la boucle de réponse. Le trigger se déclenche sur l'événement messages quand quelqu'un écrit au numéro pro. La suite du workflow lit le texte, cherche l'information et message.send renvoie la réponse sur le même fil. Une étape de plus et l'échange atterrit dans Google Sheets, ce qui donne un historique lisible sans installer de CRM.
Deuxième usage : la notification sortante. Un rendez-vous approche, un devis attend une signature, une commande part de l'entrepôt. Le workflow appelle message.sendTemplate avec un template déjà défini dans le compte WhatsApp Business, et les parties variables passent par Components. C'est la bonne opération pour les messages répétitifs, là où le texte libre convient mieux à une conversation.
Troisième usage : le point de validation humain. message.sendAndWait met le workflow en pause, pose la question sur le téléphone du responsable et reprend quand il a tapé Approuver ou rempli le formulaire. Pratique pour valider un geste commercial avant qu'il parte, avec une copie envoyée par Gmail pour garder une trace écrite. Si l'audience est ailleurs, le même montage tient avec Telegram.
Le nœud HTTP Request prend le relais dès que la Cloud API propose quelque chose que le nœud n'expose pas : gérer les templates, administrer les numéros, relire un historique. Il appelle n'importe quel endpoint de l'API en réutilisant le même credential grâce à l'authentification prédéfinie, donc un seul jeton à faire tourner.
Restent trois limites à connaître avant de construire. WhatsApp n'enregistre qu'un seul webhook par application, donc l'URL de test et celle de production s'écrasent mutuellement. Aucun caractère joker n'existe côté trigger : chaque événement utile doit être coché à la main. Et les médias passent par trois opérations distinctes, pas par une pièce jointe glissée dans le message. Pour le reste, l'Avis n8n détaille la plateforme elle-même, et la Formation n8n reprend la construction de ces workflows depuis zéro.
Comment connecter WhatsApp à n8n ?
- 01
Préparer les comptes côté Meta
Trois pièces existent avant n8n. Un compte développeur Meta, créé sur le site Facebook Developers, vérifié par téléphone. Un portefeuille d'entreprise Meta, l'ancien compte Business Manager, exigé par les services de messagerie WhatsApp. Une application d'entreprise Meta avec le produit WhatsApp ajouté depuis Add products. Dans App settings puis Basic, renseigne Privacy Policy URL et Terms of Service URL, puis bascule App Mode sur Live.
- 02
Créer le credential API key du nœud
Le nœud WhatsApp Business Cloud s'authentifie avec une clé d'API composée de deux valeurs. L'Access Token se génère dans l'application Meta, menu WhatsApp puis API Setup : clique sur Generate access token et confirme les accès accordés. Le Business Account ID se copie sur le même écran API Setup. Un credential se crée une seule fois dans le menu Credentials de n8n et se réutilise dans tous les workflows.
- 03
Ajouter le credential OAuth2 du trigger
Le WhatsApp Trigger utilise une autre méthode : OAuth2, avec un Client ID et un Client Secret. Les deux viennent de la même application Meta, dans App settings puis Basic. L'App ID se colle dans le champ Client ID du credential n8n, l'App Secret dans le champ Client Secret. Deux credentials cohabitent donc pour un seul setup WhatsApp, un pour envoyer et un pour recevoir. Pas besoin de les retenir, chaque nœud propose le bon dans sa liste.
Sur quoi le WhatsApp Trigger se déclenche-t-il ?
WhatsApp Trigger est le nœud qui démarre un workflow quand quelque chose se passe dans WhatsApp Business Cloud. Il écoute 10 événements, listés ci-dessous par famille. Tu en choisis un ou plusieurs, tu actives le workflow : n8n enregistre le webhook (l'URL que WhatsApp Business Cloud appelle) sur ton compte.
Ce que tu vois dans n8n
Tous les événements, par famille
Une ligne par objet, une puce par action. L'événement à cocher dans le nœud s'écrit objet.action ; survole une puce pour lire quand il se déclenche.
account_review_update.*1account_review_ update. account_review_ update
account_update.*1account_update. account_update
business_capability_update.*1business_capability_ update. business_capability_ update
message_template_quality_update.*1message_template_ quality_ update. message_template_ quality_ update
message_template_status_update.*1message_template_ status_ update. message_template_ status_ update
messages.*1messages.messages
phone_number_name_update.*1phone_number_ name_ update. phone_number_ name_ update
phone_number_quality_update.*1phone_number_ quality_ update. phone_number_ quality_ update
security.*1security.security
template_category_update.*1template_category_ update. template_category_ update
Notes de configuration
01Set Up the WhatsApp Trigger
La configuration tient en un paramètre et un credential. Trigger On contient la liste des événements auxquels le workflow réagit, et tu coches ceux qui t'intéressent parmi les 10 disponibles. Aucune valeur joker n'existe : un événement non coché n'arrivera jamais. Le trigger s'authentifie avec le credential OAuth2, pas avec la clé d'API du nœud.
Paramètres clés
- Trigger On : les événements que WhatsApp pousse vers ce workflow, cochés un par un dans une liste de 10 entrées.
- Receive Message Status Updates : rangé dans Options, il filtre les changements de statut qui réveillent le workflow. WhatsApp notifie le trigger à chaque passage de Sent à Delivered puis de Delivered à Read, et ne garder que les statuts utiles évite plusieurs exécutions pour un seul message.
02Messages
L'événement messages transporte ce que les clients écrivent au numéro professionnel, ainsi que le statut de livraison des messages partis. C'est lui qui alimente les chatbots, le routage des demandes et les accusés de réception automatiques.
Paramètres clés
- Trigger On : coche
messagespour recevoir le trafic entrant du numéro rattaché au compte. - Receive Message Status Updates : laissé vide, les changements de statut restent en dehors ; avec Delivered ou Read sélectionné, le même workflow voit aussi ce que deviennent les messages sortants.
message.send. Une demande arrive en pleine nuit, un template accuse réception et la demande attend l'équipe le lendemain matin.03Message Template Status Update
Trois événements sur dix suivent la vie des templates plutôt que les conversations : message_template_status_update, message_template_quality_update et template_category_update. Ils comptent parce que message.sendTemplate dépend de templates qui restent utilisables, et rien dans le nœud ne prévient quand l'un d'eux bouge côté Meta.
Paramètres clés
- Trigger On : coche les trois ensemble, un template change rarement de statut sans que sa qualité ou sa catégorie évolue à un moment.
04Account Update
Les événements restants décrivent la santé du compte et des numéros : account_update, account_review_update, business_capability_update, phone_number_name_update, phone_number_quality_update et security. Aucun ne concerne un message client, et c'est précisément pour ça qu'on les oublie jusqu'au jour où quelque chose casse.
Paramètres clés
- Trigger On : coche les événements de compte et de numéro que tu veux voir arriver là où un humain les lira, plutôt que les 10 d'un coup.
phone_number_quality_update tombe, et le workflow met la campagne sortante en pause le temps que le numéro remonte. security tombe, et un ticket s'ouvre. account_review_update indique que Meta a examiné le compte, une information qu'on préfère avoir par écrit.Que sait faire le nœud WhatsApp Business Cloud ?
Le nœud WhatsApp Business Cloud expose 6 opérations sur 2 ressources. Pour chacune : le nœud tel que tu le configures dans n8n, les champs obligatoires, et nos notes de terrain.
| Ressource | Delete | Upload | Download | Send | Send and Wait for Response | Send Template |
|---|---|---|---|---|---|---|
| Message | ✓ | ✓ | ✓ | |||
| Media | ✓ | ✓ | ✓ |
Message
3 opérationsSend message
message.sendCe que tu vois dans n8n
Notes & cas d'usage
Envoie un message WhatsApp depuis le numéro professionnel vers un destinataire. Le champ MessageType commande la suite du formulaire, avec sept types : texte, image, audio, vidéo, document, localisation et contacts.
Paramètres clés
- Sender Phone Number (or ID) : l'identifiant du numéro du compte professionnel depuis lequel part le message, choisi dans une liste déroulante.
- Recipient's Phone Number : le numéro destinataire, indicatif pays compris, souvent une expression comme
{{ $json.phone }}issue de l'item entrant. - Text Body : le message lui-même, plafonné à 4096 caractères.
- Input Data Field Name : pour un média envoyé depuis n8n, le nom brut du champ binaire, écrit
dataet pas sous forme d'expression.
Send message and wait for response
message.sendAndWaitCe que tu vois dans n8n
Notes & cas d'usage
Suspend le workflow, pose une question sur un téléphone et ne reprend qu'après sa réponse. L'exécution reste ouverte pendant ce temps : c'est le point de contrôle humain d'un workflow WhatsApp.
Paramètres clés
- Message : le texte que lit le destinataire avant de trancher.
- Response Type : Approval pour approuver ou refuser depuis le message, Free Text pour une réponse écrite via un formulaire, Custom Form pour des champs nommés que tu définis.
- Type of Approval : Approve Only quand un simple feu vert suffit, Approve and Disapprove quand le refus doit être tracé.
- Limit Wait Time : borne la durée d'attente avant que l'exécution reprenne d'elle-même.
Send template
message.sendTemplateCe que tu vois dans n8n
Notes & cas d'usage
Envoie un template enregistré dans le compte WhatsApp Business, pas un texte libre. Template est une liste déroulante de noms de templates, et les valeurs variables voyagent à part.
Surveille l'erreur Bad request - please check your parameters : souvent, les données ne collent pas au template, par le type ou l'ordre des paramètres. Avec des expressions, un nœud Edit Fields (Set) en amont ou une valeur de repli garde le format valide.
Paramètres clés
- Template : le nom du template à envoyer, obligatoire et sélectionné dans la liste.
- Components : les valeurs injectées dans le template, ajoutées une par une via Add Component.
Media
3 opérationsUpload media
media.mediaUploadCe que tu vois dans n8n
Notes & cas d'usage
Transfère vers WhatsApp un fichier présent dans le workflow et le stocke sur un numéro, pour qu'un message ultérieur l'attache par identifiant au lieu de renvoyer le fichier entier.
Paramètres clés
- Sender Phone Number (or ID) : l'identifiant du numéro qui stocke le média.
- Property Name : le nom de la propriété binaire qui contient le fichier, un nom de champ et non une expression.
- Filename : rangé dans Additional Fields, le nom que prend le fichier côté WhatsApp.
Download media
media.mediaUrlGetCe que tu vois dans n8n
Notes & cas d'usage
Ramène dans le workflow un fichier hébergé chez WhatsApp. C'est par là qu'une photo, un message vocal ou un document reçu devient exploitable par les nœuds suivants.
Paramètres clés
- Media ID : l'identifiant du média, seul champ obligatoire de l'opération.
media.mediaUrlGet, la valeur visible en lisant le JSON d'un workflow.Delete media
media.mediaDeleteCe que tu vois dans n8n
Notes & cas d'usage
Supprime un fichier précédemment stocké sur WhatsApp. Rien d'autre dans le nœud ne fait le ménage après un téléversement, donc c'est l'opération qui empêche la médiathèque de gonfler indéfiniment.
Paramètres clés
- Media ID : l'identifiant du média à supprimer, celui que l'étape de téléversement a renvoyé un peu plus tôt dans l'exécution.
Besoin d'aide pour automatiser WhatsApp Business Cloud avec n8n ?
L'équipe te répond directement.
Chaque message est lu par une personne.
