Paramètres Projet - Intégrations
Connectez le projet avec des outils externes: GitHub, GitLab, Slack, Jira et plus.
Description Générale
L'onglet Intégrations permet de connecter le projet à des services externes pour automatiser les flux de travail et synchroniser les données.
Le Problème que Cela Résout
Sans intégrations, les équipes font face à:
| Problème | Conséquence | Solution |
|---|---|---|
| Outils déconnectés | Switching constant | Centralisation |
| Données dupliquées | Incohérences | Synchronisation |
| Mises à jour manuelles | Temps perdu | Automatisation |
| Pas de notifications | Infos manquées | Alertes temps réel |
| Historique fragmenté | Pas de vue complète | Données unifiées |
Intégrations Disponibles
Contrôle de Version
| Service | Fonctionnalités | Sync |
|---|---|---|
| GitHub | Repos, PRs, Issues, Commits | ↔️ |
| GitLab | Projets, Merge Requests | ↔️ |
| Bitbucket | Repos, PRs, Pipelines | ↔️ |
| Azure DevOps | Repos, Work Items | ↔️ |
Communication
| Service | Fonctionnalités | Direction |
|---|---|---|
| Slack | Notifications dans canaux | → |
| Discord | Alertes sur serveurs | → |
| Microsoft Teams | Messages dans équipes | → |
| Notifications par email | → |
Productivité
| Service | Fonctionnalités | Sync |
|---|---|---|
| Google Drive | Joindre documents | ↔️ |
| Figma | Embed de designs | → |
| Notion | Sync documentation | ↔️ |
| Confluence | Import/export | ↔️ |
DevOps et CI/CD
| Service | Fonctionnalités | Direction |
|---|---|---|
| Jira | Import/sync issues | ↔️ |
| Jenkins | Status des builds | ← |
| CircleCI | Statut CI/CD | ← |
| GitHub Actions | Statut workflows | ← |
Autres
| Service | Fonctionnalités |
|---|---|
| Zapier | Automatisations custom |
| Webhooks | Intégrations personnalisées |
| API REST | Accès programmatique |
Éléments de la Vue
Liste des Intégrations
| Colonne | Description |
|---|---|
| Icône | Logo du service |
| Nom | Nom de l'intégration |
| État | Connecté/Déconnecté/Erreur |
| Compte | Compte ou projet lié |
| Dernière sync | Date de dernière synchronisation |
| Actions | Configurer, Déconnecter |
États d'Intégration
| État | Icône | Signification |
|---|---|---|
| 🟢 Connecté | ✓ | Fonctionne correctement |
| 🟡 Attention | ⚠ | Permissions ou config incomplète |
| 🔴 Erreur | ✗ | Échec de connexion |
| ⚫ Déconnecté | — | Non configuré |
Comment Connecter
Connecter GitHub
- Cliquez sur GitHub → Connecter
- Vous êtes redirigé vers GitHub
- Autorisez GitScrum:
- Accès aux repositories
- Webhooks
- Pull Requests
- Sélectionnez le repository à lier
- Configurez la synchronisation:
| Option | Description |
|---|---|
| Commits → Tâches | Lier commits aux tâches (via #123) |
| PRs → Mise à jour | Mettre à jour le statut |
| Issues → Créer tâches | Créer des tâches depuis issues |
| Branches → Tâches | Créer branche par tâche |
- Sauvegardez
Syntaxe pour lier:
git commit -m "Fix bug #123" // Lie au ticket #123Connecter Slack
- Cliquez sur Slack → Connecter
- Autorisez dans votre workspace Slack
- Sélectionnez le(s) canal(aux) pour notifications
- Configurez les événements:
| Événement | Notification |
|---|---|
| Tâche créée | ✓/✗ |
| Tâche complétée | ✓/✗ |
| Commentaire ajouté | ✓/✗ |
| Mention | ✓/✗ |
| Sprint démarré | ✓/✗ |
| Sprint terminé | ✓/✗ |
- Testez avec un message
Importer depuis Jira
- Cliquez sur Jira → Importer
- Entrez l'URL de votre instance Jira
- Authentifiez-vous (API token recommandé)
- Sélectionnez le projet à importer
- Mappez les champs:
| Jira | GitScrum |
|---|---|
| Issue Type | Type de tâche |
| Status | Workflow |
| Priority | Priorité |
| Assignee | Assigné |
| Sprint | Sprint |
| Epic | Epic |
- Prévisualisez l'import
- Lancez l'import
Options d'import:
| Option | Description |
|---|---|
| Import unique | Une fois, pas de sync |
| Sync continue | Mise à jour bidirectionnelle |
| Import incrémental | Seulement les nouveaux |
Configuration Avancée
Mapping des États
Reliez les états entre systèmes:
| Jira | → | GitScrum |
|---|---|---|
| To Do | → | Backlog |
| In Progress | → | En cours |
| In Review | → | Révision |
| Done | → | Terminé |
Filtres de Synchronisation
| Filtre | Exemple |
|---|---|
| Par label | Sync seulement "frontend" |
| Par branche | Exclure branches "feature/*" |
| Par membre | Seulement certains assignés |
| Par type | Ignorer les bugs |
Webhooks Sortants
Pour intégrations personnalisées:
- Section Webhooks
- Cliquez Ajouter webhook
- Configurez:
- URL de destination
- Événements déclencheurs
- Headers personnalisés
- Secret pour signature
- Testez le webhook
- Sauvegardez
Événements disponibles:
| Catégorie | Événements |
|---|---|
| Tâches | created, updated, deleted, moved |
| Sprints | started, completed |
| Membres | added, removed |
| Commentaires | created |
| Documents | uploaded |
Tokens API
Pour accès programmatique:
- Section API
- Cliquez Générer token
- Définissez les permissions
- Copiez le token (affiché une seule fois)
- Utilisez dans vos scripts
Dépannage
Erreurs Courantes
| Erreur | Cause | Solution |
|---|---|---|
| "Token expiré" | Token de service expiré | Reconnecter |
| "Permission denied" | Droits insuffisants | Vérifier permissions |
| "Rate limited" | Trop de requêtes | Attendre ou réduire fréquence |
| "Webhook failed" | URL inaccessible | Vérifier l'URL |
| "Sync conflict" | Modifications simultanées | Résoudre manuellement |
Logs d'Intégration
- Ouvrez l'intégration
- Onglet Logs
- Voyez l'historique:
- Événements envoyés/reçus
- Erreurs
- Timestamps
Permissions
| Action | Owner | Admin | Manager | Member |
|---|---|---|---|---|
| Voir intégrations | ✓ | ✓ | ✓ | ✓ |
| Connecter service | ✓ | ✓ | — | — |
| Configurer | ✓ | ✓ | — | — |
| Déconnecter | ✓ | ✓ | — | — |
| Voir logs | ✓ | ✓ | ✓ | — |
| Gérer webhooks | ✓ | ✓ | — | — |
| Gérer API tokens | ✓ | ✓ | — | — |
Meilleures Pratiques
Sécurité
- Permissions minimales - N'accordez que ce qui est nécessaire
- Tokens rotatifs - Changez régulièrement
- Webhooks signés - Utilisez les secrets
- Audit régulier - Vérifiez les accès
Performance
- Filtres ciblés - Ne synchronisez que le nécessaire
- Batch vs temps réel - Selon le volume
- Monitoring - Surveillez les erreurs
Liens Connexes
- Paramètres du Projet - Vue d'ensemble
- Tableau Kanban - Gestion des tâches
- Workspace - Dashboard principal