Sincronize dados de outras ferramentas com o Notion

Neste documento de ajuda

Traga dados de ferramentas como GitHub, Jira e Salesforce para bases de dados do Notion que são atualizadas automaticamente.


Nossas sincronizações de base de dados permitem que você trabalhe com e enriqueça informações de outras ferramentas junto com os planos, documentos e projetos da sua equipe. Conecte uma conta, escolha o que sincronizar, e o Notion cria as bases de dados e as mantém atualizadas.

O Notion gerencia essas sincronizações para que você possa conectar uma conta e usar bases de dados sincronizadas sem precisar criar ou manter a integração por conta própria.

Conexão

Dados que você pode sincronizar

Bases de dados criadas

GitHub

Pull Requests de repositórios selecionados

Solicitações de atualização

Jira

Espaços e itens de trabalho de espaços selecionados do Jira Cloud

Espaços do Jira e itens de trabalho do Jira

Salesforce

Contas, contatos e oportunidades

Contas, contatos e/ou oportunidades, dependendo da seleção

Cada registro da outra ferramenta se torna uma página em uma base de dados do Notion. Os campos da fonte se tornam propriedades da base de dados.

As sincronizações gerenciadas atualizam os dados em uma direção: da ferramenta conectada para o Notion. As propriedades sincronizadas são somente leitura no Notion. Para alterar um valor sincronizado, atualize-o no GitHub, Jira ou Salesforce. Você verá a alteração no Notion.

As sincronizações são executadas automaticamente em segundo plano. O tempo de atualização varia de acordo com a conexão, a quantidade de dados e os limites de solicitação da ferramenta de origem.

Observação: Precisa conectar outra ferramenta? Se a ferramenta que você deseja conectar não for suportada, use Notion Workers para criar uma sincronização personalizada ou siga nossos guias de Workers pré-criados para Asana e GitLab.

Você precisará ser um membro do espaço de trabalho do Notion e ter uma conta com acesso aos dados que deseja sincronizar. Sua organização pode exigir que um administrador aprove a conexão ou conceda acesso na ferramenta de origem.

A conta que você usa para criar a sincronização determina quais dados o Notion pode ler. Se as permissões dela mudarem ou a conexão expirar, a sincronização pode exigir que você se autentique novamente.

O GitHub Sync e o Jira Sync exigem um Plano Business (ou o complemento Mobile Business). O Salesforce Sync exige um Plano Enterprise.

  1. Abra Configurações → Conexões no seu espaço de trabalho do Notion.

  2. Abra a conexão que você deseja sincronizar (GitHub, Jira ou Salesforce) em Navegar ou Instalado e, em seguida, escolha Sincronização de base de dados nas opções dessa conexão.

  3. Conecte uma conta e conclua as etapas de autorização para essa ferramenta.

  4. Escolha os repositórios, espaços ou tipos de objeto que você deseja sincronizar.

  5. Escolha quanto histórico incluir. Para fontes que oferecem propriedades personalizadas, como Jira e Salesforce, você também pode escolher quais propriedades personalizadas incluir na sua sincronização.

  6. Selecione Criar sincronização.

O Notion cria as bases de dados na seção Particular da sua barra lateral. A primeira importação começa em segundo plano. Você pode abrir as bases de dados enquanto os registros ainda estão sendo importados.

A primeira importação

O Notion cria a estrutura da base de dados e, em seguida, importa os registros que correspondem às suas configurações. Importações grandes podem levar mais tempo porque o Notion lê dados em lotes e segue os limites de solicitação da ferramenta de origem.

A base de dados pode mostrar apenas parte dos seus dados enquanto a primeira importação estiver em execução. Você não precisa manter o Notion aberto para que a importação continue.

Atualizações contínuas

Após a primeira importação, o Notion verifica regularmente a ferramenta conectada em busca de registros novos ou alterados e atualiza as propriedades sincronizadas. As sincronizações continuam em segundo plano, mesmo quando ninguém está em uma visualização da base de dados.

Em geral, esperamos que as alterações sejam sincronizadas com o Notion em alguns minutos ou menos.

O tempo varia de acordo com a conexão, a quantidade de dados e a disponibilidade da ferramenta de origem. Uma verificação de alterações não significa que cada alteração apareça no Notion imediatamente. O Salesforce verifica alterações a cada minuto por padrão; consulte o guia de cada conexão para obter detalhes.

Quando a fonte limita temporariamente as solicitações ou fica indisponível, o Notion tenta novamente. Se a sincronização precisar de uma nova autorização ou permissões diferentes, o status informará o que fazer.

Janelas de histórico

Você pode incluir todo o histórico disponível ou limitar a sincronização aos registros atualizados nos últimos 30, 90 ou 365 dias. Uma janela de histórico usa a hora da última atualização do registro de origem, em vez da data de criação. O Salesforce usa seu horário de modificação do sistema.

A janela avança com o tempo. Um registro pode sair da base de dados quando não tiver sido atualizado dentro dessa janela, mesmo que ainda esteja aberto ou ativo na ferramenta de origem.

