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 cria uma base de dados de Pull Requests do GitHub a partir dos repositórios que você escolher. O Notion importa os Pull Requests existentes e verifica o GitHub para Todas as 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 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.
Você pode sincronizar Pull Requests de vários repositórios disponíveis por meio de uma instalação do GitHub App. Os repositórios selecionados feed para uma base de dados do 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.
Esta sincronização não inclui issues, comentários, Responsáveis ou detalhes de resenha do GitHub.
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.
Escolha todo o histórico disponível ou um período de histórico.
Selecione Criar sincronização.
O Notion cria Pull Requests do GitHub na seção Particular da sua barra lateral e começa a importar os Pull Requests 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.
Durante a primeira importação, o Notion lê os Pull Requests de cada repositório selecionado, começando pelos registros atualizados mais recentemente e processando todo o histórico selecionado.
Após a importação, o Notion verifica regularmente cada repositório em busca de Pull Requests novas e atualizadas. Alterações como um novo rótulo, um Pull Request fechado ou uma mesclagem atualizam 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 que não foi alterado 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 cai fora da janela selecionada, sua página é removida da base de dados sincronizada, incluindo valores em suas próprias propriedades do Notion. Use todo o histórico disponível se precisar manter Pull Requests inalterados.
Abra a sincronização em Configurações → Conexões → GitHub → Sincronização de base de dados.
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 prontidão de lançamento ou conectar Pull Requests ao processo de planejamento da sua equipe. Os valores das suas próprias propriedades permanecem no Notion.
Para alterar uma propriedade do GitHub, abra o Pull Request 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.
Não consigo encontrar uma organização ou repositório
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.
Um repositório foi renomeado ou movido
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.
A propriedade Autor está vazia
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.
Um Pull Request está faltando.
Confirme se o repositório dele está selecionado, se a última atualização está dentro da janela de histórico e se a sua visualização do Notion não o está filtrando. A primeira importação ainda pode estar em execução.
O banco de dados parou de atualizar
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 →
