Comment envoyer les données de l’événement WalkMe aux systèmes tierces à l’aide de Webhooks
Aperçu général
Prenez des décisions fondées sur les données en temps réel ou déclenchez des expériences sur le champ en créant et en utilisant Webhooks (ou rappels) pour envoyer les données de l’événement WalkMe aux systèmes tierces que vous utilisez pour obtenir des résultats spécifiques.
Webhooks fournit des informations WalkMe Event en temps réel sur le système de votre choix, dès qu’un événement se produit. Cela signifie que vous recevez des informations sans délais, pour que vos équipes puissent prendre des mesures immédiates en se fondant sur des informations urgentes.
Webhooks peut être utilisé pour ajouter les données de l’événement WalkMe à votre outil d’analyse décisionnel ou pour déclencher des API provenant de tierces. Maintenant, lorsqu’un utilisateur clique sur un ShoutOut, vous pouvez l’ajouter à une liste de messagerie électronique dans votre système d’e-mail marketing, ou lorsqu’ils répondent à une enquête NPS, vous pouvez recevoir une notification instantanée sur un canal de Slack. Avec Webhooks, WalkMe peut être intégré directement dans vos flux de travail, sans intervention de la R&D.
Pour en savoir plus sur les Webhooks, consultez notre article Qu’est-ce que sont les Webhooks ?
Cas d’utilisation
- Intégrer les données de l’événement WalkMe dans votre outil d’analyse décisionnel
- Achevez la première étape de l’assistant Webhook avec Sélectionner l’événement :
- Envoyer instantanément des notifications directement sur les canaux de Slack après l’intervention des utilisateurs
Étapes pour envoyer les données WalkMe à l’aide de Webhooks
-
- Connectez-vous sur votre compte Insights ;
- Cliquez sur Integrations dans la barre latérale gauche :
- Cliquez sur Webhooks :
- Cliquez sur + NEW WEBHOOK :
- Cela déclenchera l’assistant de création du Webhook.
- Donnez à votre webhook un nom grâce auquel vous serez en mesure de l’identifier plus tard :
- Cliquez sur CONTINUE .
- Achevez la première étape de l’assistant Webhook avec Sélectionner l’événement :
- Sélectionnez un événement WalkMe dans le menu déroulant de l’événement :
- Après avoir sélectionné l’événement WalkMe, sélectionnez une condition d’instruction et la saisie le cas échéant :
- Cliquez sur le triangle de la section déroulante Advanced (OPTIONNEL) si vous souhaitez spécifier les propriétés de votre événement choisi pour lequel vous souhaitez recevoir un appel Webhook :
- Le cas échéant, vous pouvez renommer les propriétés pour les faire correspondre aux attributs attendus du système de destination. Si vous ne les renommez pas, ce sont les valeurs que vous recevrez dans l’appel Webhook.
- Aucun espace n’est autorisé dans le nom de la propriété.
- Nous vous recommandons de séparer les mots en utilisant un « _ » ou le camelCase.
- Vous pouvez également définir des propriétés statiques supplémentaires à envoyer avec l’appel Webhook.
- Cliquez sur le bouton + ADD PROPERTY (ajouter des propriétés).
- Aucun espace n’est autorisé dans la clé ou la valeur.
- Nous vous recommandons de séparer les mots en utilisant un « _ » ou le camelCase.
- Le cas échéant, vous pouvez renommer les propriétés pour les faire correspondre aux attributs attendus du système de destination. Si vous ne les renommez pas, ce sont les valeurs que vous recevrez dans l’appel Webhook.
- Sélectionnez un événement WalkMe dans le menu déroulant de l’événement :
- Achevez la deuxième étape de l’assistant Webhook avec Sélectionner la destination :
- Saisissez le nom de la plateforme du tierce (système de destination) dans lequel vous souhaitez les données de l’événement (par exemple, Heap Analytics, Mixpanel, Google Analytics, etc.) :
- Configurez le type de demarche et l’URL de destination :
- Ils spécifient comment et où effectuer l’appel Webhook ;
- Ces détails peuvent être trouvés dans la documentation de l’API du système de destination.
- Sélectionnez un type d’authentification et saisissez les valeurs (OPTIONNEL) ;
- Consultez la documentation de l’API du système de destination pour comprendre si cela est nécessaire.
- WalkMe prend en charge les méthodes d’authentification suivantes :
- Aucune authentification
- Le jeton du porteur nécessite un jeton.
- L’authentification simple nécessite le nom d’utilisateur et le mot de passe.
- OAuth 2.0
- Saisissez les valeurs de l’en-tête requises pour effectuer l’appel Webhook (OPTIONNEL) ;
- Consultez la documentation de l’API du système de destination pour comprendre si cela est nécessaire.
- Examinez vos informations et cliquez sur le bouton SAVE.
- Vous recevrez alors un pop-up vous indiquant que vous avez besoin d’une publication vierge dans l’Éditeur. Veuillez la faire :
- Saisissez le nom de la plateforme du tierce (système de destination) dans lequel vous souhaitez les données de l’événement (par exemple, Heap Analytics, Mixpanel, Google Analytics, etc.) :
- Connectez-vous sur votre compte Insights ;
Conseil de pro : vous pouvez gérer vos destinations dans l’écran des paramètres DESTINATIONS dans la section Integrations Webhooks qui se trouve dans Insights :
-
- Publiez votre webhook (SEULEMENT SI C’EST VOTRE PREMIER WEBHOOK) :
- Connectez-vous sur votre compte d’Éditeur WalkMe.
- Cliquez sur Menu dans la barre d’administration bleue :
- Sélectionnez l’environnement dans lequel vous souhaitez publier le webhook.
- Décochez tous les éléments et cliquez sur le bouton Publish.
- Cela s’appelle une « publication vierge » vous n’avez pas publié d’éléments WalkMe.
- Cela s’appelle une « publication vierge » vous n’avez pas publié d’éléments WalkMe.
- Vérifiez que vous avez réussi à configurer le webhook comme suit :
- Saisissez votre demande.
- Effectuez l’événement que Webhook suit.
- Vérifiez que le système de destination que vous avez configuré reçoit l’appel Webhook et exécute le résultat souhaité.
- Publiez votre webhook (SEULEMENT SI C’EST VOTRE PREMIER WEBHOOK) :
Liste des événements disponibles
Le tableau ci-dessous montre toutes les options disponibles pour créer les événements Webhook :
Groupe | Nom | Description |
Smart Walk-Thru |
Étape Smart Walk-Thru lue | Recevoir les événements avec une étape Smart Walk-Thru spécifique |
Objectif du Smart Walk-Thru atteint | Recevoir les événements avec les Objectifs que vous avez définis dans un Smart Walk-Thru | |
Smart Walk-Thru commencé | Recevoir les événements lorsque un Smart Walk-Thru s’affiche | |
Échec du Smart Walk-Thru | Recevoir les événements pour lesquels le Smart Walk-Thrus n’a pas démarré | |
Launcher |
Launcher sur lequel un utilisateur a cliqué | Recevoir les événements lorsque un utilisateur a cliqué sur un Launcher |
Onboarding |
Tâche Onboarding achevée | Recevoir les événements lorsque une tâche Onboarding spécifique a été achevée |
ShoutOut |
ShoutOut d’action sur lequel un utilisateur a cliqué | Recevoir les événements lorsque un utilisateur a cliqué sur un Shoutout |
Shoutout rejeté | Recevoir les événements lorsque le Shoutout est rejeté | |
Objectif du Shoutout atteint | Recevoir les événements avec les Objectifs que vous avez définis dans un ShoutOut | |
ShoutOut affiché | Recevoir les événements lorsque un ShoutOut s’affiche | |
SmartTip |
Message SmartTip affiché | Recevoir les événements lorsque un message SmartTip s’affiche |
Erreur de validation du SmartTip | Recevoir les événements lorsque une règle de validation SmartTip se déclenche | |
Survey |
Question du Survey répondue | Recevoir les événements lorsqu’un utilisateur a répondu à une question spécifique |
Survey rejeté | Recevoir les événements lorsqu’un utilisateur a commencé à répondre à un Survey mais qu’il ne l’a pas soumis | |
Survey soumis | Recevoir les événements lorsqu’un utilisateur a soumis un Survey | |
Menu |
Menu ouvert | Recevoir les événements lorsqu’un utilisateur ouvre le menu WalkMe |
Recherche de Menu | Recevoir les événements lorsqu’un utilisateur s’est servi de la barre de recherche | |
Élément de Menu sélectionné | Recevoir les événements lorsqu’un utilisateur a sélectionné un résultat de recherche | |
Shuttle |
Objectif de Shuttle atteint | Recevoir les événements lorsqu’un objectif de Shuttle a été atteint |
Recevoir les événements lorsque une règle de validation SmartTip se déclenche |
Resource sur laquelle un utilisateur a cliqué | Recevoir les événements lorsqu’un utilisateur s’est servi d’une ressource |
SendWMEvent3_16-4-2019 | Recevoir les événements lorsqu’un objectif de ressource a été atteint | |
TeachMe
|
TeachMe a été visible | Recevoir les événements lorsqu’un cours TeachMe était visible |
Étape TeachMe commencée | Recevoir les événements lorsqu’un utilisateur a commencé une étape TeachMe | |
Cours TeachMe commencé |
Recevoir les événements lorsque le cours TeachMe a commencé | |
Exécution du cours TeachMe | Recevoir les événements lorsqu’un utilisateur a achevé un cours TeachMe | |
Quiz lu | Recevoir les événements lorsqu’un utilisateur a lu le quiz | |
Quiz soumis | Recevoir les événements lorsqu’un utilisateur a soumis le quiz | |
Réussite du quiz | Recevoir les événements lorsqu’un utilisateur a soumis et a réussi un quiz | |
Échec du quiz | Recevoir les événements lorsqu’un utilisateur a soumis et a échoué | |
Digital Experience Analytics ou DXA [Digital Experience Analytics] (connue précédemment sous le nom d’UBT) |
Click/Tap (cliquer / appuyer) | Recevoir les événements lorsqu’un utilisateur a cliqué ou a appuyé sur un élément du site |
Entrée d’utilisateur | Recevoir les événements lorsqu’un utilisateur a interagi avec un champ d’entrée. | |
Page View (affichage de la page) | Recevoir les événements lorsqu’un utilisateur a vu une page du site |