Aller au contenu

API WhatsApp avec n8n : un workflow qui reçoit et répond

Pour relier l'API WhatsApp à n8n, installez les nœuds communautaires de Nodium : un déclencheur qui lance le workflow à chaque message reçu, signature vérifiée, et une action qui répond. Sans eux, un nœud Webhook et un nœud HTTP Request font le même travail, comme ci-dessous.

Mis à jour le 18 novembre 2026Lire en Markdown

Avec les nœuds Nodium

  • Dans n8n, Settings › Community Nodes › Install, puis @nodium.io/n8n-nodes-nodium.
  • Créez un identifiant Nodium API avec votre clé d'API.
  • Nodium Trigger, événement message.received : activer le workflow crée le webhook chez Nodium et vérifie la signature de chaque appel.
  • Nodium, Message › Send Text, avec le numéro {{ $json.data.channel_id }}, le destinataire {{ $json.data.from }} et la clé d'idempotence reply-{{ $json.id }}.

Le code est sur GitHub : Nodium-io/n8n-nodes-nodium.

Avec les seuls nœuds standards

  • Nœud Webhook — méthode POST, avec l'option Raw Body activée : la signature se calcule sur le corps exactement tel que reçu. Copiez son adresse de production.
  • Vérification de signature — l'en-tête X-Nodium-Signature vaut t=<horodatage>,v1=<signature>. Lisez d'abord le corps brut en texte avec un nœud Extract from File (Extract From Text File, propriété data) : une expression ne lit pas le contenu d'un fichier binaire. Puis, avec le nœud Crypto, calculez le HMAC-SHA256 de <horodatage>.<corps brut> avec le secret de votre webhook, en hexadécimal, et comparez-le à v1 dans un nœud If. Arrêtez le workflow s'ils diffèrent.
  • Nœud HTTP Request — méthode POST, adresse https://nodium.io/api/v1/messages, un identifiant Bearer qui porte votre clé d'API, et le corps JSON ci-dessous.

JSON

{ "channelId": "{{ $json.body.data.channel_id }}", "to": "{{ $json.body.data.from }}", "type": "text", "text": "You wrote: {{ $json.body.data.text }}", "idempotencyKey": "reply-{{ $json.body.id }}"}

Dire à Nodium où vous appeler

Déclarez l'adresse de production du nœud Webhook, dans la console sous Paramètres › Webhooks ou par l'appel ci-dessous. Le secret n'est montré qu'une fois : rangez-le dans un identifiant n8n.

Shell

curl https://nodium.io/api/v1/webhooks \ -H "Authorization: Bearer $NODIUM_KEY" \ -H "Content-Type: application/json" \ -d '{ "url": "https://your-app.example.com/webhooks/nodium", "events": ["message.received"] }'# → data.secret (whsec_…): shown once

Ensuite

  • La réponse ci-dessus est du texte libre : elle ne part que dans la fenêtre de 24 heures. Pour écrire en premier, envoyez un modèle avec "type": "template".
  • Gardez l'idempotencyKey : quand n8n relance un nœud, le message ne part qu'une fois.
  • Un agent IA dans n8n peut aussi piloter WhatsApp par le serveur MCP de Nodium.

Questions fréquentes

Existe-t-il un nœud n8n pour Nodium ?

Oui : le paquet communautaire @nodium.io/n8n-nodes-nodium, avec un déclencheur sur les messages reçus et une action qui envoie. Les nœuds Webhook et HTTP Request couvrent aussi toute l'API, qui est du REST simple.

Puis-je sauter la vérification de signature ?

Le workflow tournerait pour quiconque trouve son adresse. Vérifier la signature est ce qui prouve qu'un événement vient de Nodium.

Essayez avec votre propre numéro.

Build est gratuit : 3 000 messages par mois, sans carte.

Parlez à l'équipe Nodium

Dites-nous ce que vous branchez. Nous revenons vers vous sous un jour ouvré, avec un tarif adapté à vos numéros WhatsApp et à votre volume.