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
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.
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:
minhaempresademinhaempresa.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.
Autenticação e escopos
A autenticação é Basic (e-mail + API token) contrahttps://<domínio>.atlassian.net/wiki/rest/api. O acesso segue as permissões do usuário Atlassian dono do token.
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
Próximos passos
Notion
Conector de documentação alternativo, por databases do Notion.
Google Drive
Ingira documentos e planilhas de pastas compartilhadas do Drive.