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, clique em Create API token, dê um nome descritivo e copie o token.

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

Conector de documentação alternativo, por databases do Notion.

Google Drive

Ingira documentos e planilhas de pastas compartilhadas do Drive.