Webhooks

Un webhook est la façon qu'a Formiqa de pousser les données dès qu'elles arrivent. Au lieu d'interroger sans cesse pour de nouvelles réponses, chaque formulaire peut appeler une URL que vous possédez à chaque fois qu'il est rempli — en envoyant la réponse au format JSON pour que vos propres systèmes réagissent en temps réel.

Activer un webhook

1. 1Ouvrez le formulaire dans le constructeur et rendez-vous dans le panneau Intégrations.
2. 2Activez les webhooks pour le formulaire.
3. 3Collez l'URL du webhook — le point de terminaison, de votre côté, qui recevra le POST.
4. 4Ajoutez éventuellement un secret, que Formiqa utilise pour signer chaque requête afin que vous puissiez la vérifier.
5. 5Enregistrez. Désormais, chaque réponse déclenche un envoi vers votre URL.

La charge utile

À chaque réponse, Formiqa envoie un POST HTTP avec un corps JSON. La charge utile contient :

• event — le type d'événement, toujours « form.submission » pour une nouvelle réponse.
• formId — l'identifiant du formulaire rempli.
• formTitle — le titre lisible du formulaire.
• submissionId — l'identifiant de cette réponse précise.
• data — un objet contenant les réponses, indexées par champ.
• submittedAt — l'horodatage de la réponse.

Vérifier les requêtes

Si vous définissez un secret, Formiqa inclut une signature HMAC-SHA256 de la requête dans l'en-tête X-Webhook-Secret. De votre côté, recalculez le HMAC-SHA256 du corps reçu avec le même secret et comparez-le à la valeur de l'en-tête. S'ils correspondent, la requête vient bien de Formiqa et n'a pas été altérée ; s'ils diffèrent, rejetez-la.

Ce que vous pouvez construire

Le webhook est volontairement générique, il s'adapte donc à presque tous les flux :

• Envoyer vers votre propre backend — écrivez la réponse dans votre base de données, déclenchez un traitement interne, ou postez un message dans vos propres outils.
• Connecter des outils d'automatisation — pointez le webhook vers un service tiers qui accepte un webhook entrant, comme Zapier ou Make, et construisez votre automatisation là-bas. Ce sont des outils externes qui acceptent un webhook, pas des intégrations natives de Formiqa.