> ## Documentation Index
> Fetch the complete documentation index at: https://docs.strattum.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Notion

> Configure o conector Notion para ingerir páginas e bancos de dados do Notion na plataforma strattum.ai.

O conector Notion ingere páginas de bancos de dados (databases) do Notion na infraestrutura strattum.ai. O conteúdo indexado abastece o Knowledge, que responde perguntas com base na documentação e nas bases operacionais do cliente.

## 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

| Objeto (Notion) | Recurso | O que vem |
| - | - | - |
| Database pages | `database_pages` | Páginas de cada database compartilhado, com propriedades e conteúdo |

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](https://www.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**.

> [!WARNING]
>
> O token concede acesso de leitura ao que for compartilhado com a integração. Guarde-o como uma senha.

**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.

> [!NOTE]
>
> 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]

Clique em **Testar Conexão** antes de salvar.

## 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.

| Capacidade (Notion Integration) | Por quê |
| - | - |
| Read content | Ler páginas e propriedades dos databases |
| No user information | Recomendado — o conector não precisa de dados de usuário \[verificar] |

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](https://docs.strattum.ai/data-pipelines/sync-frequency.md) 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

| Sintoma | Causa provável | O que fazer |
| - | - | - |
| `unauthorized` no teste | Token errado ou integração sem acesso | Confira o token e o compartilhamento dos databases |
| Database compartilhado não aparece | Conexão não confirmada no database | Reabra **Connections** e conecte a integração |
| Conteúdo desatualizado | Sync ainda não rodou desde a edição | Aguarde o próximo ciclo ou dispare um sync manual |

## Próximos passos

> **[Confluence](https://docs.strattum.ai/data-pipelines/connectors/confluence.md)**
>
> Conector de documentação alternativo, por espaços do Confluence.

> **[Google Drive](https://docs.strattum.ai/data-pipelines/connectors/google-drive.md)**
>
> Ingira documentos e planilhas de pastas compartilhadas do Drive.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.