Les webhooks standards permettent à Enquete d’envoyer automatiquement des informations liées aux enquêtes vers une autre application lorsqu’un événement sélectionné se produit.
Par exemple, lorsqu’un répondant soumet ou termine une enquête, Enquete peut envoyer directement les données de l’événement vers votre système de gestion de la relation client, votre plateforme de reporting, votre base de données interne, votre application d’assistance, votre plateforme marketing ou un autre service externe.
Cela aide votre organisation à automatiser les flux de travail et à transférer les données d’enquête entre différents systèmes sans devoir exporter régulièrement les réponses ni transférer les informations manuellement.
Ce guide explique comment créer, configurer, tester, surveiller et gérer les webhooks standards depuis l’interface Enquete.
Important :
Les webhooks standards sont destinés aux organisations ayant accès à un développeur ou à une équipe technique. Votre application réceptrice doit fournir un point de terminaison HTTPS accessible publiquement et capable de recevoir des requêtes HTTP POST.
Pour consulter la référence technique complète, notamment les charges utiles prises en charge, les en-têtes de webhook, la vérification des signatures, les schémas d’événements et les détails d’implémentation, consultez la documentation officielle des webhooks Enquete.
Un webhook standard est une connexion automatisée entre Enquete et une application externe.
Lorsqu’un événement se produit dans une enquête sélectionnée, Enquete envoie une requête HTTP POST à l’URL du point de terminaison configurée dans l’abonnement au webhook.
Selon le flux de travail de votre organisation, un webhook peut être utilisé pour :
Chaque webhook standard est associé à une enquête et à un type d’événement précis. Vous pouvez ainsi contrôler quelles activités déclenchent un envoi et vers quelle destination les informations sont transmises.
Avant de configurer un webhook standard, assurez-vous que votre équipe technique a préparé les éléments suivants :
Le point de terminaison récepteur doit répondre rapidement après avoir accepté une requête. Les opérations longues doivent normalement être transmises à une file d’attente ou à un système de traitement en arrière-plan une fois que le point de terminaison a renvoyé une réponse réussie.
Les développeurs doivent consulter la documentation officielle des webhooks avant d’implémenter le point de terminaison récepteur.
Depuis votre tableau de bord Enquete, sélectionnez Intégrations dans le menu supérieur.
Ouvrez Webhooks standards parmi les options d’intégration disponibles.
La vue d’ensemble des webhooks standards affiche tous les abonnements aux webhooks disponibles dans votre compte.
Depuis cette page, vous pouvez :
Dans la vue d’ensemble des webhooks standards, cliquez sur Ajouter un webhook.
Un formulaire de configuration s’ouvre.
Saisissez le point de terminaison HTTPS vers lequel Enquete doit envoyer les livraisons du webhook.
Par exemple :
https://example.com/api/enquete/webhookLe point de terminaison doit être accessible publiquement et pouvoir accepter des requêtes HTTP POST.
Les adresses localhost, les URL privées de développement et les pages nécessitant une connexion interactive ne peuvent pas recevoir de livraisons de webhook depuis Enquete.
Saisissez une description expliquant clairement l’objectif du webhook.
Par exemple :
Envoyer les réponses de satisfaction client terminées vers notre CRMUne description claire permet d’identifier plus facilement le webhook par la suite, en particulier lorsque votre organisation gère plusieurs abonnements.
Sélectionnez l’enquête dont les événements doivent déclencher le webhook.
Un abonnement à un webhook standard est associé à une seule enquête. Si vous devez envoyer des événements provenant de plusieurs enquêtes, créez un abonnement distinct pour chaque enquête.
Sélectionnez l’événement qui doit déclencher la livraison du webhook.
Les événements disponibles dans l’interface des webhooks standards peuvent inclure :
Les événements disponibles peuvent dépendre de la configuration actuelle d’Enquete et des fonctionnalités activées pour votre compte.
Choisissez si le webhook doit être actif immédiatement.
Lorsqu’un webhook est actif, Enquete envoie des livraisons chaque fois que l’événement sélectionné se produit.
Lorsqu’il est inactif, sa configuration reste disponible, mais les livraisons d’événements en direct sont suspendues.
Vous pouvez laisser un webhook inactif pendant que votre équipe technique termine la préparation ou les tests du point de terminaison récepteur.
Cliquez sur Enregistrer pour créer l’abonnement au webhook.
Le nouveau webhook apparaît dans la vue d’ensemble des webhooks standards et peut être testé immédiatement.
Chaque webhook standard possède un secret. L’application réceptrice utilise ce secret pour vérifier qu’une requête entrante provient réellement d’Enquete.
Le secret du webhook doit être traité comme un mot de passe ou un identifiant API privé.
Localisez le webhook dans la vue d’ensemble et cliquez sur l’icône en forme d’œil.
Le secret s’affiche temporairement.
Cliquez sur l’icône du presse-papiers pour copier le secret.
Pour des raisons de sécurité, le secret est automatiquement masqué de nouveau après environ dix secondes.
Transmettez le secret au développeur responsable du point de terminaison récepteur et stockez-le dans un emplacement sécurisé côté serveur, par exemple :
Ne stockez pas le secret dans du JavaScript frontend, des dépôts publics, des captures d’écran, des documents partagés ou des messages d’assistance accessibles à des utilisateurs non autorisés.
Vous devez tester chaque webhook avant de l’utiliser dans un flux de travail en production.
Une livraison de test permet de confirmer que le point de terminaison est accessible et que le serveur récepteur renvoie une réponse appropriée.
Recherchez l’abonnement au webhook dans la vue d’ensemble des webhooks standards.
Cliquez sur l’icône en forme d’éclair sur la ligne du webhook.
Enquete envoie une requête de test au point de terminaison configuré.
Une notification intégrée affiche le statut HTTP renvoyé par le point de terminaison.
Une livraison réussie renvoie normalement un code de statut compris entre 200 et 299, par exemple :
Si le test échoue, ouvrez les journaux de livraison pour consulter le statut de la réponse, le corps de la réponse, les informations d’erreur et la durée de la requête.
Vous pouvez mettre à jour un webhook existant lorsque son point de terminaison, son enquête, son type d’événement, sa description ou son statut d’activation change.
Localisez le webhook et sélectionnez l’action Modifier.
Vous pouvez mettre à jour des paramètres tels que :
Enregistrez le webhook après avoir effectué vos modifications.
La configuration mise à jour sera utilisée pour les futures livraisons.
Envoyez toujours une nouvelle livraison de test après avoir modifié l’URL du point de terminaison, l’enquête ou le type d’événement.
Les journaux de livraison affichent les requêtes envoyées par Enquete à votre point de terminaison et les réponses renvoyées par le serveur récepteur.
Utilisez ces journaux pour surveiller l’état de votre intégration et examiner les livraisons ayant échoué.
Localisez l’abonnement au webhook et cliquez sur l’icône Afficher les journaux située à côté du bouton de suppression.
Vous pouvez filtrer les livraisons selon les catégories suivantes :
Développez une entrée de livraison pour consulter les informations de diagnostic disponibles.
L’enregistrement de livraison peut inclure :
Les journaux de livraison sont particulièrement utiles après :
Chaque requête de webhook contient des en-têtes permettant à l’application réceptrice d’identifier, de vérifier et de suivre la livraison.
| En-tête | Description |
|---|---|
| X-Enquete-Signature | Contient la signature utilisée pour vérifier que la requête provient d’Enquete. |
| X-Enquete-Event | Identifie le type d’événement ayant déclenché la livraison. |
| X-Enquete-Delivery | Contient un identifiant unique de livraison utilisé pour le suivi et la prévention des doublons. |
Votre équipe technique doit utiliser l’en-tête de signature pour authentifier les requêtes entrantes et l’en-tête de livraison pour empêcher qu’un même événement soit traité plusieurs fois.
Pour connaître le format exact de la signature, le schéma de la charge utile et consulter des exemples d’implémentation, reportez-vous à la documentation officielle des webhooks.
Une livraison de webhook peut être tentée plusieurs fois si la première requête échoue, dépasse le délai d’attente ou ne renvoie pas de réponse réussie.
Cela signifie que l’application réceptrice doit être capable de reconnaître et d’ignorer en toute sécurité une livraison ayant déjà été traitée.
Chaque requête contient une valeur unique dans l’en-tête X-Enquete-Delivery.
Votre équipe technique doit utiliser cette valeur comme clé d’idempotence.
Un processus classique de prévention des doublons consiste à :
Les identifiants de livraison déjà traités doivent être conservés pendant une période adaptée à la politique d’intégration et de nouvelle tentative de votre organisation.
Désactivez un webhook lorsque vous souhaitez interrompre temporairement les livraisons sans supprimer sa configuration.
Vous pouvez désactiver un webhook lorsque :
Lorsque le webhook est de nouveau activé, les futurs événements correspondants peuvent être livrés.
Les événements qui se produisent pendant que le webhook est inactif peuvent ne pas être livrés automatiquement ultérieurement.
Supprimez un webhook lorsque l’abonnement n’est plus nécessaire.
Localisez le webhook et cliquez sur l’action Supprimer.
Confirmez que vous souhaitez supprimer définitivement l’abonnement au webhook.
Après la suppression, Enquete n’enverra plus de nouvelles livraisons pour ce webhook.
Les anciens enregistrements de livraison peuvent rester disponibles dans les données du backend à des fins d’audit, de dépannage ou d’exploitation.
Important : Si vous souhaitez uniquement suspendre temporairement le webhook, désactivez-le au lieu de le supprimer.
Vérifiez les éléments suivants :
Les tâches longues doivent être placées dans une file d’attente pour être traitées en arrière-plan au lieu d’être entièrement exécutées avant que le serveur ne renvoie sa réponse.
Demandez à votre équipe technique de confirmer que :
La vérification de la signature est une tâche d’implémentation technique. Consultez la documentation officielle des webhooks pour obtenir les instructions de vérification actuelles.
Vérifiez les éléments suivants :
Une réponse 401 ou 403 signifie généralement que le serveur récepteur a rejeté la requête en raison d’une règle d’authentification ou d’autorisation.
Vérifiez si :
Une réponse 404 signifie généralement que l’URL du point de terminaison ne correspond à aucune route disponible sur le serveur récepteur.
Vérifiez l’URL complète et confirmez que la route existe et accepte les requêtes HTTP POST.
Une réponse 500 indique qu’une erreur s’est produite dans l’application réceptrice.
Votre équipe technique doit consulter les journaux du serveur de l’application réceptrice ainsi que la charge utile de la livraison et l’identifiant de livraison affichés dans Enquete.
Les requêtes de webhook peuvent être retentées après un échec ou un dépassement de délai.
Votre équipe technique doit utiliser la valeur X-Enquete-Delivery pour identifier les livraisons déjà traitées.
Avant d’utiliser un webhook standard dans un flux de travail en production, confirmez que vous avez effectué les opérations suivantes :
Une fois le webhook mis en production, consultez régulièrement les livraisons ayant échoué et les performances du point de terminaison afin de vérifier que l’intégration continue de fonctionner correctement.
Pour les champs de la charge utile, les schémas d’événements, les exemples de vérification de signature et les autres instructions destinées aux développeurs, consultez toujours la documentation officielle des webhooks Enquete.