Observação: Uma janela de histórico pode remover páginas. Quando um registro fica fora da janela, sua página sincronizada é removida do Notion, incluindo quaisquer valores que você adicionou a essa página em suas próprias propriedades. Escolha todo o histórico disponível se precisar manter registros mais antigos e inalterados.

Expandir a janela importa registros correspondentes adicionais. Encurtá-la remove registros que não se qualificam mais. Isso é diferente de um filtro de base de dados do Notion, que apenas altera o que uma visualização exibe.

Você pode criar visualizações, filtrar e ordenar registros e adicionar suas próprias propriedades do Notion. Por exemplo, adicione uma prioridade de equipe a Pull Requests ou um Status de Plano de conta a contas do Salesforce. Os valores nessas propriedades permanecem no Notion.

Dê nomes distintos às suas próprias propriedades para que não entrem em conflito com as propriedades gerenciadas pela sincronização.

As bases de dados começam como páginas Particulares. Compartilhe-as usando as permissões de página do Notion quando estiver pronto.

Observação: O compartilhamento do Notion controla quem pode ver os dados sincronizados. Uma pessoa com acesso à base de dados do Notion pode conseguir ver registros que ela não pode acessar na fonte. As autorizações da fonte não são copiadas para cada visualizador no Notion. Revise a autorização de acesso antes de compartilhar.

Uma alteração na autorização na ferramenta de fonte pode interromper as atualizações futuras sem remover os dados que já estão no Notion. Revise as configurações de compartilhamento da base de dados do Notion quando o acesso à fonte for alterado.

Retorne às configurações de sincronização de base de dados da conexão para revisar o Status da sincronização, informações de execução recente e quaisquer detalhes de erro.

Status

O que fazer

Inicializando ou preenchendo dados

A sincronização está sendo configurada ou importando registros existentes. Permita que a importação continue.

Funcional

A sincronização está sendo executada normalmente. Alterações recentes na fonte ainda podem estar sendo processadas.

Degradado ou com falha

Abra os detalhes de erro da sincronização para ver o que está atrasando as atualizações.

Ação necessária

Siga as instruções exibidas, como reconectar uma conta ou restaurar o acesso à fonte.

Desativado

A sincronização está pausada. Você pode retomar nas configurações da sincronização.

Indisponível

As informações de Status não estão disponíveis no momento. Verifique novamente mais tarde.

Um horário de execução recente mostra atividade. Isso não garante que todas as alterações da fonte já chegaram ao Notion.

Use uma sincronização gerenciada quando uma das conexões compatíveis incluir os dados e as configurações de que você precisa. O Notion lida com a importação inicial, verificações recorrentes e a lógica de sincronização específica da conexão.

Use um Worker do Notion quando precisar criar uma sincronização personalizada, como importar de outro serviço ou transformar dados antes que eles cheguem ao Notion.

O que você precisa

Sincronização de base de dados gerenciada

Worker

Configure uma conexão compatível sem código

Escolha uma conta, dados e configurações no Notion.

Requer código e implantação.

Escolha a estrutura de dados

Use os registros e propriedades compatíveis da conexão.

Defina um esquema e transformações personalizados.

Personalize como os dados são buscados

Use o comportamento de sincronização integrado.

Implemente as solicitações da fonte e o comportamento de sincronização que seu fluxo de trabalho precisa.

Mantenha a sincronização

O Notion mantém a lógica de conexão integrada.

Sua equipe mantém o código do Worker; o Notion executa o Worker.

Por exemplo, use uma sincronização gerenciada do GitHub para rastrear Pull Requests no Notion. Considere um Worker se você precisar de uma origem personalizada, tipos de registro adicionais ou cálculos que combinem dados antes da importação.

Registros ausentes

Verifique os repositórios, espaços ou tipos de objeto selecionados, sua janela de histórico e as autorizações de fonte da conta conectada. Verifique também se a primeira importação ainda está em execução e se um filtro de visualização do Notion está ocultando registros.

Relações ausentes

Se uma página sincronizada deveria estar relacionada a outra página sincronizada, mas não está, pode ser por causa da sua janela de histórico ou porque a página relacionada ainda está sendo importada. Nós criamos relações apenas quando ambas as páginas estão sincronizadas com bases de dados do Notion.

Todas as atualizações pararam

Abra os detalhes do status da sincronização. Reconecte se a autorização tiver expirado ou peça ao administrador da sua fonte para restaurar o acesso. Interrupções temporárias na fonte e limites de solicitação podem atrasar as atualizações enquanto o Notion tenta novamente.

A sincronização atingiu um limite de linhas

Reduza os dados selecionados ou escolha uma janela de histórico menor. Revise o efeito antes de salvar: remover uma fonte ou encurtar o histórico pode remover páginas sincronizadas. Os guias específicos da conexão explicam o que acontece quando você altera uma seleção.

Para uma sincronização existente do Asana ou GitLab, use os guias de substituição do Worker:


Dar feedback

Este recurso foi útil?


Powered by Fruition