Integração com o Google Chat

Com o conector de ação do Google Chat, você pode enviar mensagens, gerenciar espaços e interagir com tópicos de bate-papo da sua conta do Google Workspace diretamente no Amazon Quick por meio de linguagem natural.

O Google Chat usa a autenticação personalizada do aplicativo OAuth. Para obter mais informações sobre os métodos de autenticação compatíveis com o Amazon Quick, consulteMétodos de autenticação.

Antes de começar

Certifique-se de ter o seguinte antes de configurar a integração.

• Uma conta ativa do Google Workspace com acesso aos espaços do Google Chat que você deseja usar.

• Um cliente OAuth 2.0 registrado no console do Google Cloud para seu projeto do Google Workspace, com a API do Google Chat ativada.

• Para obter os requisitos de assinatura do Amazon Quick, consulteConfigurar integrações no console.

Configurando o Google Cloud

Para a autenticação personalizada do aplicativo OAuth, crie um cliente OAuth 2.0 no console do Google Cloud, ative a API do Google Chat para seu projeto, configure a tela de consentimento do OAuth com os escopos do Chat necessários (por exemplo,chat.spaces,chat.messages) e adicione o URL de retorno de chamada do Amazon Quick como um URI de redirecionamento autorizado. https://{region}.quicksight.aws.amazon.com/sn/oauthcallback {region}Substitua pela sua AWS região (por exemplo,us-east-1). Para obter instruções passo a passo, consulte a API do Google Chat na documentação para desenvolvedores do Google Workspace. Registre o ID do cliente e o segredo do cliente — você precisa deles ao configurar o Amazon Quick.

Configurando o conector no Amazon Quick

1. No console do Amazon Quick, escolha Conectores.

2. Escolha a guia Criar para sua equipe.

3. Encontre e escolha o Google Chat.

4. Insira um nome para seu conector. Opcionalmente, escolha + Adicionar descrição para adicionar uma descrição.

5. Em Tipo de conexão, escolha Rede pública.

6. Para Configuração do OAuth, escolha Aplicativo OAuth personalizado e configure os seguintes campos:

   • URL base — O URL base do MCP do Google Chat.

   • ID do cliente — O ID do cliente OAuth do seu cliente Google Cloud OAuth 2.0.

   • Cliente OAuth público (opcional) — selecione essa opção se seu cliente Google Cloud OAuth 2.0 estiver configurado como um cliente público (sem segredo do cliente).

   • Segredo do cliente — O segredo do cliente do Google Cloud OAuth 2.0.

   • URL do token — O endpoint do token OAuth do Google.

   • URL de autorização — O endpoint de autorização do Google OAuth.

   • URL de redirecionamento — Pre-filled com a URL de retorno de chamada do Amazon Quick.

7. Escolha Próximo.

8. Uma janela de login do Google é aberta. Revise as permissões solicitadas e escolha Permitir.

9. Na página Revisar, revise as ações disponíveis para o conector. Escolha Próximo.

10. Na página Publicar, escolha quem pode acessar o conector. Você pode habilitar o acesso para todos em sua organização ou pesquisar equipes ou grupos específicos.

11. Selecione Publish.

Ações disponíveis

Depois de configurar o conector, as ações expostas pelo Google Chat ficam disponíveis. Para ver o conjunto atual de ações do seu conector, acesse a visualização de ações disponíveis do conector no console do Amazon Quick.

Gerenciamento e solução de problemas

Para editar, compartilhar ou excluir seu conector, consulteGerenciando integrações existentes.

Problemas de autenticação

• Sign-in falha — verifique se sua conta do Google Workspace está ativa e se você pode entrar diretamente no Google Chat. Confirme se o URI de redirecionamento autorizado em seu cliente Google Cloud OAuth 2.0 corresponde ao URL de retorno de chamada do Amazon Quick.

• Credenciais de cliente inválidas — verifique se o ID do cliente e o segredo do cliente correspondem aos valores do seu cliente Google Cloud OAuth 2.0.

• Permissões insuficientes — verifique se a API do Chat está ativada e se sua tela de consentimento do OAuth inclui os escopos necessários para as operações que você deseja usar.