API WhatsApp Flows : des formulaires dans la conversation

Un WhatsApp Flow est un formulaire qui s'ouvre dans la conversation : plusieurs écrans, des champs et des choix, sans quitter WhatsApp. Nodium gère sa vie chez Meta par une API REST (créer, versionner, prévisualiser, publier, envoyer) et livre chaque réponse à votre webhook.

Mis à jour le 10 novembre 2026Lire en Markdown

Ce que vous pouvez faire

POST /flows crée un brouillon chez Meta ; sans JSON à vous, il part d'une demande de devis en quatre écrans.
POST /flows/{id}/versions enregistre une nouvelle version, que Meta valide : validationErrors dit quoi corriger.
GET /flows/{id}/preview rend la page que Meta affiche : le formulaire comme sur un téléphone.
POST /flows/{id}/publish est définitif : un Flow publié ne se modifie plus. Pour le changer, dupliquez-le.
Un Flow dynamique appelle votre serveur entre deux écrans : Nodium déchiffre l'appel de Meta, le relaie vers votre adresse HTTPS et chiffre votre réponse.

Envoyer 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": "interactive",    "form": { "kind": "flow", "flowId": "<meta flow id>", "buttonLabel": "Book a slot" },    "idempotencyKey": "booking-1042-form"  }'

Un message Flow interactif part dans la fenêtre de 24 heures. Pour ouvrir un Flow à quelqu'un qui n'a pas écrit, ou dans une diffusion, posez-le sur un bouton d'un modèle approuvé.

Lire les réponses

Un formulaire rempli arrive en message.received, avec data.reply.kind à flow, les champs saisis, et votre propre flowToken si vous en avez envoyé un.

Questions fréquentes

Puis-je modifier un Flow publié ?

Non, c'est la règle de Meta : un Flow publié est définitif. Dupliquez-le en brouillon, modifiez le brouillon, publiez-le, puis dépréciez l'ancien.

Un Flow demande-t-il un serveur à moi ?

Pas toujours. Un Flow statique porte tout dans son JSON. Un Flow dynamique, qui va chercher des données entre deux écrans, appelle une adresse HTTPS à vous, à travers Nodium.