Webhooks du Projet

L'onglet Webhooks permet de configurer des endpoints HTTP pour recevoir des notifications en temps réel lorsque des événements spécifiques se produisent dans votre projet. Les systèmes externes reçoivent des requêtes POST instantanées au lieu d'interroger l'API, permettant des workflows automatisés et des intégrations avec des applications personnalisées.

Aperçu

L'interface affiche un tableau d'événements webhook prédéfinis organisés par catégorie. Chaque événement possède un champ URL d'endpoint où vous entrez l'adresse de votre serveur récepteur. Lorsqu'un événement se produit, GitScrum envoie une requête HTTP POST à l'URL configurée avec les données de l'événement.

L'en-tête affiche des statistiques incluant le nombre total de webhooks chargés et combien sont actuellement actifs (ont une URL configurée).

Catégories de Webhook

Les événements sont regroupés en catégories extensibles. Cliquez sur l'en-tête d'une catégorie pour développer ou réduire ses événements.

Tasks

Webhooks pour les événements liés aux tâches:

Tâche Créée (issues.store) - Déclenché quand une nouvelle tâche est créée
Tâche Mise à Jour (issues.update) - Déclenché quand les champs d'une tâche sont modifiés
Tâche Déplacée sur le Board (issues.move.board) - Déclenché quand une tâche change d'étape de workflow
Assignés Modifiés (issues.assignees) - Déclenché quand les attributions de tâche changent
Tâche Supprimée (issues.destroy) - Déclenché quand une tâche est supprimée
Tâche Déplacée vers Projet (issues.move.project) - Déclenché quand une tâche est transférée vers un autre projet
Suivi du Temps (time-tracking) - Déclenché quand du temps est enregistré sur une tâche

User Stories

Webhooks pour les événements d'user stories:

Événements User Story (user-stories) - Déclenché quand des user stories sont créées, mises à jour ou supprimées

Sprints

Webhooks pour les événements de sprint:

Événements Sprint (sprints) - Déclenché quand des sprints sont créés, démarrés, terminés ou modifiés

Autres

Webhooks pour les événements supplémentaires du projet:

Discussions (discussions) - Déclenché quand des discussions sont créées ou mises à jour
Commentaires (comments) - Déclenché quand des commentaires sont ajoutés aux tâches
Pièces Jointes (attachments) - Déclenché quand des fichiers sont joints
Vidéos (videos) - Déclenché quand des vidéos sont ajoutées

Configurer un Webhook

Développez la catégorie contenant l'événement que vous souhaitez configurer
Localisez la ligne de l'événement dans le tableau
Entrez l'URL de votre endpoint dans le champ de saisie
Appuyez sur Entrée ou cliquez en dehors du champ pour sauvegarder
L'indicateur de statut devient vert quand la sauvegarde réussit

L'URL de l'endpoint doit être une URL HTTP ou HTTPS valide. HTTPS est recommandé pour la sécurité.

Indicateurs de Statut des Webhooks

Chaque webhook affiche un indicateur de statut:

Point vert - Webhook est actif avec un endpoint configuré
Point gris - Webhook n'a pas d'endpoint configuré

L'en-tête de catégorie affiche un comptage des webhooks actifs dans cette catégorie (ex: "2/7" signifie 2 sur 7 webhooks ont des URLs configurées).

Tester les Webhooks

Tester un Webhook Individuel

Configurez une URL d'endpoint pour le webhook
Cliquez sur le bouton icône de test (icône de pulsation) dans la colonne Actions
Un payload de test est envoyé à votre endpoint
Un message de succès ou d'erreur apparaît sous le champ de saisie

Tester Tous les Webhooks

Cliquez sur le bouton Tester Tous dans l'en-tête pour envoyer des requêtes de test à tous les webhooks configurés simultanément. C'est utile pour vérifier toute votre configuration de webhooks en une fois.

Supprimer un Webhook

Cliquez sur l'icône X dans la colonne Actions
L'URL de l'endpoint est effacée
L'indicateur de statut devient gris
Aucun événement supplémentaire n'est envoyé à cet endpoint

Exigences de l'Endpoint

Votre endpoint webhook doit:

Accepter les requêtes HTTP POST
Retourner un code de statut 2xx dans les 30 secondes
Être publiquement accessible depuis les serveurs GitScrum
Gérer gracieusement les potentielles réessais

Bonnes Pratiques

La section d'information en bas de la page affiche les recommandations clés:

Utilisez HTTPS - Chiffrez les données de webhook en transit
Retournez un statut 2xx - Confirmez la réception immédiatement
Gérez les réessais - Le même événement peut être livré plusieurs fois

Exemples d'Intégration

Automatisation Personnalisée: Configurez des webhooks pour déclencher vos systèmes internes quand les tâches changent de statut, permettant des workflows personnalisés.

Tableaux de Bord Externes: Envoyez des événements de tâches et sprints pour mettre à jour des tableaux de bord en temps réel en dehors de GitScrum.

Systèmes de Notification: Routez les événements vers votre propre infrastructure de notification pour des alertes personnalisées.

Outils de Workflow: Utilisez des URLs de webhook de plateformes d'automatisation comme Zapier, Make ou n8n pour déclencher des workflows multi-étapes.

Fonctionnalités Connexes

Accès API - Générez des tokens API pour l'accès programmatique
Intégrations - Intégrations préconstruites avec Slack, Discord, Teams et fournisseurs Git