Webhooks sortants

À propos des Webhooks sortants

En termes généraux, un webhook est un moyen de communication automatique entre applications. Autrement dit, un message est envoyé sur le web, déclenché automatiquement chaque fois qu'un événement spécifique se produit. L'automatisation du webhook sortant est déclenchée lorsqu'un répondant termine votre sondage et que sa réponse est envoyée à un système externe de votre choix.

Chaque fois que l'automatisation par webhook sortant est déclenchée, elle crée une nouvelle exécution d'automatisation. Ces exécutions représentent les instances où votre webhook sortant envoie une réponse de sondage au système externe spécifié. Avec Enalyzer, vous pouvez facilement visualiser et gérer vos exécutions d'automatisation.

Les webhooks sont destinés aux utilisateurs qui savent comment les gérer. Veuillez noter que nous ne pouvons pas dépanner votre code ou fournir des instructions de développement étape par étape.

Créez une automatisation de Webhook sortant

Pour configurer une automatisation de webhook sortant, vous devez :

1. Aller dans la zone des automatisations () et cliquer sur Enalyzer dans le menu latéral.
2. Dans le menu latéral, cliquez sur Enalyzer.
3. Cliquez sur créer une automatisation. Si vous avez déjà une ou plusieurs automatisations, cliquez sur l'icône d'ajout d'automatisation () pour ajouter une automatisation.
4. Sélectionnez l'option webhooks et cliquez sur webhook sortant.
5. Choisissez quelles variables vous souhaitez inclure dans votre transfert. Vous pouvez choisir d'inclure toutes les variables ou des variables spécifiques dans votre transfert de données.
   1. Cette option inclura toutes vos questions d'enquête et variables de contexte dans le transfert de données.
      1. Utilisez le menu déroulant pour sélectionner l'option inclure toutes les variables
      2. Cliquez sur suivant.
   2. Cette option vous permet de sélectionner les questions d'enquête et les variables de contexte à inclure dans votre transfert de données.
      1. Utilisez le menu déroulant pour sélectionner l'option inclure des variables spécifiques et cliquez sur suivant.
      2. Sélectionnez les questions et les variables de contexte que vous souhaitez inclure dans votre transfert de données et cliquez sur ajouter.
6. Sélectionnez les étiquettes de variables que le webhook doit utiliser. Vous pouvez choisir entre :
   • Étiquettes générées automatiquement: celles-ci sont générées par Enalyzer et sont les mêmes étiquettes que dans les téléchargements de données de réponse.
   • Étiquettes de données: Vous pouvez utiliser les étiquettes de données que vous pouvez personnaliser vous-même dans les paramètres de votre enquête.
7. Ajoutez l'URL vers laquelle l'automatisation de webhook enverra les données.
8. Cliquez sur le bouton tester la connexion. Une fois votre connexion réussie, cliquez sur suivant.
9. Nommez votre automatisation et cliquez sur suivant.
10. Définissez le statut de l'automatisation. Par défaut, elle est activée, cependant, vous pouvez la désactiver avant de la créer.
11. Lorsque vous êtes prêt à créer votre automatisation, cliquez sur terminé.

Personnaliser les étiquettes de données

Lorsque vous créez une variable de fond ou une question, Enalyzer génère automatiquement une étiquette que vous pouvez trouver dans les téléchargements de données de réponses. Les étiquettes de données vous permettent de personnaliser les étiquettes pour vos variables de fond d'enquête et questions pour les webhooks sortants afin de contrôler la sortie des appels API.

Vos étiquettes de données sont définies dans les paramètres de votre enquête, tout ce que vous avez à faire est :

1. Aller à la zone des enquêtes () et ouvrir votre enquête.
2. Dans le menu latéral, cliquez sur paramètres.
3. Sous les paramètres de données, cliquez sur étiquettes de données.
4. Vous verrez un aperçu de toutes les variables d'enquête (variables de fond et éléments de question) sur le côté gauche. Sur le côté droit, vous verrez vos étiquettes de données. Par défaut, les étiquettes de données sont générées automatiquement, en fonction des variables de fond/éléments d'enquête correspondants, cependant, vous pouvez définir vos propres valeurs.

Les étiquettes de données doivent être uniques, ne peuvent pas contenir de caractères spéciaux et sont limitées à 100 caractères.

Les étiquettes de données ne peuvent être définies que pour les variables de fond et les questions mais pas pour les options de réponse.

Les étiquettes de données ne sont pas copiées lors de la copie de questions, mais elles le sont lors de la copie d'enquêtes ou lorsque l'enquête est partagée comme modèle.

Détails de l'exécution de l'automatisation

Chaque fois que l'automatisation par webhook sortant est exécutée, elle crée une nouvelle exécution. Les exécutions d'automatisation sont les instances lorsque votre webhook sortant transfère une réponse d'enquête au système externe spécifié. Une fois que l'automatisation par webhook sortant commence à s'exécuter, vous pouvez voir les exécutions d'automatisation qu'elle crée. Chaque exécution d'automatisation peut avoir un statut différent. Les statuts possibles sont:

