> ## Documentation Index
> Fetch the complete documentation index at: https://strattumai.mintlify.site/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

<CardGroup cols={2}>
  <Card title="Internal Integration no Notion" icon="plug">
    Uma Internal Integration criada no workspace, para gerar o Integration Token.
  </Card>

  <Card title="Databases compartilhados" icon="share-nodes">
    Cada database a ingerir precisa ser compartilhado explicitamente com a integração.
  </Card>
</CardGroup>

## Configuração

<Steps>
  <Step title="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.
    </Warning>
  </Step>

  <Step title="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]
    </Note>
  </Step>

  <Step title="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.
  </Step>
</Steps>

## 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](/data-pipelines/sync-frequency) 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

<CardGroup cols={2}>
  <Card title="Confluence" icon="confluence" href="/data-pipelines/connectors/confluence">
    Conector de documentação alternativo, por espaços do Confluence.
  </Card>

  <Card title="Google Drive" icon="google-drive" href="/data-pipelines/connectors/google-drive">
    Ingira documentos e planilhas de pastas compartilhadas do Drive.
  </Card>
</CardGroup>