Aller au contenu
Mail

Tape un mot pour chercher dans les pages.

↑↓ Choisir↵ OuvrirÉchap Fermer
Ouvrir Mail

Guides

Recevoir les réponses d'un formulaire par webhook

Faire envoyer chaque réponse de formulaire à ton application, signée, sans qu'elle ait besoin d'une clé d'API de Mail.

Un webhook est une adresse de ton application que Mail appelle dès qu’une réponse arrive dans un formulaire. Ton application n’interroge plus Mail et ne garde aucune clé d’API : elle vérifie seulement la signature de chaque message.

Avant de commencer : un formulaire (voir Créer un formulaire), une application qui sait recevoir un POST en https, et le rôle admin ou propriétaire de l’organisation.

  1. Ouvre la page Webhooks

    Dans Configuration, Webhooks, clique Ajouter une adresse.

  2. Colle l'adresse de ton application

    L’adresse doit être en https et publique. Une adresse locale (localhost, un numéro IP, un nom interne) est refusée. Laisse l’événement Réponse à un formulaire coché et, si besoin, choisis les formulaires concernés. Aucun coché : tous, y compris ceux que tu créeras plus tard.

  3. Copie le secret

    Mail affiche un secret qui commence par whsec_. Il ne s’affiche qu’une fois : copie-le dans ton application avant de fermer la fenêtre. Si tu le perds, supprime l’adresse et recrée-la.

  4. Vérifie la signature dans ton application

    Chaque message porte trois en-têtes. Ton application doit contrôler la signature et l’heure avant de lire le contenu. Le détail est dans la référence des webhooks.

Quand ton application ne répond pas

Mail attend une réponse 2xx en 10 secondes. Sinon il réessaie, jusqu’à huit essais en tout sur environ 28 heures. Dans Livraisons, chaque message montre ses essais, le code reçu, et le contenu envoyé. Renvoyer relance un message abandonné ou déjà livré : il garde le même identifiant, ton application doit donc savoir ignorer un message déjà traité.

Un message peut arriver deux fois. Pour ne rien créer en double, retiens l’identifiant du message (webhook-id) et celui de la réponse (data.id).

Pause, modification, suppression

L’interrupteur met une adresse en pause : plus rien n’est envoyé, les réponses restent dans Formulaires. Supprimer une adresse efface aussi son journal. Le journal des livraisons se garde 30 jours.