GitScrum / Docs

Configurer les Endpoints

Configurez les URLs d'endpoints de webhook dans les Paramètres du Projet GitScrum. Gérez les abonnements d'événements, testez les endpoints et surveillez les webhooks actifs.

Configurez les endpoints de webhook dans GitScrum pour recevoir des notifications en temps réel des événements du projet. Chaque type d'événement a sa propre URL d'endpoint, donnant un contrôle granulaire sur quels événements vont où.

Accéder aux Paramètres des Webhooks

  1. Ouvrez votre projet dans GitScrum
  2. Cliquez sur Settings dans la barre latérale du projet
  3. Sélectionnez l'onglet Webhooks

La page de configuration des webhooks affiche un tableau avec tous les événements disponibles organisés par catégorie.

Vue d'ensemble de l'Interface

En-tête

L'en-tête affiche :

  • Titre Webhook Endpoints
  • Compteur chargé — Nombre total d'événements de webhook disponibles
  • Compteur actif — Nombre d'événements avec des endpoints configurés
  • Bouton Test All — Envoie des requêtes de test à tous les webhooks actifs

Tableau des Événements

Chaque ligne dans le tableau contient :

ColonneDescription
StatutPoint vert = actif, point gris = inactif
ÉvénementNom et identifiant de l'événement
EndpointChamp de saisie d'URL pour le serveur récepteur
ActionsBoutons Test (icône de pouls) et Supprimer (icône X)

Catégories

Les événements sont regroupés en quatre catégories dépliables :

  • Tasks — Création de tâches, mises à jour, déplacements, responsables, suivi du temps, commentaires, pièces jointes, vidéos
  • User Stories — Création, mises à jour, vote et suppression de user stories
  • Sprints — Création, mises à jour et suppression de sprints
  • Others — Vote de discussions

Cliquez sur l'en-tête d'une catégorie pour développer ou réduire ses événements. L'en-tête affiche le compteur actif/total (ex : "3/12").

Ajouter un Endpoint

  1. Développez la catégorie contenant votre événement cible
  2. Cliquez sur le champ URL de l'endpoint dans la ligne de l'événement
  3. Entrez une URL HTTP ou HTTPS valide
  4. Appuyez sur Entrée ou cliquez en dehors du champ
  5. L'indicateur de statut devient vert en cas de succès

L'endpoint est sauvegardé immédiatement via l'API. Aucun bouton supplémentaire "Sauvegarder" n'est nécessaire.

Supprimer un Endpoint

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

Tester les Webhooks

Tester un Seul Endpoint

  1. Configurez une URL d'endpoint pour un événement
  2. Cliquez sur l'icône de test (icône de pouls) dans la colonne Actions
  3. Un payload de test est envoyé à votre endpoint
  4. Vérifiez le message de statut sous le champ de saisie

Tester Tous les Endpoints

Cliquez sur le bouton Test All dans l'en-tête pour envoyer des requêtes de test à tous les webhooks actifs simultanément. Cela vérifie toute votre configuration en une seule fois.

Utiliser la Même URL pour Plusieurs Événements

Vous pouvez configurer la même URL d'endpoint pour plusieurs événements. Votre serveur peut différencier les événements en examinant le payload de la requête, qui inclut le type de ressource.

Pour configurer en masse, entrez la même URL dans le champ d'endpoint de chaque événement.

Permissions

Seuls les utilisateurs avec les rôles Manager ou Owner peuvent configurer les webhooks. Les autres membres de l'équipe peuvent voir la configuration des webhooks, mais ne peuvent pas modifier les endpoints.

Exigences du Plan

Les webhooks nécessitent un plan Pro ou supérieur. L'interface de configuration des webhooks est visible sur tous les plans, mais l'activation des endpoints est limitée à la fonctionnalité Pro.

Associé