Connetti GitHub a Notion
Tieni le pull request insieme ai piani di progetto del tuo team in Notion.
Una sincronizzazione gestita di GitHub porta in Notion il lavoro GitHub che scegli: pull request, issue o entrambi. Notion importa i tuoi record esistenti e controlla gli aggiornamenti su GitHub 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 e le issue 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.
Quando configuri una sincronizzazione del database, Notion crea una nuova pagina nella sezione `Privato`. La sincronizzazione precedente non verrà sostituita: entrambe resteranno disponibili mentre trasferisci il tuo lavoro.
Suggerimento: lascia che Notion AI trasferisca la tua configurazione. Prova un prompt come questo: «Controlla i filtri del mio precedente database GitHub (@menziona la sincronizzazione precedente) e imposta gli stessi filtri nel mio nuovo database GitHub (@menziona la nuova sincronizzazione del database)».
Scegli cosa portare in Notion dai repository disponibili tramite un'installazione di GitHub App: pull request, issue o entrambi. I dati dei repository che selezioni vengono importati in 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.
Puoi sincronizzare le issue di GitHub da sole o insieme alle pull request. Questa sincronizzazione non include i commenti delle pull request né i dettagli delle relative revisioni.
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.
Dai un nome alla tua sincronizzazione e scegli cosa portare in Notion: pull request, issue o entrambi.
Scegli tutta la cronologia disponibile o una finestra temporale.
Seleziona Crea sincronizzazione.
Notion crea il database sincronizzato nella sezione `Privato` della barra laterale e avvia l'importazione dei record 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 e le issue che hai scelto da ciascun repository selezionato, partendo dai record aggiornati più di recente e proseguendo a ritroso nella cronologia selezionata.
Dopo l'importazione, Notion controlla regolarmente ogni repository per record nuovi e aggiornati. Modifiche, quali l'aggiunta di un'etichetta, la chiusura di una pull request o la riapertura di un'issue, aggiorneranno 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 o un'issue aperta che non viene aggiornata da più di 90 giorni può non rientrare in una finestra di 90 giorni.
Suggerimento: le pagine meno recenti possono essere rimosse. Quando una pull request o un'issue 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 o rimuovi issue o pull request: modifica ciò che viene importato e seleziona `Salva modifiche`. Se aggiungi un tipo, vengono importati i record corrispondenti. Se lo rimuovi, le relative pagine vengono eliminate. I record già importati per i tipi che mantieni restano al loro posto.
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 proprietà per monitorare la preparazione al rilascio o collegare pull request e issue al processo di pianificazione del tuo team. I valori di queste proprietà restano in Notion.
Per modificare una proprietà GitHub, apri il record tramite `URL GitHub` e apporta la modifica su 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.
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.
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.
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.
Verifica che il tipo sia incluso nella sincronizzazione, che il repository sia selezionato, che l'ultimo aggiornamento rientri nella finestra cronologica e che la vista in Notion non escluda il record con un filtro. La prima importazione potrebbe essere ancora in corso.
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 →
