# Modèles de message WhatsApp et diffusions par l'API

Un modèle WhatsApp est un message approuvé d'avance par Meta : le seul moyen d'écrire en premier à un client, ou de lui écrire après 24 heures de silence. Avec Nodium, vous créez les modèles, les déployez et suivez la revue de Meta par l'API, puis vous les envoyez un par un ou en diffusion à de nombreux contacts.

## Les modèles

- `POST /templates` écrit un modèle pour un client ; `POST /templates/{id}/deploy` le soumet aux comptes WhatsApp des numéros de ce client. Les numéros branchés ensuite le reçoivent d'eux-mêmes.
- Meta le relit compte par compte ; chaque changement d'état arrive à votre webhook.
- Les emplacements sont numérotés (`{{1}}`) ou nommés (`{{client_name}}`), remplis dans `variables`. Un emplacement laissé vide est refusé avant tout envoi.
- L'en-tête peut être un texte, une image, une vidéo ou un document ; les boutons ouvrent un lien, copient un code ou ouvrent un [Flow](https://nodium.io/fr/features/flows).

```bash
curl https://nodium.io/api/v1/messages \
  -H "Authorization: Bearer $NODIUM_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "channelId": "<channel id>",
    "to": "+33612345678",
    "type": "template",
    "templateName": "order_ready",
    "templateLanguage": "en",
    "variables": { "1": "Karim" },
    "idempotencyKey": "order-1042-confirmation"
  }'
```

## Les diffusions

- `POST /broadcasts/preview` compte qui la recevrait ; `POST /broadcasts` envoie un modèle à de nombreux contacts, tout de suite ou à `scheduledAt`.
- Le consentement marketing est respecté : un contact qui a touché **Stop** ne reçoit plus de modèles marketing.
- Le palier de messagerie du numéro est vérifié avant le départ : plus de destinataires que Meta n'en autorise par 24 heures, et la diffusion est refusée, pas envoyée à moitié.
- Une diffusion dont les envois sont refusés à répétition pour une raison de compte est mise en pause ; corrigez la cause, puis reprenez-la. Rien ne part deux fois.

## Ce que facture Meta

Chaque modèle est facturé par Meta au compte WhatsApp Business du numéro, selon sa catégorie et le pays du destinataire. Voir [les prix de Meta expliqués](https://nodium.io/fr/guides/meta-pricing).

## Questions fréquentes

### Combien de temps Meta met-il à approuver un modèle ?

C'est Meta qui décide, le plus souvent en quelques minutes à quelques heures. Nodium ne prend pas part à la revue : il soumet le modèle et rapporte chaque changement d'état par webhook.

### Puis-je envoyer un modèle à quelqu'un qui ne m'a jamais écrit ?

Oui, c'est le rôle des modèles. Pour un modèle marketing, la personne doit avoir accepté de recevoir vos messages.

Mis à jour le 2026-11-10 · https://nodium.io/fr/features/templates-broadcasts