Capacidades
- Ingerir as páginas dos databases do Notion que você compartilhar com a integração.
- Indexação incremental por
last_edited_time[verificar]. - Disponibilizar o conteúdo para busca semântica no Knowledge.
Objetos suportados
Páginas soltas fora de um database e blocos de tipos específicos (embeds, arquivos): [verificar].
Pré-requisitos
Internal Integration no Notion
Uma Internal Integration criada no workspace, para gerar o Integration Token.
Databases compartilhados
Cada database a ingerir precisa ser compartilhado explicitamente com a integração.
Configuração
1
Crie uma Internal Integration
Em notion.so/my-integrations, clique em New integration, associe ao workspace e conceda as capacidades de leitura de conteúdo. Copie o Internal Integration Token.
2
Compartilhe os databases com a integração
Abra cada database no Notion, clique em ···→ Connections → Connect to e selecione a integração. Só o que é compartilhado fica visível ao conector.
Databases não compartilhados permanecem invisíveis. Compartilhar uma página-mãe não expõe automaticamente todos os databases filhos — confirme cada um. [verificar]
3
Adicione o conector no Console
Em Data Pipelines, clique em + Nova Conexão, busque por Notion e preencha:
- Nome do Conector — Obrigatório. Identifica o conector na lista.
- Integration Token — Obrigatório. Token copiado acima.
- Database IDs — Opcional. Lista dos databases a ingerir. Se vazio, o conector usa todos os databases compartilhados com a integração. [verificar]
Autenticação e escopos
A autenticação usa o Internal Integration Token. As capacidades são definidas na criação da integração no Notion.
Não conceda capacidades de escrita (
Insert content, Update content). O conector só lê.
Frequência de sync
A frequência é definida por conector, na tela de configuração. Para bases de conhecimento que mudam devagar, diário costuma bastar. Veja Frequência de sync para o detalhe de cada opção.Limitações conhecidas
- O conector ingere páginas de databases. Páginas avulsas fora de um database: [verificar].
- Blocos de mídia (imagens, arquivos, embeds) não têm o conteúdo binário indexado — só o texto. [verificar]
- Compartilhamento é por database e não é herdado de páginas-mãe de forma garantida.
- A API do Notion tem rate limit (~3 requisições/segundo). Workspaces grandes levam mais tempo na primeira carga. [verificar]
Troubleshooting
Próximos passos
Confluence
Conector de documentação alternativo, por espaços do Confluence.
Google Drive
Ingira documentos e planilhas de pastas compartilhadas do Drive.