Vue d'ensemble des Intégrations

GitScrum Studio se connecte aux outils que vous utilisez déjà. Du contrôle de version aux plateformes de communication, les intégrations étendent votre flux de travail au-delà de la gestion de projet.

Intégrations Disponibles

Contrôle de Version

Communication

Calendrier

Développement

Configurer les Intégrations

Au Niveau du Workspace

Certaines intégrations s'appliquent à tout le workspace :

1. Allez dans Paramètres du Workspace
2. Sélectionnez Intégrations
3. Choisissez l'intégration
4. Suivez le flux d'autorisation
5. Configurez les paramètres

Au Niveau du Projet

D'autres sont spécifiques au projet :

1. Ouvrez les Paramètres du Projet
2. Sélectionnez l'onglet Intégrations
3. Activez les intégrations souhaitées
4. Configurez par intégration

Intégration GitHub

Connexion

1. Allez dans Paramètres du Workspace > Intégrations
2. Cliquez sur "Connecter GitHub"
3. Autorisez GitScrum
4. Sélectionnez les dépôts

Fonctionnalités

Liaison des Pull Requests

• Référencez la tâche #123 dans le titre/description de la PR
• La tâche affiche la PR liée avec son statut
• La fusion de PR peut faire transiter automatiquement la tâche

Références des Commits

• Incluez le numéro de tâche dans le message de commit
• Les commits apparaissent dans l'activité de la tâche

Création de Branches

• Créez une branche depuis une tâche
• Convention de nommage : feature/123-titre-tache

Options de Synchronisation

• Synchronisation bidirectionnelle avec GitHub Issues (optionnel)
• Création automatique de tâches depuis les issues
• Synchronisation des statuts

Configuration

Intégration Slack

Connexion

1. Allez dans Paramètres du Workspace > Intégrations
2. Cliquez sur "Ajouter à Slack"
3. Choisissez le workspace
4. Sélectionnez le canal par défaut

Fonctionnalités

Notifications

• Tâche créée/mise à jour
• Commentaires ajoutés
• Assignations modifiées
• Dates d'échéance approchantes

Commandes

• /gitscrum create - Créer une tâche depuis Slack
• /gitscrum search - Trouver des tâches
• /gitscrum timer - Démarrer le suivi du temps

Messages Interactifs

• Mettre à jour le statut de la tâche depuis Slack
• Ajouter des commentaires sans quitter Slack
• Assigner des membres de l'équipe

Configuration Par Canal

Routez les notifications par type :

• #dev-tasks → Notifications du projet développement
• #bugs → Notifications de type bug
• #urgent → Notifications de haute priorité

Intégration Webhook

Cas d'Utilisation

• Notifications personnalisées vers vos systèmes
• Intégration avec des outils internes
• Journalisation d'audit
• Déclenchement de workflows externes

Configuration des Webhooks

1. Allez dans Paramètres du Projet > Webhooks
2. Cliquez sur "Ajouter un Webhook"
3. Entrez :

• URL de l'endpoint (HTTPS requis)
• Clé secrète (pour la vérification de signature)
• Événements à déclencher

1. Enregistrez

Événements Disponibles

Format du Payload

{
  "event": "task.updated",
  "timestamp": "2026-01-15T10:30:00Z",
  "workspace_id": "ws_123",
  "project_id": "proj_456",
  "data": {
    "task_id": "task_789",
    "changes": {
      "status": {
        "from": "In Progress",
        "to": "Done"
      }
    }
  }
}

Sécurité

Les webhooks incluent un en-tête de signature :

• X-GitScrum-Signature : HMAC-SHA256 du payload
• Vérifiez en utilisant votre clé secrète
• Rejetez les requêtes avec des signatures invalides

Accès API

Clés API

1. Allez dans Paramètres du Workspace > API
2. Cliquez sur "Générer une Clé API"
3. Nommez la clé (pour identification)
4. Copiez la clé (affichée une seule fois)

Limites de Débit

Documentation

Documentation API complète disponible à :

• Référence API
• Playground interactif dans les paramètres
• Téléchargement de spec OpenAPI/Swagger

Synchronisation Calendrier

Google Calendar

1. Connectez le compte Google
2. Sélectionnez le calendrier pour la synchronisation
3. Configurez les paramètres de synchronisation :

• Dates d'échéance des tâches comme événements
• Dates de sprint comme événements
• Dates de jalons

Outlook Calendar

1. Connectez le compte Microsoft
2. Sélectionnez le calendrier
3. Configurez la création d'événements

Direction de Synchronisation

Permissions des Intégrations

Qui Peut Configurer

Portées OAuth

Lors de la connexion des services tiers, GitScrum demande des permissions minimales :

• GitHub : Lire les repos, gérer les hooks
• Slack : Envoyer des messages, lire les canaux
• Google : Lecture/écriture du calendrier

Examinez les permissions lors de l'autorisation.

Dépannage

L'Intégration ne Fonctionne Pas

1. Vérifiez le statut de connexion dans les paramètres
2. Vérifiez que l'OAuth n'a pas expiré
3. Ré-autorisez si nécessaire
4. Vérifiez les logs de livraison webhook

Échecs de Webhook

Consultez l'historique des livraisons :

1. Allez dans Paramètres du Projet > Webhooks
2. Cliquez sur le webhook
3. Voyez les livraisons récentes
4. Vérifiez les codes de réponse

Limitation de Débit

Si vous atteignez les limites :

• Regroupez les opérations si possible
• Mettez en cache les réponses localement
• Contactez le support pour des augmentations de limite

Bientôt Disponible

Intégrations prévues :

• Import/sync Jira
• Import Trello
• Sync des commentaires Figma
• Import Linear
• Sync des pages Notion

Demandez des intégrations via le support.

Comment Signaler un Problème ou Demander une Fonctionnalité

Si une intégration ne fonctionne pas ou si vous avez besoin d'une nouvelle intégration, soumettez vos commentaires via GitScrum Studio. Dans la barre latérale, cliquez sur Tickets de Support et ouvrez un ticket.