Connecter WhatsApp à n8n avec la Cloud API officielle

Comment un message WhatsApp atteint-il un workflow n8n ?

Meta transmet chaque message envoyé au numéro à une URL unique que vous choisissez, via une requête HTTP POST. Cette URL constitue toute l’intégration. Placez un nœud Webhook n8n sur une URL de production, définissez-la comme destination du webhook du numéro, puis le workflow s’exécute à chaque message entrant.

Le payload contient l’expéditeur, le texte ou la référence du média, un horodatage et l’identifiant du message. À partir de là, c’est un workflow n8n classique : vous pouvez orienter le traitement selon le contenu, rechercher le client, appeler vos autres services et décider de répondre ou non.

Avec Coexistence, le même message apparaît aussi dans l’application WhatsApp Business du téléphone. Un humain peut y répondre. Le workflow voit ce que l’humain a envoyé, et l’humain voit ce que le workflow a envoyé : leurs réponses ne se chevauchent donc pas.

{
  "from": "14155550188",
  "id": "wamid.HBgLMTQxNTU1NTAxODgVAgAS",
  "timestamp": "1758412800",
  "type": "text",
  "text": { "body": "do you have anything friday?" }
}

Comment le workflow envoie-t-il une réponse ?

Avec un nœud HTTP Request dirigé vers la Cloud API, en utilisant l’identifiant du numéro de téléphone et le token d’accès du numéro. Vous pouvez consulter ces deux éléments dans le dashboard ou via le connecteur MCP si vous préférez qu’un assistant les récupère.

Le contenu à envoyer dépend du délai, et c’est là que les problèmes surviennent. Dans les 24 heures suivant le dernier message du client, le texte libre fonctionne et la réponse correspond à ce que le workflow a composé. Au-delà, seul un template déjà approuvé par Meta est accepté. Un workflow qui envoie uniquement du texte libre semble parfait pendant les tests, car ceux-ci ont toujours lieu quelques secondes après un message, puis il cesse de fonctionner lors du premier vrai cas survenu pendant la nuit.

La structure fiable consiste à créer une branche : vérifiez depuis combien de temps le dernier message entrant a été reçu, puis choisissez le texte libre ou un template.

n8n peut-il aussi utiliser le connecteur MCP ?

Oui, et n8n est particulier sur ce point. Son nœud MCP Client Tool se connecte à un serveur MCP distant et prend en charge OAuth2, ce dont le nôtre a besoin. Un nœud AI Agent dans un workflow peut donc appeler directement nos outils.

C’est utile à savoir, car la plupart des plateformes d’automatisation ne le permettent pas. Make et Zapier exécutent tous deux leurs propres serveurs MCP et aucun des deux n’agit comme client : ils ne peuvent donc pas joindre un serveur tiers. n8n le peut.

Ce connecteur sert surtout à la partie action : un nœud agent peut décider d’envoyer un message, de vérifier l’état d’un numéro ou de consulter le statut d’approbation d’un template pendant l’exécution d’un workflow. Il ne peut toutefois pas remplacer le webhook, car MCP ne sait pas être réveillé par un message entrant.

Lequel des deux un workflow doit-il utiliser ?

Les deux, pour des rôles différents : ce partage n’est pas une préférence.

Le webhook est le point de départ. Un client écrit, Meta transmet le message à votre nœud Webhook, puis le workflow s’exécute. Aucun outil ne propose d’équivalent MCP, car le protocole repose sur une requête et une réponse plutôt que sur un appel entrant.

Le MCP Client Tool permet à un agent situé dans ce workflow d’agir sans que vous codiez l’appel en dur. Si le workflow sait déjà exactement quoi envoyer, un nœud HTTP Request dirigé vers la Cloud API est plus simple et comporte moins de risques d’erreur. Si un agent doit décider, le connecteur lui fournit les onze outils et les règles décrites avec chacun, notamment la fenêtre de 24 heures.

Qu’est-ce qui distingue cette solution des nœuds WhatsApp n8n déjà utilisés ?

La plupart des configurations WhatsApp n8n que vous trouverez utilisent une passerelle non officielle qui se connecte comme un appareil lié. Elles sont rapides à mettre en place, mais mettent le numéro en danger, car ce mécanisme enfreint les conditions d’utilisation de WhatsApp et Meta détecte le schéma du trafic, pas seulement la bibliothèque utilisée.

L’autre voie courante est l’API officielle sans Coexistence. Elle fonctionne, mais migre le numéro. L’application WhatsApp Business cesse alors de fonctionner avec celui-ci, et l’équipe qui répondait toute la journée doit passer à un nouvel outil. Pour beaucoup de petites entreprises, c’est rédhibitoire, ce qui explique pourquoi tant d’entre elles ont d’abord utilisé des passerelles non officielles.

Coexistence apporte la combinaison qui manquait : l’API officielle, avec un téléphone qui continue de fonctionner.

Erreurs courantes

• Utiliser une URL de test n8n comme destination du webhook. Elle cesse d’écouter lorsque l’éditeur est fermé, et les messages ne sont alors transmis à personne.
• Ne pas répondre à la requête de vérification de Meta. Meta envoie un GET avec un challenge avant toute livraison ; un nœud qui ne le renvoie pas ne reçoit jamais de message.
• Répondre en texte libre au-delà de la fenêtre de 24 heures. L’échec est silencieux du point de vue du workflow, et seul un template approuvé est accepté.

Questions fréquemment posées

Poursuivre la lecture