Webhooks

Bonjour les développeurs ! Le portail des développeurs de Typeform est désormais ouvert et propose notre gamme d’API ainsi que tout le nécessaire pour travailler avec notre plateforme. Venez jeter un coup d'œil !

Où souhaitez-vous que les données de votre typeform soient envoyées ? Utilisez des webhooks pour envoyer chaque réponse directement vers une application Web compatible ou une URL dès que le formulaire est rempli.

Qu'est-ce qu'un webhook ?

De manière générale, un webhook est simplement une notification envoyée sur le web, qui est déclenchée automatiquement dès qu'un événement spécifique se produit.

Dans Typeform, vous pouvez créer des webhooks qui se déclenchent lorsqu’un formulaire est entièrement rempli ou qu’une réponse partielle est enregistrée. Les données de réponse et les réponses enrichiessont envoyées dans le cadre des données de la charge utile (payload) du webhook vers l’URL de webhook configurée. Dans la plupart des cas, vous pouvez vous attendre à une livraison en quelques secondes. En particulier, pour chaque webhook associé à un formulaire, vous pouvez le configurer pour qu’il se déclenche dans l’un des cas suivants :

• Uniquement lors du remplissage complet du formulaire. Un répondant déclenchera le webhook au maximum une fois.
• Ou lors de réponses partielles et lorsque le formulaire est entièrement rempli. Un répondant peut déclencher le webhook plus de 2 fois (un formulaire peut comporter plus d’un point de remplissage partiel selon votre forfait).

Attention ! Un webhook ne peut pas être configuré pour se déclencher uniquement lors de réponses partielles.

Si un webhook échoue, Typeform tentera à nouveau d’envoyer la requête à votre point de terminaison selon des règles prédéfinies. En savoir plus sur les nouvelles tentatives d’envoi ici.

Les notifications de webhook Typeform sont envoyées via des requêtes POST, et le corps de la requête (contenant les données de réponse) est au format JSON . Votre point de terminaison de webhook doit utiliser HTTPS.

Les webhooks constituent une fonctionnalité avancée destinée aux utilisateurs de Typeform qui savent les manipuler. Veuillez noter que nous ne pouvons pas dépanner votre code ni fournir d'instructions de développement étape par étape !

Guide d’installation 

Vous pouvez créer une URL de test pour recueillir des réponses de test sur https://requestbin.com.

1. Ouvrez votre typeform depuis votre espace de travail.

2. Accédez au panneau Connecter et cliquez sur l'onglet Webhooks.

3. Cliquez sur Ajouter un webhook.

4. Saisissez une URL de destination. Typeform envoie les charges utiles de webhooks via des requêtes POST vers un point de terminaison HTTPS sécurisé. Cliquez sur Enregistrer le webhook.

Notez que votre URL de webhook doit commencer par https://. Les URL commençant par http:// ne sont pas prises en charge.

5. Vous serez redirigé vers l'onglet des webhooks. Par défaut, votre nouveau webhook sera réglé sur Désactivé jusqu'à ce que vous l'activiez en cliquant sur le bouton de bascule.

6. Pour tester votre webhook, cliquez sur le bouton Afficher les envois, suivi du bouton Envoyer une requête de test qui apparaît.

Vous pouvez voir vos ID d'envoi sur la gauche. Tous les envois de test sont marqués comme Test.
Cliquez sur Requête ou Réponse pour afficher les requêtes ou les réponses.

Attention! Si vous souhaitez renvoyer le test, assurez-vous que votre webhook est réglé sur Activé. 

7. Cliquez sur le X dans le coin supérieur droit pour revenir à l'onglet Webhooks.

8. Pour modifier votre webhook, cliquez sur le bouton Modifier situé à côté de celui-ci.

9. Une nouvelle fenêtre s’affiche. Vous pouvez y modifier l’URL du point de terminaison, ajouter un secret, activer ou désactiver la vérification SSL, sélectionner votre déclencheur (réponse complète ou réponses partielles et complètes) et supprimer votre webhook.

Si vous choisissez de supprimer le webhook, un message d'avertissement apparaîtra pour vérifier si vous souhaitez vraiment le faire.

10. Lorsque vous avez terminé de modifier votre webhook, cliquez sur Enregistrer les modifications pour revenir à l'onglet des webhooks.

Si votre webhook rencontre des erreurs, il peut être désactivé par l'équipe Typeform. Si cela se produit, vous recevrez une notification par e-mail de la part de Typeform afin de pouvoir examiner vos webhooks et prendre les mesures nécessaires. 

Si vous avez déjà configuré vos webhooks et rencontrez des problèmes, cette FAQ et ce guide de dépannage pourront peut-être vous aider à les résoudre.