Integração com o Atlassian Confluence - Amazon Quick

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Integração com o Atlassian Confluence

Com a integração do Atlassian Confluence no Amazon Quick, você pode realizar ações no conteúdo do Confluence e criar bases de conhecimento a partir de espaços, páginas e postagens de blog do Confluence. Essa integração oferece suporte tanto aos recursos de ação quanto aos recursos de ingestão de dados.

O que é possível fazer

Os usuários do Confluence podem fazer perguntas sobre o conteúdo armazenado em seus espaços e páginas do Confluence. Por exemplo, os usuários podem perguntar sobre a documentação do projeto, wikis da equipe ou pesquisar informações específicas em vários espaços. A integração permite que os usuários acessem e entendam rapidamente as informações do conteúdo do Confluence, independentemente da localização ou do tipo, ao mesmo tempo em que fornecem detalhes contextuais, como datas de publicação, histórico de modificações e propriedade da página — tudo contribuindo para uma descoberta mais eficiente das informações e uma tomada de decisão mais informada.

Com as ações do Confluence, você pode criar, atualizar e gerenciar páginas, espaços e outros objetos do Confluence diretamente por meio do Amazon Quick. Esses recursos de ação permitem que você simplifique as tarefas de gerenciamento de conteúdo sem sair do seu ambiente Amazon Quick.

Antes de começar

Antes de configurar a integração com o Confluence, verifique se você tem o seguinte:

  • Atlassian Confluence Cloud

  • Para conectores de ação: assinatura do Amazon Quick Enterprise.

  • Para acesso aos dados: assinatura Amazon Quick Professional ou superior.

Prepare a configuração e a autenticação do aplicativo Atlassian

Antes de configurar a integração no Amazon Quick, prepare seu aplicativo Atlassian e suas credenciais de autenticação. A integração com o Confluence oferece suporte a diferentes métodos de autenticação, dependendo do tipo de integração.

Configuração de autenticação do conector de ação

Para conectores de ação, reúna as credenciais de autenticação usando um destes métodos:

Autenticação de usuário (3LO)

Reúna as seguintes informações da configuração do seu aplicativo Atlassian:

  • URL base: o URL da sua instância do Confluence. Essa é a URL usada para chamadas de API, e não a mesma URL na qual os usuários do Confluence fazem login. Será algo parecido com o seguinte exemplo: https://api.atlassian.com/ex/confluence/ yourInstanceId

  • ID do cliente - ID do cliente do aplicativo Atlassian.

  • Segredo do cliente - segredo do cliente do aplicativo Atlassian.

  • URL do token - endpoint do OAuth token Atlassian.

  • URL de autenticação - ponto final de autorização da Atlassian OAuth .

  • URL de redirecionamento - URI de OAuth redirecionamento.

OAuth Escopos necessários:

  • search:confluence- Pesquise conteúdo do Confluence. Esse é um escopo clássico no Confluence.

  • read:page:confluence- Leia o conteúdo da página. Esse é um escopo granular no Confluence.

  • write:page:confluence- Crie e modifique páginas. Esse é um escopo granular no Confluence.

  • read:space:confluence- Acesse as informações do espaço. Esse é um escopo granular no Confluence.

Autenticação de serviço (chave de API)

Reúna as seguintes informações do administrador do Confluence:

  • Chave de API - token da API do Confluence.

  • URL base: o URL da instância do Confluence, usado para chamadas de API.

  • E-mail - E-mail da conta de usuário associada.

Configuração de autenticação de acesso a dados

Para trazer dados das integrações do Atlassian Confluence, prepare-se para a autenticação do Confluence. Durante a configuração da integração, você precisará:

  1. Preencha o pop-up de autenticação do Confluence que aparece.

  2. Conceda permissões para que o Amazon Quick acesse seu conteúdo do Confluence.

  3. Revise e conclua o processo de autenticação.

Configurar a integração com o Confluence

Depois de preparar seu aplicativo Atlassian e suas credenciais de autenticação, siga estas etapas para criar sua integração com o Confluence:

