Connetti GitHub a Notion
Tieni le pull request insieme ai piani di progetto del tuo team in Notion.
Una sincronizzazione gestita di GitHub crea un GitHub Pull Requests database dai repository che scegli. Notion importa le pull request esistenti e controlla GitHub per gli aggiornamenti in background.
Questa guida tratta la sincronizzazione del database nelle impostazioni di connessione GitHub. Le proprietà sincronizzate sono di sola lettura. Modifica le pull request direttamente su GitHub.
Nota: Questa integrazione GitHub sostituisce la nostra versione precedente. Per mantenere aggiornati i tuoi dati esterni, configura le tue nuove sincronizzazioni entro il 30 ottobre 2026. I tuoi database sincronizzati esistenti rimarranno in Notion, ma smetteranno di aggiornarsi dopo tale data.
Puoi sincronizzare le pull request da più repository disponibili tramite un'installazione dell'app GitHub. I repository selezionati confluiscono in un unico database Notion.
Informazioni | Proprietà |
|---|---|
Pull request | Titolo, Numero PR, URL GitHub, Repository |
Stato | Stato: Aperta, Bozza, Merge o Chiusa |
Autore | Autore (GitHub) e Autore quando viene trovato un membro di Notion corrispondente |
Organizzazione | Etichette, Branch di base, Branch di origine |
Date | Data di creazione, Data di aggiornamento, Data di chiusura, Data di merge |
La proprietà Autore (GitHub) contiene il nome utente GitHub. Autore è una proprietà persona di Notion quando l'email pubblica disponibile dell'autore corrisponde a quella di un membro dello spazio di lavoro.
La proprietà Descrizione sincronizza la descrizione della pull request come testo semplice, copiata esattamente come scritta in GitHub. Non viene renderizzata come Markdown.
Questa sincronizzazione non include issue, commenti, responsabili o dettagli di revisione di GitHub.
Avrai bisogno di:
Essere membro dello spazio di lavoro Notion.
Un account GitHub con accesso ai repository che desideri sincronizzare.
Un'installazione dell'app GitHub con accesso a tali repository.
Un piano Business (anche Mobile Business è valido). La sincronizzazione di GitHub non è disponibile con altri piani.
Sia il tuo account GitHub che l'installazione dell'app necessitano di accesso. La tua organizzazione GitHub potrebbe richiedere che un responsabile approvi o installi l'app.
In Notion, vai su Impostazioni → Connessioni → GitHub.
Apri Database sync e connetti il tuo account GitHub se non l'hai già fatto.
Completa i passaggi di autorizzazione e installazione di GitHub.
Scegli l'organizzazione o l'account di cui vuoi sincronizzare i repository. Usa Aggiungi organizzazione… se devi aggiungere un'altra installazione.
Seleziona i repository da includere.
Scegli tutta la cronologia disponibile o una finestra temporale.
Seleziona Crea sincronizzazione.
Notion crea GitHub Pull Requests nella sezione Privato della tua barra laterale e inizia a importare le pull request corrispondenti.
Suggerimento: Manca un repository? Usa Gestisci accesso su GitHub per controllare a quali repository l'app può accedere. Se l'installazione richiede l'approvazione, chiedi a un proprietario dell'organizzazione GitHub di approvarla.
Durante la prima importazione, Notion legge le pull request da ciascun repository selezionato, partendo dai record aggiornati più di recente e attraversando la cronologia selezionata.
Dopo l'importazione, Notion controlla regolarmente ogni repository per nuove pull request e aggiornamenti. Modifiche, quali l'aggiunta di un'etichetta, la chiusura di una pull request o un merge, aggiornano le proprietà corrispondenti in Notion.
La sincronizzazione viene eseguita anche quando chiudi Notion. Repository di grandi dimensioni, limiti di richieste di GitHub e problemi temporanei del servizio possono ritardare gli aggiornamenti. Controlla lo stato della sincronizzazione per verificare l'avanzamento o eventuali errori.
Scegli Tutta la cronologia, Ultimi 30 giorni, Ultimi 90 giorni o Ultimi 365 giorni. Quando la sincronizzazione di tutta la cronologia è offerta come opzione, lascia attivato Sincronizza tutta la cronologia disponibile per includere tutte le pull request disponibili.
La finestra utilizza l'orario Aggiornato il della pull request. Non dipende da quando la pull request è stata creata o se è aperta, chiusa o merge.
Ad esempio, una pull request aperta che non è stata modificata da più di 90 giorni può ricadere al di fuori di una finestra di 90 giorni.
Suggerimento: le pagine meno recenti possono essere rimosse. Quando una pull request non rientra nella finestra selezionata, la sua pagina viene rimossa dal database sincronizzato, inclusi i valori nelle tue proprietà Notion. Usa tutta la cronologia disponibile se devi conservare le pull request invariate.
Apri la sincronizzazione in Impostazioni → Connessioni → GitHub → Sincronizzazione database.
Aggiungi repository: Modifica la selezione e seleziona Salva modifiche. Notion importa le pull request corrispondenti dai repository aggiunti.
Rimuovi repository: Deselezionali e salva. Le loro pagine di pull request sincronizzate vengono rimosse da Notion.
Cronologia modifiche: Una finestra più lunga importa record aggiuntivi. Una finestra più breve rimuove i record al di fuori della nuova finestra.
Metti in pausa gli aggiornamenti: Seleziona Metti in pausa sincronizzazione. I dati e le impostazioni esistenti rimangono.
Riprendi gli aggiornamenti: Seleziona Riprendi sincronizzazione per continuare la sincronizzazione.
Prima di rimuovere repository o accorciare la cronologia, conserva le informazioni presenti solo in Notion di cui hai bisogno dalle pagine interessate.
Crea viste per repository, stato, autore o etichetta. Aggiungi le tue proprietà per monitorare la prontezza al rilascio o connettere le pull request al processo di pianificazione del tuo team. I valori delle tue proprietà rimangono in Notion.
Per modificare una proprietà GitHub, apri la pull request usando URL GitHub ed effettua la modifica in GitHub.
Il database inizia come privato. Se lo condividi, le impostazioni di condivisione di Notion determinano chi può vedere i dati importati. Chi visualizza non necessita di accesso al repository di origine, quindi rivedi i permessi del database prima di condividere informazioni su repository privati.
Non riesco a trovare un'organizzazione o un repository
Verifica di aver selezionato l'account GitHub e l'installazione dell'app corretti. Conferma che sia il tuo account che l'app abbiano accesso al repository. Se un'organizzazione limita le installazioni di app, chiedi a un proprietario di approvare l'accesso.
Un repository è stato rinominato o spostato
Apri le impostazioni del repository della sincronizzazione, rivedi la selezione del repository e salvala di nuovo. Se è stato spostato in un'organizzazione diversa, conferma che la connessione abbia accesso nella nuova posizione.
La proprietà Autore è vuota
Un nome utente GitHub non ha sempre un'email pubblica disponibile che corrisponda a un membro dello spazio di lavoro Notion. Usa Autore (GitHub) per identificare l'autore quando la proprietà persona è vuota. Le modifiche all'email o all'appartenenza allo spazio di lavoro di un autore potrebbero non aggiornare automaticamente le pull request sincronizzate precedenti.
Manca una pull request
Conferma che il suo repository sia selezionato, che il suo ultimo aggiornamento rientri nella finestra della cronologia e che la tua vista Notion non lo stia filtrando. La prima importazione potrebbe essere ancora in corso.
Il database ha smesso di aggiornarsi
Apri i dettagli dello stato della sincronizzazione. Riconnetti il tuo account GitHub o ripristina l'accesso al repository se richiesto. I limiti di richiesta di GitHub e le interruzioni temporanee possono ritardare gli aggiornamenti mentre Notion riprova.
Per un confronto con Workers e una guida alla risoluzione dei problemi condivisa, vedi Sincronizza dati da altri strumenti a Notion →
