# 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'idempotence `reply-{{ $json.id }}`.

Le code est sur GitHub : [Nodium-io/n8n-nodes-nodium](https://github.com/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.

```bash
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](https://nodium.io/fr/guides/fenetre-de-24-heures). Pour écrire en premier, envoyez un [modèle](https://nodium.io/fr/fonctionnalites/modeles-et-diffusions) 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.

Mis à jour le 2026-11-18 · https://nodium.io/fr/guides/api-whatsapp-n8n
