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 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 Webhook est ajouté 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 :
Action commerciale
- Une Action commerciale est créée
- Une Action commerciale est modifiée
Action de Formation
- Un Module est programmé dans une Action de Formation
- L'Étape d'une Action de Formation est modifiée
- Un Créneau est modifié (date, lieu, intitulé, etc.)
- Un Participant est ajouté à une Action de Formation
- Un Participant est inscrit à un Module dans une Action de Formation
- Un Participant est désinscrit d'un Module dans une Action de Formation
- La présence d'un Participant à un Module dans une Action de Formation est arrivée à 100%
- Un questionnaire de Satisfaction est soumis
- Un Recueil des besoins est saisi ou mis à jour
- Un questionnaire d'Auto-positionnement pré-formation est saisi ou mis à jour
- Un questionnaire d'Auto-positionnement post-formation est saisi ou mis à jour
- Un Formateur est ajouté dans une Action de Formation
- Un Formateur est supprimé d'une Action de Formation
- Un Émargement est fait
- Une Action de Formation est créée
- Une Action de Formation est désactivée
- Un Financement est créé
Catalogue Public
- La case Inscription à la Newsletter est cochée lors d'une inscription au Catalogue Public
Contact
- Un Contact est créé
- Un Contact est désactivé
Document
- Un document est signé
Entreprise
- Une Entreprise est créée
- Une Entreprise est désactivée
Formateur
- Une Facture Formateur est validée
- Un Formateur est créé
- Un Formateur est désactivé
Module
- Un Module est créé
- Un Module est désactivé
Participant
- Un Participant est créé
- Un Participant est désactivé
- La valeur "newsletter" d'un Participant change
Salle de Formation
- Une Salle de Formation est créée
- Une Salle de Formation est désactivée
To-do
- Une To-do est créée
- Une To-do est modifiée
- Le statut d'une To-do est modifiée
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 |