Connecter GitHub à Notion
Gardez les Pull Requests à côté des plans de projet de votre équipe dans Notion.
Une synchronisation GitHub gérée crée une base de données GitHub Pull Requests à partir des dépôts que vous choisissez. Notion importe les Pull Requests existantes et vérifie les Dernières modifications sur GitHub en arrière-plan.
Ce guide couvre la Synchronisation de base de données dans vos paramètres de connexion GitHub. Les propriétés synchronisées sont en lecture seule. Modifiez les Pull Requests dans GitHub.
Remarque : Cette intégration GitHub remplace notre ancienne version. Pour maintenir vos données externes à jour, configurez vos nouvelles synchronisations d'ici le 30 octobre 2026. Vos bases de données synchronisées existantes resteront dans Notion, mais elles cesseront d'être mises à jour après cette date.
Vous pouvez synchroniser les Pull Requests provenant de plusieurs dépôts disponibles via une installation d’application GitHub. Les dépôts sélectionnés alimentent une base de données Notion.
Informations | Propriétés |
|---|---|
Pull Request | Titre, Numéro de PR, URL GitHub, Repository |
État | État : Ouvert, Brouillon, Fusionné ou Fermé |
Auteur | Auteur (GitHub), et Auteur lorsqu’un membre Notion correspondant peut être trouvé |
Organisation | Libellés, Branche de base, Branche source |
Dates | Date de création, Date de mise à jour, Date de fermeture, Date de fusion |
La propriété Auteur (GitHub) contient le nom d’utilisateur GitHub. Auteur est une propriété de type Personne dans Notion lorsque l’e-mail public disponible de l’auteur correspond à celui d’un membre de l’espace de travail.
La propriété Description synchronise la description de la Pull Request sous forme de texte brut, copiée exactement telle qu’elle est écrite dans GitHub. Elle n’est pas rendue au format markdown.
Cette synchronisation n’inclut pas les issues, les commentaires, les responsables ou les détails de revue GitHub.
Vous aurez besoin de :
Être membre de l’espace de travail Notion.
Un compte GitHub avec accès aux repositories que vous souhaitez synchroniser.
Une installation d’application GitHub avec accès à ces repositories.
Un forfait Business (le forfait Mobile Business est également éligible). La synchronisation GitHub n’est pas disponible sur les autres forfaits.
Votre compte GitHub et l'installation de l’application nécessitent tous deux un accès. Votre organisation GitHub peut exiger qu'un Propriétaire approuve ou installe l’application.
Dans Notion, accédez à Paramètres → Connexions → GitHub.
Ouvrez Synchronisation de base de données et connectez votre compte GitHub si ce n'est pas déjà fait.
Terminez les étapes d'autorisation et d'installation de GitHub.
Choisissez l'organisation ou le compte dont vous souhaitez synchroniser les repositories. Utilisez Ajouter une organisation… si vous devez ajouter une autre installation.
Sélectionnez les repositories à inclure.
Choisissez tout l'historique disponible ou une fenêtre d'historique.
Sélectionnez Créer une synchronisation.
Notion crée des GitHub Pull Requests dans votre section Pages privées de la barre latérale et commence à importer les Pull Requests correspondantes.
Conseil : Un dépôt est manquant ? Utilisez Manage access sur GitHub pour vérifier à quels dépôts l'application peut accéder. Si l'installation nécessite une approbation, demandez à un propriétaire d’organisation GitHub de l’approuver.
Lors de la première importation, Notion lit les Pull Requests de chaque repository sélectionné, en commençant par les enregistrements les plus récemment mis à jour et en parcourant l'historique sélectionné.
Après l'importation, Notion vérifie régulièrement chaque repository pour détecter les Pull Requests nouvelles et mises à jour. Les modifications telles qu'une nouvelle étiquette, une Pull Request fermée ou une mise à jour de fusion mettent à jour les propriétés correspondantes dans Notion.
La synchronisation s'exécute même lorsque vous fermez Notion. Les repository volumineux, les limites de requêtes GitHub et les problèmes de service temporaires peuvent retarder les Dernières modifications. Vérifiez l'État de la synchronisation pour connaître la progression ou les erreurs.
Choisissez Tout l'historique, 30 derniers jours, 90 derniers jours ou 365 derniers jours. Lorsque la synchronisation de tout l'historique est proposée sous forme de bouton, laissez Synchroniser tout l'historique disponible activé pour inclure toutes les demandes de tirage disponibles.
La fenêtre utilise l'heure Mis à jour le de la Pull Request. Elle ne dépend pas de la date de création de la Pull Request ni du fait qu'elle soit ouverte, fermée ou fusionnée.
Par exemple, une Pull Request ouverte qui n'a pas été modifiée depuis plus de 90 jours peut se trouver en dehors d'une fenêtre de 90 jours.
Conseil : Les anciennes pages peuvent être supprimées. Lorsqu'une Pull Request sort de la fenêtre sélectionnée, sa page est supprimée de la base de données synchronisée, y compris les valeurs dans vos propres propriétés Notion. Utilisez tout l'historique disponible si vous devez conserver les Pull Request inchangées.
Ouvrez la synchronisation dans Paramètres → Connexions → GitHub → Synchronisation de base de données.
Ajouter des repositories : Modifiez la sélection et sélectionnez Enregistrer les modifications. Notion importe les Pull Requests correspondantes à partir des repositories ajoutés.
Supprimer des repositories : Désélectionnez-les et enregistrez. Leurs pages de Pull Request synchronisées sont supprimées de Notion.
Historique des modifications : Une fenêtre plus longue importe des enregistrements supplémentaires. Une fenêtre plus courte supprime les enregistrements en dehors de la nouvelle fenêtre.
Interrompre les mises à jour : Sélectionnez Interrompre la synchronisation. Les données et paramètres existants sont conservés.
Reprendre les mises à jour : Sélectionnez Reprendre la synchronisation pour continuer la synchronisation.
Avant de supprimer des repositories ou de raccourcir l'historique, conservez toutes les informations propres à Notion dont vous avez besoin à partir des pages concernées.
Créez des vues par repository, état, auteur ou étiquette. Ajoutez vos propres propriétés pour suivre l'état de préparation à la publication ou connectez les Pull Requests au processus de planification de votre équipe. Vos propres valeurs de propriété restent dans Notion.
Pour modifier une propriété GitHub, ouvrez la Pull Request en utilisant URL GitHub et effectuez la modification dans GitHub.
La base de données commence comme Pages privées. Si vous la partagez, les paramètres de partage de Notion déterminent qui peut voir les données importées. Les spectateurs n'ont pas tous besoin d'accéder au repository source, alors examinez les autorisations de la base de données avant de partager des informations sur un repository privé.
Je ne trouve pas d'organisation ou de repository
Vérifiez que vous avez sélectionné le bon compte GitHub et la bonne installation d'application. Confirmez que votre compte et l'application ont accès au repository. Si une organisation restreint les installations d'applications, demandez à un Propriétaire d'approuver l'accès.
Un repository a été renommé ou déplacé.
Ouvrez les paramètres du repository de la synchronisation, vérifiez la sélection du repository et enregistrez-la à nouveau. S'il a été déplacé vers une autre organisation, confirmez que la connexion dispose d'un accès au nouvel emplacement.
La propriété auteur est vide
Un nom d'utilisateur GitHub n'a pas toujours d'adresse e-mail publique disponible correspondant à un membre de l'espace de travail Notion. Utilisez Auteur (GitHub) pour identifier l'auteur lorsque la propriété de personne est vide. Les modifications apportées à l'adresse e-mail ou à l'appartenance à l'espace de travail d'un auteur peuvent ne pas actualiser automatiquement les anciennes Pull Requests synchronisées.
Une Pull Request est manquante.
Confirmez que son repository est sélectionné, que sa dernière mise à jour se situe dans la fenêtre d'historique et que votre vue Notion ne la filtre pas. La première importation est peut-être encore en cours.
La base de données a cessé de se mettre à jour
Ouvrez les détails du statut de la synchronisation. Reconnectez votre compte GitHub ou restaurez l'accès au repository si vous y êtes invité. Les limites de requêtes GitHub et les pannes temporaires peuvent retarder les mises à jour pendant que Notion réessaie.
Pour une comparaison avec Workers et des conseils de dépannage partagés, consultez Synchroniser des données depuis d'autres outils vers Notion →
