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

# 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

> **Conta Atlassian**
>
> Um usuário Atlassian com acesso de leitura aos espaços que deseja ingerir.

> **API Token**
>
> Um API token gerado na conta Atlassian, usado com o e-mail em autenticação Basic.

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

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

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

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

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

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

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