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.

Mis à jour le 10 novembre 2026Lire en Markdown

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.

Shell

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.

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.