# 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.

## 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

```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": "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](https://nodium.io/fr/guides/24-hour-window). Pour ouvrir un Flow à quelqu'un qui n'a pas écrit, ou dans une diffusion, posez-le sur un bouton d'un [modèle](https://nodium.io/fr/features/templates-broadcasts) 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.

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