Conectar o GitHub ao Notion
Mantenha os Pull Requests junto aos planos de projeto da sua equipe no Notion.
Uma sincronização gerenciada do GitHub traz o trabalho do GitHub que você escolher para o Notion: Pull Requests, issues ou ambos. O Notion importa seus registros existentes e verifica o GitHub em busca de atualizações em segundo plano.
Este guia aborda a Sincronização de base de dados nas configurações da sua conexão com o GitHub. As propriedades sincronizadas são somente leitura. Faça alterações nos Pull Requests e issues no GitHub.
Observação: Esta integração com o GitHub substitui nossa versão legada. Para manter seus dados externos atualizados, configure suas novas sincronizações até 30 de outubro de 2026. Suas bases de dados sincronizadas existentes permanecerão no Notion, mas elas pararão de atualizar após essa data.
Ao configurar uma sincronização de base de dados, o Notion cria uma nova página na sua seção Particular. Ela não substitui a sincronização antiga: as duas continuam disponíveis enquanto você migra seu trabalho.
Dica: Deixe a IA do Notion migrar sua configuração para você. Experimente um prompt como: “Confira os filtros da minha base de dados antiga do GitHub (@mention minha sincronização antiga) e aplique os mesmos filtros à minha nova base de dados do GitHub (@mention minha nova sincronização de base de dados).”
Escolha o que trazer para o Notion dos repositórios disponíveis na instalação do GitHub App: Pull Requests, issues ou ambos. Os dados dos repositórios selecionados serão sincronizados com o Notion.
Informações | Propriedades |
|---|---|
Pull Request | Título, Número da PR, URL do GitHub, Repositório |
Estado | Estado: Aberto, Rascunho, Mesclado ou Fechado |
Autor | Autor (GitHub) e Autor quando um membro correspondente do Notion puder ser encontrado |
Organização | Rótulos, Branch base, Branch de origem |
Datas | Criado em, Atualizado em, Fechado em, Mesclado em |
A propriedade Autor (GitHub) contém o nome de usuário do GitHub. Autor é uma propriedade de pessoa do Notion quando o e-mail público disponível do autor corresponde a um membro do espaço de trabalho.
A propriedade Descrição sincroniza a descrição do Pull Request como texto sem formatação, copiada exatamente como escrita no GitHub. Ela não é renderizada como markdown.
Você pode sincronizar issues do GitHub isoladamente ou junto com Pull Requests. Esta sincronização não inclui comentários de Pull Request ou detalhes de revisão.
Você precisará de:
Ser membro do espaço de trabalho do Notion.
Uma conta do GitHub com acesso aos repositórios que você deseja sincronizar.
Uma instalação do GitHub App com acesso a esses repositórios.
Um Plano Business (o Mobile Business também é qualificado). A sincronização do GitHub não está disponível em outros planos.
Tanto sua conta do GitHub quanto a instalação do app precisam de acesso. Sua organização do GitHub pode exigir que um proprietário aprove ou instale o app.
No Notion, acesse Configurações → Conexões → GitHub.
Abra Sincronização de base de dados e conecte sua conta do GitHub, caso ainda não tenha feito isso.
Conclua as etapas de autorização e instalação do GitHub.
Escolha a organização ou conta cujos repositórios você deseja sincronizar. Use Adicionar organização… se precisar adicionar outra instalação.
Selecione os repositórios a serem incluídos.
Dê um nome à sincronização e escolha o que trazer para o Notion: Pull Requests, issues ou ambos.
Escolha todo o histórico disponível ou um período de histórico.
Selecione Criar sincronização.
O Notion cria a base de dados sincronizada na seção Particular da sua barra lateral e começa a importar registros correspondentes.
Dica: Um repositório está faltando? Use Gerenciar acesso no GitHub para verificar quais repositórios o app pode acessar. Se a instalação exigir aprovação, peça a um proprietário da organização que a aprove.
Na primeira importação, o Notion lê os Pull Requests e as issues escolhidos de cada repositório selecionado. Ele começa pelos registros atualizados mais recentemente e percorre o histórico selecionado.
Após a importação, o Notion verifica regularmente cada repositório em busca de registros novos e atualizados. Alterações como um novo rótulo, um Pull Request fechado ou uma issue reaberta atualizarão as propriedades correspondentes no Notion.
A sincronização é executada mesmo quando você fecha o Notion. Repositórios grandes, limites de solicitação do GitHub e problemas temporários no serviço podem atrasar as atualizações. Verifique o status da sincronização para ver o progresso ou erros.
Escolha Todo o histórico, Últimos 30 dias, Últimos 90 dias ou Últimos 365 dias. Quando a sincronização de todo o histórico for oferecida como uma opção, mantenha Sincronizar todo o histórico disponível ativado para incluir todas as solicitações de pull disponíveis.
A janela usa o horário de Atualizado em do Pull Request. Ele não depende de quando o Pull Request foi criado ou se está aberto, fechado ou mesclado.
Por exemplo, um Pull Request aberto ou uma issue aberta que não sofre alterações há mais de 90 dias pode ficar fora de uma janela de 90 dias.
Dica: Páginas mais antigas podem ser removidas. Quando um Pull Request ou uma issue fica fora do período selecionado, a página correspondente é removida da base de dados sincronizada, junto com os valores das propriedades que você adicionou no Notion. Use todo o histórico disponível se precisar manter Pull Requests sem alterações.
Abra a sincronização em Configurações → Conexões → GitHub → Sincronização de base de dados.
Adicionar ou remover issues ou Pull Requests: Altere o que a sincronização importa e selecione Salvar alterações. Ao adicionar um tipo, você importa os registros correspondentes. Ao remover um tipo, você exclui as páginas correspondentes. Os registros já importados dos tipos mantidos continuam no Notion.
Adicionar repositórios: Edite a seleção e selecione Salvar alterações. O Notion importa os Pull Requests correspondentes dos repositórios adicionados.
Remover repositórios: Desmarque-os e salve. Suas páginas de Pull Request sincronizadas são removidas do Notion.
Histórico de alterações: Uma janela mais longa importa registros adicionais. Uma janela mais curta remove registros fora da nova janela.
Pausar atualizações: Selecione Pausar sincronização. Os dados e configurações existentes permanecem.
Retomar atualizações: Selecione Retomar sincronização para continuar sincronizando.
Antes de remover repositórios ou encurtar o histórico, preserve todas as informações exclusivas do Notion que você precisar das páginas afetadas.
Crie visualizações por repositório, estado, autor ou rótulo. Adicione suas próprias propriedades para acompanhar a preparação para o lançamento ou integrar Pull Requests e issues ao planejamento da sua equipe. Os valores dessas propriedades permanecem no Notion.
Para alterar uma propriedade do GitHub, abra o registro usando URL do GitHub e faça a alteração no GitHub.
O banco de dados começa como Particular. Se você compartilhá-lo, as configurações de compartilhamento do Notion determinarão quem pode ver os dados importados. Os visualizadores não precisam de acesso individual ao repositório de origem, portanto, revise as permissões do banco de dados antes de compartilhar informações de repositórios particulares.
Verifique se você selecionou a conta do GitHub e a instalação do app corretas. Confirme se tanto sua conta quanto o app têm acesso ao repositório. Se uma organização restringir instalações de apps, peça a um proprietário para aprovar o acesso.
Abra as configurações de repositório da sincronização, revise a seleção do repositório e salve-a novamente. Se ele foi movido para uma organização diferente, confirme se a conexão tem acesso no novo local.
Um nome de usuário do GitHub nem sempre tem um e-mail público disponível que corresponda a um membro do espaço de trabalho do Notion. Use Autor (GitHub) para identificar o autor quando a propriedade de pessoa estiver vazia. Alterações no e-mail ou na associação ao espaço de trabalho de um autor podem não atualizar automaticamente os Pull Requests sincronizados anteriormente.
Confirme se a sincronização inclui esse tipo de registro, se o repositório está selecionado, se a última atualização está dentro do período escolhido e se algum filtro da visualização do Notion não está ocultando o registro. A primeira importação ainda pode estar em andamento.
Abra os detalhes de status da sincronização. Reconecte sua conta do GitHub ou restaure o acesso ao repositório, se solicitado. Limites de solicitação do GitHub e interrupções temporárias podem atrasar as atualizações enquanto o Notion tenta novamente.
Para uma comparação com Workers e orientações de solução de problemas compartilhadas, consulte Sincronizar dados de outras ferramentas para o Notion →