• Planifié : l'automatisation par webhook sortant a été programmée pour un moment ultérieur mais n'a pas encore été exécutée.
• Échoué : l'automatisation par webhook sortant a rencontré une erreur et a échoué à s'exécuter.
• En cours : l'automatisation par webhook sortant est actuellement en cours d'exécution.
• Réussi : l'automatisation par webhook sortant a été complétée avec succès et la réponse d'enquête a été envoyée au système externe.

Pour voir les détails concernant une exécution d'automatisation, tout ce que vous avez à faire est :

1. Allez dans la zone des automatisations () et cliquez sur Enalyzer dans le menu latéral.
2. Dans le menu latéral, cliquez sur Enalyzer.
3. Cliquez sur l'automatisation.
4. Sous journal, cliquez sur exécutions d'automatisation.
5. Pour voir les détails d'une exécution d'automatisation, cliquez simplement sur l'exécution.
6. Les détails de l'exécution d'automatisation incluent :
   • Prénom et nom : l'exécution affichera le prénom et le nom du répondant s'ils sont disponibles.
   • Statut : le statut de l'exécution, ainsi que la date et l'heure à laquelle il a obtenu ce statut.
   • Date et heure de création : la date et l'heure de création de l'exécution.
   • URL de push : l'URL où la réponse de l'enquête a été publiée.
   • Message sortant : les données qui ont été envoyées au système externe.

Les exécutions provenant d'enquêtes anonymes n'afficheront pas les prénoms, noms ou e-mails des répondants. Au lieu de cela, l'exécution sera nommée "Anonyme".

Filtrage automatisé des exécutions

Vous pouvez filtrer vos exécutions automatisées par statut, période ou nom. Cela vous aidera à trier vos exécutions et à les gérer plus facilement, par exemple, vous pouvez trouver toutes les exécutions échouées et voir ce qui s'est passé ou les relancer.

Pour filtrer vos exécutions automatisées, vous devez :

1. Aller dans la zone des automatisations () et cliquer sur Enalyzer dans le menu latéral.
2. Dans le menu latéral, cliquer sur Enalyzer.
3. Cliquer sur l'automatisation.
4. Sous log, cliquer sur exécutions automatisées.
5. Cliquer sur le bouton filtrer.
6. Vous avez les options suivantes pour filtrer les exécutions, et vous pouvez ajouter autant de filtres que nécessaire pour les détailler :
   • Recherche par nom ou adresse e-mail : Tapez une adresse e-mail ou un nom dans le champ de recherche. Cela se réfère à la valeur de la réponse au sondage.
   • Statut : Filtrer par le statut de l'exécution.
   • Période : Filtrer par la période de temps basée sur la date de création de l'exécution.
     

     Les exécutions automatisées sont uniquement stockées pendant 14 jours, par conséquent, le filtre de période est limité à 14 jours dans le passé.

7. Une fois que vous avez ajouté tous les filtres, cliquez sur le bouton appliquer pour filtrer la liste des exécutions automatisées et fermer le menu latéral d'édition des filtres d'exécutions.

Relancement des automatisations

Il y a plusieurs raisons pour lesquelles vous pourriez vouloir relancer une exécution. La plus courante est si elle a échoué, cependant, vous pourriez vouloir renvoyer les données ou lancer une exécution qui a été planifiée pour plus tard. Pour relancer vos exécutions, tout ce que vous avez à faire est :

1. Aller à la zone d'automatisations () et cliquer sur Enalyzer dans le menu latéral.
2. Dans le menu latéral, cliquez sur Enalyzer.
3. Cliquez sur l'automatisation.
4. Sous journal, cliquez sur exécutions d'automatisation.
5. Cliquez sur le menu des actions et sélectionnez relancer.
6. Sélectionnez l'exécution ou les exécutions que vous souhaitez relancer et cliquez sur le bouton relancer.

Recevoir des Notifications d'Erreur

Les webhooks sortants peuvent échouer pour différentes raisons et entraîner la désactivation de votre automatisation. Quelle que soit la raison, vous pouvez activer les notifications d'erreur par email pour votre automatisation. Vous pouvez définir la ou les personne(s) qui doivent recevoir ces notifications.

Pour activer les notifications d'erreur, vous devez :

1. Aller dans la zone d'automatisations () et cliquer sur Enalyzer dans le menu latéral.
2. Cliquer sur l'automatisation pour laquelle vous souhaitez activer les notifications d'erreur.
3. Dans les notifications d'erreur, activer le paramètre notifications par email.
4. Cliquer sur ajouter un destinataire et entrer l'adresse email qui recevra les emails de notification d'erreur. Répétez cette étape pour ajouter d'autres destinataires.
5. Vos modifications seront sauvegardées immédiatement.