Como Integrar o Atlassian Confluence Cloud com o Amazon Quick

O problema que essa integração resolve

Quem trabalha com times de engenharia ou produto conhece bem o cenário: a documentação fica no Atlassian Confluence Cloud, os dados ficam em outros sistemas, e a equipe passa boa parte do dia alternando entre ferramentas para reunir contexto suficiente para tomar uma decisão. Esse vai e vem consome tempo e cria lacunas entre o conhecimento disponível e as ações que precisam ser tomadas.

Para resolver isso, a AWS detalhou como conectar o Confluence Cloud ao Amazon Quick, seu assistente de IA voltado para produtividade empresarial. Com essa integração, equipes conseguem consultar páginas do Confluence, recuperar documentação e até atualizar conteúdo — tudo por meio de consultas em linguagem natural, diretamente na interface do Quick, sem precisar abrir outra aba.

Como o Amazon Quick organiza as integrações

Antes de entrar no passo a passo, vale entender como o Quick categoriza suas integrações. Existem três tipos principais:

• Actions: conectam o Quick a sistemas externos no momento da consulta, permitindo leitura, escrita e automação de tarefas em tempo real.
• Knowledge bases (bases de conhecimento): indexam conteúdo não estruturado — como documentos e wikis — antes que o usuário faça a consulta, criando um índice pesquisável por linguagem natural.
• Topics e Datasets: permitem consultas em linguagem natural sobre fontes de dados estruturados, como o Amazon Redshift.

Este guia da AWS foca nas duas primeiras categorias: Knowledge bases e Actions. O Confluence Cloud suporta ambas as abordagens, e a combinação das duas é o que torna a integração tão poderosa.

Pré-requisitos para começar

Para seguir o tutorial, é necessário ter:

• Uma conta no Atlassian Confluence Cloud com permissões de administrador para criar aplicações OAuth 2.0 e gerenciar escopos de Controle de Acesso à Interface de Programação de Aplicações (API);
• Uma assinatura do Amazon Quick — plano Enterprise para criar integrações, ou Professional para usar integrações já existentes;
• Uma conta AWS com permissões adequadas de Gerenciamento de Identidade e Acesso (IAM) para acessar o Quick e criar integrações.

Do ponto de vista de segurança, a integração segue o modelo de responsabilidade compartilhada da AWS: a AWS cuida da segurança da infraestrutura, enquanto o cliente é responsável por configurar as permissões OAuth, gerenciar os escopos de API e garantir alinhamento com as políticas de governança de dados da organização. O Amazon Quick mantém a segurança dos dados com criptografia em repouso e em trânsito. Mais detalhes em segurança da AWS no Quick.

Criando a Knowledge Base do Confluence Cloud

Uma knowledge base no Quick é uma coleção indexada de documentos de fontes externas, otimizada para recuperação com Inteligência Artificial (IA) generativa e resposta a perguntas. No console do Quick, basta acessar a seção de Knowledge e selecionar a opção de integração com o Atlassian Confluence Cloud.

Para conectar a instância do Confluence, é preciso informar a URL base da conta — no formato suainstancia.atlassian.net — e aceitar o prompt de autorização OAuth. O Quick cuida de toda a autenticação automaticamente, sem necessidade de envolver a equipe de TI ou gerar chaves de API.

Controle de acesso por documento (ACLs)

Um recurso avançado disponível na integração são os Controles de Acesso em Nível de Documento (ACLs — Document-level Access Controls). Quando habilitados, o Quick verifica em tempo real as permissões de cada usuário no Confluence, garantindo que cada pessoa veja apenas o conteúdo ao qual já tem acesso. Para isso, são necessárias credenciais de administrador do Atlassian: chave de API, ID da organização e ID do diretório. Mais detalhes na documentação de controles de acesso em nível de documento.

Quando os ACLs estão habilitados, o Quick rastreia as seguintes permissões do Confluence:

• Spaces (espaços): as permissões do espaço se aplicam a todos os documentos por padrão;
• Pages (páginas): podem ser restritas a usuários e grupos específicos; páginas aninhadas herdam as restrições da página pai;
• Blogs: posts de blog podem ser restritos a usuários e grupos específicos do espaço;
• Attachments (anexos): arquivos anexados herdam os controles de acesso do documento pai.

Se os ACLs não forem habilitados, o controle de acesso ocorre no nível da knowledge base: qualquer pessoa com acesso à base consegue obter respostas de todo o conteúdo indexado.

Configurando permissões e sincronização

Após criar a knowledge base, ela aparece na seção de bases existentes com um indicador de status de sincronização. Quando a sincronização é concluída, o status muda para “Available” (disponível). Na página de detalhes da knowledge base, é possível visualizar o resumo, os agendamentos de sincronização, os relatórios de sincronização e as permissões. O relatório de sincronização permite baixar um arquivo CSV com detalhes sobre itens sincronizados, ignorados ou com falha.

Criando Actions para o Confluence

