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

# Confluence

> Configure o conector Confluence para ingerir páginas de espaços do Confluence Cloud na plataforma strattum.ai.

O conector Confluence ingere páginas dos espaços (spaces) do Confluence Cloud na infraestrutura strattum.ai. O conteúdo abastece o Knowledge, que responde perguntas com base na documentação interna, runbooks e políticas do cliente.

## Capacidades

* Ingerir as páginas dos espaços do Confluence que você selecionar.
* Indexação incremental por data de modificação da página \[verificar].
* Disponibilizar o conteúdo para busca semântica no Knowledge.

## Objetos suportados

| Objeto (Confluence) | Recurso | O que vem                                            |
| ------------------- | ------- | ---------------------------------------------------- |
| Pages               | `pages` | Páginas dos espaços selecionados, com título e corpo |

Blog posts, comentários e anexos: \[verificar].

## Pré-requisitos

<CardGroup cols={2}>
  <Card title="Conta Atlassian" icon="atlassian">
    Um usuário Atlassian com acesso de leitura aos espaços que deseja ingerir.
  </Card>

  <Card title="API Token" icon="key">
    Um API token gerado na conta Atlassian, usado com o e-mail em autenticação Basic.
  </Card>
</CardGroup>

## Configuração

O conector usa autenticação Basic contra a REST API do Confluence Cloud, com o e-mail do usuário e um API token.

<Steps>
  <Step title="Gere um API token">
    Em [id.atlassian.com/manage-profile/security/api-tokens](https://id.atlassian.com/manage-profile/security/api-tokens), clique em **Create API token**, dê um nome descritivo e copie o token.

    <Warning>
      O token é exibido apenas uma vez. Copie-o antes de fechar a janela.
    </Warning>
  </Step>

  <Step title="Identifique os space keys">
    A space key aparece na URL do espaço (ex: `.../wiki/spaces/ENG/...` → key `ENG`) ou em **Space settings**. Anote as keys dos espaços a ingerir.
  </Step>

  <Step title="Adicione o conector no Console">
    Em **Data Pipelines**, clique em **+ Nova Conexão**, busque por **Confluence** e preencha:

    * **Nome do Conector** — Obrigatório. Identifica o conector na lista.
    * **Domínio** — Obrigatório. Subdomínio Atlassian (ex: `minhaempresa` de `minhaempresa.atlassian.net`).
    * **E-mail** — Obrigatório. E-mail da conta Atlassian.
    * **API Token** — Obrigatório. Token gerado acima.
    * **Space Keys** — Obrigatório. Lista de espaços a sincronizar.

    Clique em **Testar Conexão** antes de salvar.
  </Step>
</Steps>

## Autenticação e escopos

A autenticação é Basic (e-mail + API token) contra `https://<domínio>.atlassian.net/wiki/rest/api`. O acesso segue as permissões do usuário Atlassian dono do token.

| Permissão | Escopo            | Por quê                                 |
| --------- | ----------------- | --------------------------------------- |
| View      | Espaços a ingerir | Ler as páginas dos espaços selecionados |

Use um usuário com acesso apenas de leitura aos espaços necessários. O conector não escreve no Confluence.

## Frequência de sync

A frequência é definida por conector, na tela de configuração. Para documentação, **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**. Blog posts, comentários e anexos: \[verificar].
* Só espaços cujas keys forem informadas (e visíveis ao usuário do token) são ingeridos.
* Macros e conteúdo dinâmico do Confluence podem ser indexados como texto renderizado, sem a lógica da macro. \[verificar]
* Confluence Server / Data Center (on-premise): o conector cobre Confluence **Cloud**. \[verificar] suporte a Server com o time.

## Troubleshooting

| Sintoma                     | Causa provável                         | O que fazer                                          |
| --------------------------- | -------------------------------------- | ---------------------------------------------------- |
| `401 Unauthorized` no teste | E-mail ou API token errado             | Confira os dois e regenere o token se preciso        |
| Espaço não aparece          | Space key errada ou usuário sem acesso | Confira a key e a permissão do usuário no espaço     |
| `404` no domínio            | Subdomínio Atlassian incorreto         | Use só o subdomínio, sem `.atlassian.net`            |
| Páginas faltando            | Restrições de página no Confluence     | Verifique restrições de leitura na página específica |

## Próximos passos

<CardGroup cols={2}>
  <Card title="Notion" icon="notion" href="/data-pipelines/connectors/notion">
    Conector de documentação alternativo, por databases do Notion.
  </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>