Intégrations du Projet
L'onglet Intégrations permet de connecter GitScrum avec des services externes pour synchroniser les flux de développement et recevoir des notifications en temps réel. Connectez des plateformes de contrôle de version pour lier les commits et les issues aux tâches, ou configurez des outils de communication pour recevoir les mises à jour du projet dans les canaux de chat de votre équipe.
Aperçu
L'interface affiche une disposition à deux panneaux. La barre latérale gauche liste tous les fournisseurs d'intégration disponibles organisés par catégorie. Le panneau droit affiche les options de configuration pour le fournisseur sélectionné. Un compteur dans l'en-tête indique combien d'intégrations sont actuellement actives.
Intégrations Disponibles
Intégrations Natives:
- Slack - Notifications basées sur webhook vers les canaux
- Microsoft Teams - Notifications basées sur webhook vers les canaux
- Discord - Notifications basées sur webhook vers les canaux
- GitHub (Pro) - Connexion de repository avec synchronisation des issues/commits
- GitLab (Pro) - Connexion de repository avec synchronisation des issues/commits
- Bitbucket (Pro) - Connexion de repository avec synchronisation des commits
Intégrations Externes:
- Zapier - Connectez avec plus de 3 000 applications
- Pabbly - Automatisations de flux de travail
- Documentation API - Lien vers la documentation de l'API REST
Intégrations de Communication
Slack, Discord et Microsoft Teams utilisent des URLs de webhook pour recevoir des notifications. Le processus de configuration est identique pour les trois fournisseurs.
Connexion d'une Plateforme de Communication
- Sélectionnez le fournisseur dans la barre latérale gauche (Slack, Discord ou Teams)
- Obtenez une URL de webhook depuis votre plateforme:
- Slack: Créez un Incoming Webhook dans les paramètres de votre workspace
- Discord: Créez un webhook dans les paramètres du canal
- Teams: Ajoutez un connecteur Incoming Webhook à votre canal
- Collez l'URL du webhook dans le champ URL du Webhook
- Cliquez sur Valider pour tester la connexion
- Entrez optionnellement un Nom du Canal pour référence
- Activez Intégration Active pour activer les notifications
- Cliquez sur Activer l'Intégration pour sauvegarder
Options de Configuration du Webhook
URL du Webhook: L'URL complète du webhook de votre plateforme. Champ obligatoire.
Nom du Canal: Étiquette optionnelle pour votre référence. N'affecte pas la fonctionnalité.
Intégration Active: Contrôle principal pour activer ou désactiver toutes les notifications pour cette intégration.
Notifier Mes Propres Actions: Lorsqu'activé, vous recevez des notifications pour les actions que vous effectuez. Lorsque désactivé, seules les actions des autres membres de l'équipe déclenchent des notifications.
Événements de Notification
Après avoir activé une intégration, configurez quels événements déclenchent des notifications. Les événements sont organisés en catégories extensibles:
Cycle de Vie de la Tâche:
- Tâche créée
- Tâche supprimée
Statut de la Tâche:
- Tâche déplacée vers une étape différente du workflow
- Tâche terminée
- Tâche bloquée
- Tâche débloquée
Attribution de Tâche:
- Tâche assignée à un membre de l'équipe
Commentaires:
- Commentaire créé sur une tâche
- Utilisateur mentionné dans un commentaire
Sprint:
- Sprint démarré
- Sprint terminé
Équipe:
- Membre a rejoint le projet
- Membre a quitté le projet
Chaque événement a un toggle individuel. Utilisez les liens Tout Activer ou Tout Désactiver dans les en-têtes de catégorie pour configurer rapidement plusieurs événements.
Tests et Gestion
Tester la Connexion: Cliquez sur Tester dans l'en-tête pour envoyer une notification de test et vérifier que le webhook fonctionne correctement.
Supprimer l'Intégration: Cliquez sur Supprimer dans l'en-tête pour effacer la configuration de l'intégration. Une fenêtre modale de confirmation requiert un acquiescement avant la suppression.
Intégrations de Contrôle de Version
Les intégrations GitHub, GitLab et Bitbucket connectent les repositories pour synchroniser les issues, commentaires et commits avec les tâches GitScrum. Ces intégrations nécessitent un abonnement Pro.
Configuration de GitHub
- Sélectionnez GitHub dans la barre latérale
- Générez un Personal Access Token sur GitHub avec les scopes
repoetadmin:repo_hook - Collez le token dans le champ Personal Access Token
- Cliquez sur Sauvegarder le Token pour valider et stocker
- Cliquez sur le bouton de rafraîchissement pour charger vos repositories
- Sélectionnez un repository dans le dropdown
- Cliquez sur Connecter le Repository
Paramètres de Synchronisation GitHub
Après avoir connecté un repository, configurez les options de synchronisation:
Issues:
- Créer quand une issue est ouverte: Crée une tâche GitScrum quand une issue GitHub est ouverte. Optionnellement assigner à une étape spécifique du workflow.
- Mettre à jour quand une issue est fermée: Déplace la tâche liée quand l'issue GitHub se ferme. Optionnellement déplacer vers une étape spécifique du workflow.
- Mettre à jour quand une issue est rouverte: Met à jour le statut de la tâche quand l'issue est rouverte.
- Mettre à jour quand une issue est modifiée: Synchronise les changements de titre/description.
- Supprimer quand une issue est supprimée: Supprime la tâche liée quand l'issue est supprimée.
Commentaires:
- Synchroniser les nouveaux commentaires: Ajoute les commentaires d'issues GitHub aux tâches liées.
- Synchroniser les commentaires modifiés: Met à jour les commentaires de tâches quand les commentaires GitHub changent.
- Supprimer les commentaires effacés: Supprime les commentaires de tâches quand les commentaires GitHub sont supprimés.
Commits et Pull Requests:
- Lier les commits aux tâches: Associe les commits mentionnant des IDs de tâches avec les tâches. Utilisez les codes de tâche dans les messages de commit pour lier automatiquement.
- Déplacer lors de la fusion: Optionnellement déplacer les tâches liées vers une étape spécifique du workflow quand les commits sont fusionnés.
Actions Additionnelles GitHub
Importer les Issues: Cliquez sur Importer les Issues pour importer les issues GitHub existantes comme tâches GitScrum.
Déconnecter: Cliquez sur Déconnecter GitHub pour supprimer la connexion du repository.
GitLab et Bitbucket
GitLab et Bitbucket suivent le même modèle de configuration:
- Générez un Personal Access Token depuis votre plateforme
- Entrez le token et validez
- Sélectionnez et connectez un repository
- Configurez les paramètres de synchronisation pour les issues, commentaires et commits
Intégrations Externes
La barre latérale inclut des liens vers des plateformes d'intégration externes:
Zapier: Ouvre la page d'intégration GitScrum sur Zapier où vous pouvez vous connecter avec plus de 3 000 applications en utilisant des flux de travail automatisés.
Pabbly: Ouvre la page d'intégration GitScrum sur Pabbly pour créer des automatisations de flux de travail.
Documentation API: Ouvre la documentation de l'API REST GitScrum pour construire des intégrations personnalisées.
Ces liens s'ouvrent dans de nouveaux onglets du navigateur et ne nécessitent pas de configuration dans GitScrum.
Indicateurs de Statut d'Intégration
Chaque fournisseur dans la barre latérale affiche son statut actuel:
- Point vert + "Connecté" - L'intégration est active et fonctionne
- "Non configuré" - Aucune intégration configurée pour ce fournisseur
- Compteur actif - L'en-tête affiche le total des intégrations actives
Bonnes Pratiques
- Commencez avec les événements essentiels: Activez uniquement les notifications critiques initialement, puis étendez en fonction des retours de l'équipe.
- Utilisez les noms de canal: Ajoutez des noms de canal descriptifs pour identifier facilement quel canal reçoit quelles notifications.
- Testez avant de déployer: Utilisez toujours les boutons Valider et Tester avant de vous fier à une intégration.
- Révisez régulièrement: Passez en revue périodiquement les événements activés pour prévenir la fatigue des notifications.