Connexion des Intégrations

Les équipes de développement modernes utilisent de nombreux outils—GitHub, Slack, applications de calendrier, systèmes CI/CD, et plus encore. Les intégrations GitScrum connectent ces outils pour que l'information circule automatiquement, réduisant les changements de contexte et gardant tout synchronisé.

Catégories d'Intégrations

Intégrations Principales

Intégration GitHub

INTÉGRATION GITHUB
══════════════════

FONCTIONNALITÉS :
├── Lier commits aux tâches
├── Auto-mise à jour sur merge PR
├── Création branche depuis tâches
├── Visibilité statut build
└── Suivi des revues PR

CONFIGURATION :
1. Paramètres → Intégrations → GitHub
2. Cliquer "Connecter GitHub"
3. Autoriser l'app GitScrum
4. Sélectionner repositories
5. Mapper aux projets

PARAMÈTRES :
├── Pattern ID tâche : GS-[0-9]+
├── Auto-transition sur merge : ✓
├── Afficher commits sur tâche : ✓
├── Créer branches : ✓
└── Sync commentaires PR : Optionnel

Intégration Slack

INTÉGRATION SLACK
═════════════════

FONCTIONNALITÉS :
├── Notifications tâches vers canaux
├── Créer tâches depuis Slack
├── Résumés quotidiens/hebdo
├── Alertes de mention
└── Commandes slash

CONFIGURATION :
1. Paramètres → Intégrations → Slack
2. Cliquer "Ajouter à Slack"
3. Autoriser permissions
4. Sélectionner workspace
5. Configurer canaux

MAPPING DES CANAUX :
┌─────────────────────────────────────────────────┐
│  Projet/Événement     │  Canal Slack           │
├─────────────────────────────────────────────────┤
│  Projet Site Web      │  #website-dev          │
│  Bugs Critiques       │  #alerts               │
│  Mises à jour Sprint  │  #team-standups        │
│  Tous Commentaires    │  (Désactivé)           │
└─────────────────────────────────────────────────┘

COMMANDES SLASH :
├── /gs create [nom tâche] - Créer tâche
├── /gs search [requête] - Chercher tâches
├── /gs my - Mes tâches ouvertes
└── /gs sprint - Résumé sprint

Intégration Calendrier

INTÉGRATION CALENDRIER
══════════════════════

FONCTIONNALITÉS :
├── Échéances comme événements
├── Sync dates de sprint
├── Sync tâches réunion
├── Vue disponibilité
└── Événements rappel

CONFIG GOOGLE CALENDAR :
1. Paramètres → Intégrations → Google Calendar
2. Connecter compte Google
3. Sélectionner calendriers
4. Configurer options sync

OPTIONS DE SYNC :
├── Échéances → événements cal : ✓
├── Sprints → blocs calendrier : ✓
├── Tâches assignées seules : ✓
├── Inclure sous-tâches : ✗
└── Rappel avant échéance : 1 jour

VUE CALENDRIER :
┌─────────────────────────────────────────────────┐
│  Mars 2024                                      │
├─────────────────────────────────────────────────┤
│  Lun 18 │ GS-123: Revue API due                │
│  Mer 20 │ Sprint 15 se termine                 │
│  Jeu 21 │ Sprint 16 commence                   │
│  Ven 22 │ GS-456: Déployer v2.1                │
└─────────────────────────────────────────────────┘

Intégrations d'Automatisation

Intégration Zapier

INTÉGRATION ZAPIER
══════════════════

DÉCLENCHEURS (GitScrum → Autre) :
├── Tâche créée
├── Statut tâche changé
├── Tâche assignée
├── Commentaire ajouté
├── Sprint démarré/terminé
└── Échéance approchante

ACTIONS (Autre → GitScrum) :
├── Créer tâche
├── Mettre à jour tâche
├── Ajouter commentaire
├── Assigner tâche
├── Ajouter label
└── Créer projet

EXEMPLES DE ZAPS :
─────────────────────────────────────
ZAP 1 : Support Client → Dev
Déclencheur : Nouveau ticket Zendesk (bug)
Action : Créer tâche GitScrum
Mapper : Priorité, description, lien

ZAP 2 : Tâche → CRM
Déclencheur : Tâche complétée (label:client)
Action : Mettre à jour étape deal HubSpot

ZAP 3 : Formulaire → Tâche
Déclencheur : Soumission Typeform
Action : Créer tâche GitScrum
Inclure : Réponses formulaire
─────────────────────────────────────

Webhooks

CONFIGURATION WEBHOOKS
══════════════════════