Configurar a integração da base de conhecimento

Para criar uma integração do Confluence para a criação da base de conhecimento:

  1. No console do Amazon Quick, escolha Integrações.

  2. Clique em Adicionar (mais o botão “+”).

  3. Selecione Trazer dados do Atlassian Confluence Cloud.

  4. Escolha Próximo.

  5. Preencha os campos Nome e URL do Confluence:

    • Nome - Nome descritivo para sua integração.

    • URL do Confluence — A URL do seu site da Atlassian será semelhante ao exemplo a seguir: your-site.atlassian.net

  6. Escolha Próximo.

  7. Adicione detalhes da integração e conclua a autenticação.

  8. Escolha Próximo.

  9. Preencha os detalhes da base de conhecimento:

    • Nome da base de conhecimento - Nome da sua base de conhecimento.

    • Descrição - Objetivo da base de conhecimento.

    • Seleção de conteúdo - Escolha espaços e páginas para incluir.

Configurar a integração do conector de ação

Para criar uma integração com o Confluence para realizar ações:

  1. No console do Amazon Quick, escolha Integrações.

  2. Clique em Adicionar (mais o botão “+”).

  3. Selecione Executar ações.

  4. Escolha Próximo.

  5. Preencha os detalhes da integração:

    • Nome - Nome descritivo para sua integração.

    • Descrição - Objetivo da integração.

  6. Escolha o tipo de conexão (autenticação de usuário ou serviço).

  7. Defina as configurações de autenticação com base no método escolhido:

    • Para autenticação de usuário (3LO):

      • URL base: o URL da instância do Confluence usado para chamadas de API.

      • ID do cliente - ID do cliente do aplicativo Atlassian.

      • Segredo do cliente - segredo do cliente do aplicativo Atlassian.

      • URL do token - endpoint do OAuth token Atlassian.

      • URL de autenticação - ponto final de autorização da Atlassian OAuth .

      • URL de redirecionamento - URI de OAuth redirecionamento.

    • Para autenticação de serviço (chave de API):

      • Chave de API - token da API do Confluence.

      • URL base: o URL da instância do Confluence, que é o URL usado para chamadas de API.

      • E-mail - E-mail da conta de usuário associada.

  8. Selecione Criar e continuar.

  9. Selecione os usuários com os quais compartilhar a integração.

  10. Escolha Próximo.

Gerencie bases de conhecimento

Depois de configurar sua integração com o Confluence, você pode criar e gerenciar bases de conhecimento a partir do seu conteúdo do Confluence.

Edite as bases de conhecimento existentes

Você pode modificar suas bases de conhecimento existentes do Confluence:

  1. No console do Amazon Quick, escolha Bases de conhecimento.

  2. Selecione sua base de conhecimento do Confluence na lista.

  3. Escolha o ícone de três pontos em Ações e escolha Editar base de conhecimento.

  4. Atualize suas configurações conforme necessário e escolha Salvar.

Crie bases de conhecimento adicionais

Você pode criar várias bases de conhecimento a partir da mesma integração com o Confluence:

  1. No console do Amazon Quick, escolha Integrações e, em seguida, selecione a guia Dados.

  2. Escolha sua integração existente com o Confluence na lista.

  3. Escolha o ícone de três pontos em Ações e escolha Criar base de conhecimento.

  4. Defina as configurações da sua base de conhecimento e escolha “Criar”.

Para obter informações detalhadas sobre as opções de configuração da base de conhecimento, consulteDefinições de configuração comuns.

Tipos de conteúdo compatíveis

Você pode incluir esses tipos de conteúdo em sua base de conhecimento:

  • Páginas e postagens de blog do Confluence.

  • Conteúdo do Spaces

  • Anexos da página e do blog

nota

O Amazon Quick não sincroniza ACLs a partir de fontes de dados. Quando você cria uma base de conhecimento no Amazon Quick, por padrão, somente você pode obter insights da base de conhecimento. Para conteúdo compartilhado, você pode fornecer acesso a diferentes usuários e grupos atualizando as permissões da base de conhecimento.