⚠️ Attention :
Vous ne pouvez pas activer cette fonctionnalité vous-même. Si vous ne voyez pas la section "Webhooks" sous Admin → Administration → Paramètres, veuillez contacter notre support via le chat 💬.
ℹ️ Qu’est-ce qu’un webhook ?
Les administrateurs peuvent désormais consulter et gérer les webhooks pour informer des tiers lorsqu’un certain événement se produit dans Strobbo, par exemple :
⏰ Pointage des employés (entrée et sortie)
📄 Contrats externes
Les tiers peuvent configurer une URL vers laquelle nous envoyons les informations concernant certains événements en temps réel, afin qu’ils puissent réagir comme ils le souhaitent (par exemple, mettre à jour Dimona lors d’un pointage).
⚙️ Comment configurer les webhooks
Allez dans Administration → Paramètres → Webhooks
Cliquez sur le bouton vert "Ajouter" en haut à droite du tableau pour créer un nouveau webhook.
Remplissez les champs suivants dans la fenêtre modale :
📝 Nom, description :
Saisissez un nom et une description personnalisés pour le webhook.
🌐 URL du webhook :
Indiquez l’URL vers laquelle l’événement sera envoyé lorsqu’il est déclenché. Cela doit être une URL HTTPS valide, incluant le protocole (ex. : https://).
👥 Groupe d’utilisateurs :
Si vous sélectionnez un groupe d’utilisateurs spécifique, le webhook ne recevra que les événements générés par les utilisateurs de ce groupe.
Laissez vide pour que le webhook s’applique à tous les groupes d’utilisateurs.
📊 Types d’événements :
Envoyez-moi tout : Recevez tous les événements.
Laissez-moi sélectionner des événements individuels : Choisissez des catégories spécifiques d’événements sur lesquelles le webhook doit réagir.
⏰ Groupe d’événements : Pointage
Ce groupe d’événements inclut tous les événements liés au pointage des employés. Les événements spécifiques de ce groupe sont :
Employé pointe son entrée
Employé pointe sa sortie
Employé annule un pointage
📄 Groupe d’événements : Contrats externes
Ce groupe d’événements inclut tous les événements liés aux actions sur les contrats. Les événements spécifiques de ce groupe sont :
Contrats externes prêts
🛠️ Headers personnalisés :
Par défaut, cette section est repliée dans le formulaire.
Ici, vous pouvez définir quels Headers de requête doivent être ajoutés à chaque requête webhook.
✏️ Modifier un webhook
Cliquer sur le bouton modifier (crayon) ouvre la même fenêtre modale utilisée pour créer un webhook. Cela permet de mettre à jour les détails d’un webhook après sa création.
🕒 Afficher l’historique des webhooks
Cliquer sur le bouton historique (horloge), dans l'option plus d'actions, montre un aperçu de tous les messages envoyés au endpoint.
En haut du tableau, vous trouverez un filtre de date pour limiter l’historique.
Cliquez sur le bouton 🔄 actualiser pour mettre à jour le tableau avec les dernières entrées de l’historique.
▶️⏹️ Activer, désactiver et supprimer des webhooks
Désactiver : Cliquez sur le symbole stop (stop rouge) pour désactiver temporairement un webhook.
Activer : Cliquez sur la flèche verte pour réactiver un webhook.
Supprimer : Cliquez sur l’icône poubelle 🗑️ pour supprimer définitivement un webhook.