Formulaires WhatsApp

Un Flow est un formulaire natif : le client le remplit dans WhatsApp, sans navigateur ni lien externe. Utile pour une prise de commande, une réservation ou une qualification, là où une suite de questions-réponses serait pénible et perdrait la moitié des gens.

Cycle de vie

GET    /whatsapp/flows
POST   /whatsapp/flows
GET    /whatsapp/flows/{id}
PATCH  /whatsapp/flows/{id}
PUT    /whatsapp/flows/{id}/json
POST   /whatsapp/flows/{id}/publish
POST   /whatsapp/flows/{id}/deprecate
DELETE /whatsapp/flows/{id}

Un formulaire publié ne se modifie plus. C'est une règle de Meta : pour changer quoi que ce soit, on déprécie et on publie une nouvelle version. Prévois-le dans ton intégration plutôt que de le découvrir en production.

PUT /json accepte autoFix : les erreurs de structure les plus courantes sont corrigées au lieu de renvoyer un refus sec.

Envoyer un formulaire

Un formulaire se joint à un message, avec type: "flow" sur POST /whatsapp/messages. Le flow_token que tu passes te revient dans la réponse : c'est lui qui te permet de rattacher une soumission à un dossier.

Récupérer les réponses

GET /whatsapp/flows/{id}/responses
GET /whatsapp/flows/{id}/stats

C'est ce qu'une intégration vient chercher. Les réponses arrivent au fil de l'eau ; interroge périodiquement, ou branche ton webhook.

Écrans dynamiques

PUT /whatsapp/flows/{id}/endpoint

Déclare l'URL que Meta appelle pendant que le client remplit, pour alimenter un écran à partir de tes données - créneaux disponibles, stock restant, tarifs. Sans endpoint, le formulaire reste statique.

Aperçu

GET /whatsapp/flows/{id}/preview

Renvoie un lien d'aperçu, à ouvrir dans un navigateur pour voir le rendu réel avant publication.