WEBHOOKS SORTANTS (GitScrum → Votre Serveur) :

Événement : Statut tâche changé
URL : https://votre-serveur.com/webhook
Méthode : POST
En-têtes :
├── Content-Type: application/json
├── X-GitScrum-Signature: [hmac]
└── Authorization: Bearer [token]

Payload :
{
  "event": "task.status_changed",
  "task": {
    "id": "GS-123",
    "title": "Nom de la tâche",
    "status": "done",
    "previous_status": "in_review"
  },
  "actor": {
    "id": "user_456",
    "name": "Jean Dupont"
  },
  "timestamp": "2024-03-15T10:30:00Z"
}

WEBHOOKS ENTRANTS (Externe → GitScrum) :
URL : https://api.gitscrum.com/webhook/abc123
Usage : Créer tâches, mettre à jour statut via API

Accès API

INTÉGRATION API
═══════════════

AUTHENTIFICATION :
├── Tokens d'accès personnels
├── OAuth 2.0 pour les apps
└── Clés API pour les services

ENDPOINTS :
├── GET /api/v1/tasks
├── POST /api/v1/tasks
├── PUT /api/v1/tasks/{id}
├── GET /api/v1/projects
├── GET /api/v1/sprints
└── POST /api/v1/comments

LIMITES DE TAUX :
├── 100 requêtes/minute (standard)
├── 1000 requêtes/minute (enterprise)
└── Burst : 10 requêtes/seconde

EXEMPLE :
curl -X POST https://api.gitscrum.com/v1/tasks \
  -H "Authorization: Bearer TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"title": "Nouvelle tâche", "project_id": "proj_123"}'

Gestion des Intégrations

Tableau de Bord

TABLEAU DE BORD INTÉGRATIONS
════════════════════════════

┌─────────────────────────────────────────────────────────┐
│  Intégrations Connectées                                │
├─────────────────────────────────────────────────────────┤
│                                                         │
│  GitHub              ✓ Connecté                        │
│  ├── 5 repositories                                    │
│  ├── Dernière sync : il y a 2 min                     │
│  └── [Configurer] [Déconnecter]                        │
│                                                         │
│  Slack               ✓ Connecté                        │
│  ├── 3 canaux configurés                              │
│  ├── 247 notifications aujourd'hui                    │
│  └── [Configurer] [Déconnecter]                        │
│                                                         │
│  Google Calendar     ✓ Connecté                        │
│  ├── 2 calendriers synchronisés                       │
│  ├── 12 événements synchronisés                       │
│  └── [Configurer] [Déconnecter]                        │
│                                                         │
│  Zapier              ✓ Connecté                        │
│  ├── 4 zaps actifs                                    │
│  └── [Voir dans Zapier]                                │
│                                                         │
├─────────────────────────────────────────────────────────┤
│  [+ Ajouter Intégration]                                │
└─────────────────────────────────────────────────────────┘

Dépannage

SANTÉ DES INTÉGRATIONS
══════════════════════

PROBLÈMES COURANTS :
├── Token expiré → Réautoriser
├── Limite de taux → Vérifier usage
├── Webhook échoué → Vérifier endpoint
├── Sync retardée → Vérifier statut
└── Données manquantes → Vérifier mapping

LOGS :
┌─────────────────────────────────────────────────────────┐
│  Logs Intégration (dernières 24h)                       │
├─────────────────────────────────────────────────────────┤
│  10:30 ✓ GitHub: PR #234 synchro vers GS-123          │
│  10:28 ✓ Slack: Notification envoyée à #dev           │
│  10:25 ✗ Webhook: Timeout connexion (réessai)         │
│  10:20 ✓ Calendrier: 3 événements synchronisés        │
└─────────────────────────────────────────────────────────┘

Meilleures Pratiques

Pour les Intégrations

1. Commencer essentiel — GitHub + Slack d'abord
2. Mapper avec soin — Bons canaux pour bons événements
3. Ne pas sur-notifier — Filtrer aux événements importants
4. Monitorer santé — Vérifier statut intégration
5. Sécuriser tokens — Rotation régulière

Anti-Patterns

ERREURS D'INTÉGRATION :
✗ Trop de notifications
✗ Ne pas tester endpoints webhook
✗ Ignorer les syncs échouées
✗ Exposer les tokens API
✗ Chaînes Zapier complexes
✗ Pas de documentation intégration

Solutions Connexes

• Connecter automatiquement les commits GitHub aux tâches
• Connecter Slack pour les notifications d'équipe
• Configuration des automatisations de workflow