Enquanto as knowledge bases lidam com a amplitude — indexando e tornando o conteúdo pesquisável — as Actions entregam precisão. Elas conectam o Quick diretamente às APIs do Confluence em tempo real, permitindo criar páginas, atualizar conteúdo, recuperar registros específicos e acionar fluxos de trabalho.

O Quick suporta a integração de Actions com o Confluence Cloud via autenticação de usuário (3LO — Three-Legged OAuth) e autenticação de serviço por chave de API. O tutorial da AWS foca na autenticação de usuário (3LO).

Criando a aplicação OAuth 2.0 no Atlassian

O primeiro passo é criar uma aplicação OAuth 2.0 no console de desenvolvedores da Atlassian. Acesse a página de desenvolvedores da Atlassian, vá ao Developer Console e crie uma nova integração OAuth 2.0 (3LO). Após criar a aplicação, configure a URL de callback no seguinte formato:

https://{region}.quicksight.aws.amazon.com/sn/oauthcallback

Substitua {region} pela região AWS onde o Quick está implantado.

Configurando os escopos de API necessários

Na página de permissões da aplicação, é preciso configurar os seguintes escopos:

• User Identity API:
  • read:me — visualizar o perfil do usuário ativo;
  • read:account — visualizar perfis de usuário.
• Confluence API (escopos clássicos e granulares):
  • search:confluence — pesquisar conteúdo no Confluence (escopo clássico);
  • read:page:confluence — ler conteúdo de páginas (escopo granular);
  • write:page:confluence — criar e modificar páginas (escopo granular);
  • read:space:confluence — acessar informações de espaços (escopo granular).

Para mais detalhes sobre escopos, consulte a documentação da Atlassian sobre implementação do OAuth 2.0 (3LO) e como determinar os escopos necessários para cada operação.

Configurando a integração no Quick

Com a aplicação OAuth criada, o próximo passo é configurar a Action no Quick. Na página de conectores, selecione o card do Atlassian Confluence Cloud e escolha a opção de OAuth app personalizado. Os campos necessários são: URL base, Client ID, Client Secret, Token URL, URL de autenticação e URL de redirecionamento. Para referência sobre cada campo, consulte a documentação da integração Atlassian Confluence Cloud.

A URL base segue o formato https://api.atlassian.com/ex/confluence/seuInstanceId. O Client ID e o Client Secret são obtidos na página de configurações da aplicação OAuth criada anteriormente. Após publicar a integração, ela aparecerá com status “Connected” (conectado), e o usuário precisa fazer login para autorizar o acesso do Quick à conta do Confluence.

Organizando tudo com Quick Spaces

O Quick oferece um recurso chamado Spaces (espaços) que permite agrupar knowledge bases, Actions, arquivos e dashboards em uma única coleção organizada. Para a integração com o Confluence, isso significa ter um hub centralizado onde todos os recursos relacionados ficam juntos, facilitando tanto o uso individual quanto a colaboração em equipe.

Um Space com o Confluence configurado desbloqueia valor em várias frentes: colaboração em equipe com uma visão consistente e governada do conteúdo, criação de agentes customizados que usam a documentação do Confluence como base de conhecimento, automação de fluxos de trabalho com Quick Flows, e análises aprofundadas com Quick Research.

Consultando o Confluence em linguagem natural

Com o Space configurado, basta abrir o chat do Quick e fazer perguntas sobre o conteúdo do Confluence. O Quick retorna respostas detalhadas com referências às fontes originais — é possível verificar exatamente de qual página do Confluence a informação foi extraída.

Executando Actions no Confluence

As Actions permitem criar, atualizar e gerenciar páginas e espaços diretamente pelo Quick. Um caso de uso prático é consolidar respostas geradas a partir de múltiplas fontes e publicar o resultado diretamente em uma página do Confluence. Antes de executar a ação, o Quick exibe um card de revisão com botões de “Allow” (permitir) e “Deny” (negar), além de um formulário para inspecionar os detalhes da página — título, ID do espaço e conteúdo — antes de aprovar. O Quick preserva automaticamente a formatação da resposta ao criar a página, incluindo cabeçalhos, listas e conteúdo estruturado.

Solução de problemas e referências

Para resolver problemas com a integração, a AWS disponibiliza a documentação de resolução de problemas da integração Atlassian Confluence e as perguntas frequentes do Quick.

Para quem quiser colocar a mão na massa, a AWS sugere os seguintes próximos passos:

• Iniciar um teste gratuito para experimentar a recuperação de conhecimento com IA em conteúdo corporativo;
• Conectar a primeira integração com o Confluence Cloud para extrair valor imediato da documentação existente;
• Criar um agente de chat personalizado adaptado aos domínios de conhecimento e fluxos de trabalho do time;
• Construir um Space para agregar recursos críticos e facilitar a colaboração entre times.

Para orientações detalhadas de implementação e boas práticas, consulte o Guia do Usuário do Quick.

Fonte

Integrate Atlassian Confluence Cloud with Amazon Quick (https://aws.amazon.com/blogs/machine-learning/integrate-atlassian-confluence-cloud-with-amazon-quick/)