Ajouter un webhook

Formix appelle votre adresse https:// dès qu’un client remplit un formulaire.

À quoi ça sert

Être prévenu en temps réel dans votre propre système (dossier, CRM, automatisation).

Prérequis et forfait

Une adresse https:// publique qui accepte les requêtes POST. Maximum 10 webhooks par compte.

Étapes

1. « Paramètres » → section « Webhooks ».
2. Dans le champ « Adresse du webhook » (https://exemple.com/webhook), saisissez l’adresse de votre système.
3. Cliquez sur « Ajouter » : le message « Webhook ajouté. » s’affiche.
4. La ligne du webhook indique l’adresse, l’événement (form.completed) et « dernier envoi : (code) » après la première livraison.
5. Pour retirer un webhook, cliquez sur « Supprimer » sur sa ligne.

Résultat attendu

À chaque formulaire rempli, Formix envoie un POST JSON : {"id","event","created","data":{"form":{…},"send":{…},"answers":[{"label","type","value"}]}} avec les en-têtes X-Formix-Event, X-Formix-Delivery et X-Formix-Signature.

Astuces

• Le secret de signature (whsec_…) n’est affiché nulle part dans l’écran : lisez-le avec l’API (GET r=hooks, champ secret).
• Les adresses privées ou réservées sont bloquées (protection contre les attaques SSRF) ; http:// n’est accepté que si l’exploitant l’autorise.
• Les webhooks créés dans l’écran ne reçoivent que form.completed.

Problèmes fréquents

« Adresse invalide : elle doit commencer par https://. »

Utilisez une adresse https:// complète, sans identifiant:motdepasse@.

« Maximum 10 webhooks. »

Supprimez-en un.

« dernier envoi : 0 »

Formix n’a pas pu joindre l’adresse (introuvable, certificat, délai dépassé, adresse privée refusée). Voir « Statut et nouveaux essais ».

Pages concernées

Paramètres Référence de l’API

Ces pages demandent d’être connecté.

Articles liés