Présentation des Webhooks
Dendreo dispose de Webhooks (points d'ancrage web) vous permettant de vous abonner à différentes actions effectuées sur votre compte et ainsi de déclencher des requêtes HTTP POST en JSON vers un service externe lorsqu'un évènement spécifique se produit sur Dendreo.
Un Webhook envoie donc automatiquement (contrairement à l'API) des données en temps réel depuis Dendreo vers d’autres logiciels dès qu'un événement spécifique se produit sur Dendreo.
Définir une clé secrète
Utilisez la clé secrète fournie par Dendreo pour vérifier la signature envoyée dans le header afin de valider que l’information reçue suite à une action effectuée sur votre compte provient bien de Dendreo.
Ajouter un Webhook
- Depuis la page de configuration des Webhooks, cliquez sur Ajouter un Webhook.
- Indiquez l'URL à utiliser pour recevoir les Webhooks. Ainsi, dès que cette action sera déclenchée sur votre compte, l’URL sera appelée avec les paramètres nécessaires au traitement de votre côté.
- Associez l'URL avec un ou plusieurs événements spécifiques (passés et à venir) en les sélectionnant dans la liste déroulante.
Vous pouvez également cocher la case pour lier l'URL à l'ensemble des événements (existants et futurs) 🙌
- Validez. Vous retrouvez alors tous les Webhooks ajoutés.
À noter : dans le cas d'un compte multi-centres, si un administrateur ajoute un Webhook depuis un sous-centre, le Webhook ne sera déclenché que pour les événements liés à ce sous-centre. Depuis un sous-centre, il n'est également pas possible de modifier ou supprimer les URL spécifiques à la vue globale.
Webhooks disponibles sur Dendreo
Les Webhooks disponibles pour le moment sont les suivants :
Actions de Formation
- Lorsqu'un Module est programmé dans une Action de Formation
- Lorsque l'étape d'une Action de Formation est modifiée
- Lorsqu'un Créneau est modifié (la date, le lieu ou l’intitulé par exemple)
- Lorsqu'un Participant est inscrit à un Module dans une Action de Formation
- Lorsqu'un Formateur est ajouté dans une Action de Formation
- Lorsqu'un Formateur est supprimé d'une Action de Formation
Questionnaires
- Lorsqu'un questionnaire de Satisfaction est soumis
- Lorsqu'un questionnaire d'Auto-positionnement pré-formation est saisi ou mis à jour
- Lorsqu'un questionnaire d'Auto-positionnement post-formation est saisi ou mis à jour
- Lorsqu'un Recueil des besoins est saisi ou mis à jour
Actions commerciales
- Lorsqu'une action commerciale est saisie ou mise à jour
Divers
- Lorsqu'un document est signé
- Lorsque la case “inscription à la newsletter” est cochée lors d'une inscription au Catalogue Public
La fonctionnalité de Webhooks s'enrichit au fur et à mesure de vos retours ! Si vous avez besoin d'un évènement qui n'est pas encore proposé, contactez le support.
Tester un Webhook
Il vous est désormais possible de tester les Webhooks, en cliquant sur chaque événement.
Une fenêtre s'ouvre alors, depuis laquelle vous retrouvez :
- L'URL liée au Webhook ;
- L'événement que vous êtes sur le point de tester ;
- Un exemple de l'événement que vous recevrez ;
- Le bouton Envoyer un Webhook test.
| Article précédent : Configurer l'API |
Article suivant : Utiliser une Sandbox |