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.
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'idempotencereply-{{ $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-Signaturevautt=<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 àv1dans un nœud If. Arrêtez le workflow s'ils diffèrent. - Nœud HTTP Request — méthode
POST, adressehttps://nodium.io/api/v1/messages, un identifiantBearerqui porte votre clé d'API, et le corps JSON ci-dessous.
{ "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.
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 onceEnsuite
- 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.