Synchronisation de la gestion des tickets GitHub vers Notion - Workflow n8n

Équipes de développement logiciel : Besoin de centraliser le suivi des bogues et les demandes de fonctionnalités gérés dans GitHub vers un outil de gestion de projet comme Notion.
Chefs de projet : Ceux qui préfèrent utiliser Notion comme source unique de vérité pour toutes les mises à jour de statut de projet dérivées de l'activité des développeurs sur GitHub.

• Utilisateurs n8n : Personnes recherchant des modèles n8n avancés démontrant une logique de branchement complexe et une synchronisation de base de données en utilisant les intégrations de nœuds n8n GitHub et Notion.

La gestion des tâches de développement sur différentes plateformes peut entraîner des silos d'information. Ce workflow n8n hautement fonctionnel résout ce problème en établissant un miroir bidirectionnel robuste entre les tickets GitHub et une base de données Notion. Chaque fois qu'une action est effectuée sur un ticket GitHub — qu'il soit ouvert, modifié, fermé, voire supprimé — cette automatisation n8n garantit que l'enregistrement correspondant dans Notion est mis à jour instantanément. Ce workflow n8n solide utilise la logique conditionnelle et des scripts personnalisés pour localiser et modifier de manière fiable les pages Notion existantes, offrant une solution puissante sans code pour la synchronisation de données multiplateforme. Tirant parti de la puissance d'un déclencheur n8n, ce modèle est essentiel pour un DevOps et une supervision de projet efficaces.

Le processus commence immédiatement dès qu'un événement spécifié se produit dans GitHub, grâce au nœud déclencheur n8n dédié à GitHub.

1. Déclenchement et Vérification Initiale : Le déclencheur n8n surveille un dépôt GitHub spécifique pour les événements de tickets. La charge utile des données atteint ensuite le nœud n8n IF initial, qui inspecte l'action effectuée sur le ticket GitHub (par exemple, 'opened', 'edited', 'closed').


2. Création de Nouveau Ticket : Si l'action est 'opened', le flux passe au nœud n8n Notion Create database page, enregistrant le titre, l'ID et l'URL du nouveau ticket directement dans la base de données Notion configurée.


3. Gestion des Modifications : Si l'action est autre que 'opened', le workflow n8n passe au nœud fonction Create custom Notion filters n8n. Ce nœud génère dynamiquement une charge utile de filtre JSON pour localiser la page Notion existante à l'aide de l'ID du ticket GitHub.


4. Recherche de l'Enregistrement : Le nœud n8n Find database page utilise ce filtre personnalisé pour récupérer l'ID interne de l'entrée correspondante dans la base de données Notion.


5. Routage de l'Action (Switch) : Le nœud central Switch n8n évalue ensuite l'action spécifique effectuée ('edited', 'deleted', 'closed', 'reopened').


6. Exécution des Mises à Jour : Le flux se branche vers le nœud n8n Notion pertinent : Edit issue (met à jour le titre), Delete issue (archive la page), Close issue (définit la case à cocher 'Closed' sur vrai), ou Reopen issue (décoche la case 'Closed'). Ceci garantit que l'enregistrement Notion reflète l'état exact du ticket GitHub, complétant ainsi le cycle de synchronisation pour ce workflow n8n complet.

Pour déployer ce modèle n8n, suivez ces étapes :

1. Importer le Workflow n8n : Copiez les données JSON fournies et importez-les dans votre instance n8n via l'écran 'Workflows' en utilisant le bouton 'New' et 'Import from JSON'.


2. Configurer les Identifiants : Mettez à jour les identifiants de substitution pour les connexions des nœuds n8n GitHub et Notion en utilisant vos clés API personnelles.

1. Spécifier l'ID de la Base de Données : Dans tous les nœuds n8n Notion (Create database page, Find database page, etc.), remplacez l'ID de base de données de substitution (5026700b-6693-473a-8100-8cc6ddef62a6) par l'ID de votre base de données Notion réelle.


2. Configurer le Déclencheur GitHub : Dans le déclencheur n8n Trigger on issues, mettez à jour les champs Owner et Repository pour correspondre à votre configuration GitHub.


3. Activer : Une fois configuré, activez le workflow n8n pour démarrer la synchronisation en temps réel.

Trigger on issues (Déclencheur d'événements GitHub n8n) :
Fonction : Sert de point de départ, écoutant les événements issues sur un dépôt GitHub spécifique.
Configuration Clé : Configuré pour surveiller les événements sur John-n8n/DemoRepo et cible spécifiquement le type d'événement issues.
*IF (nœud n8n) :
Fonction : Dirige le flux en fonction de l'action du ticket GitHub. Sépare le chemin entre 'opened' (nouveau ticket) et toutes les autres actions (modifications).
Configuration Clé : Vérifie si body.action est égal à opened.
*Create custom Notion filters (Nœud fonction n8n Créer des filtres Notion personnalisés) :
Fonction : Nœud n8n critique pour les chemins de modification. Il utilise du JavaScript personnalisé pour construire une charge utile de filtre API Notion JSON qui recherche une page où la propriété 'Issue ID' correspond à l'ID du ticket GitHub entrant.
Find database page (Nœud n8n Trouver la page de base de données) :
Fonction : Exécute le filtre généré par le nœud n8n précédent pour récupérer l'pageId unique de l'entrée correspondante dans la base de données Notion.
Configuration Clé : Utilise l'entrée de filtre JSON provenant du nœud fonction n8n pour effectuer la recherche.
*Switch (nœud n8n) :
Fonction : Détermine l'action suivante requise dans Notion en fonction de l'action GitHub (edited, deleted, closed, reopened). C'est un composant central de ce workflow n8n avancé.
Configuration Clé : Compare la chaîne d'action GitHub par rapport à quatre résultats possibles, acheminant le flux vers le nœud n8n de mise à jour correct.
*Notion Nodes (Nœuds Notion (Créer/Modifier/Supprimer/Clore/Rouvrir le ticket)) :
Fonction : Une suite de nœuds n8n Notion chargés d'appliquer le changement d'état correspondant à la page de base de données Notion trouvée précédemment (par exemple, archiver la page si le ticket a été supprimé, ou mettre à jour le statut de la case à cocher pour les tickets clos/rouverts).