

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 Google Chat
<a name="google-chat-integration"></a>

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, consulte[Métodos de autenticação](quick-action-auth.md).

## Antes de começar
<a name="google-chat-prerequisites"></a>

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, consulte[Configurar integrações no console](integration-console-setup-process.md).

## Configurando o Google Cloud
<a name="google-chat-source-setup"></a>

Para a autenticação personalizada do aplicativo OAuth, crie um cliente OAuth 2.0 no [console do Google Cloud](https://console.cloud.google.com/), 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](https://developers.google.com/workspace/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
<a name="google-chat-quicksuite-setup"></a>

1. No console do Amazon Quick, escolha **Conectores**.

1. Escolha a guia **Criar para sua equipe**.

1. Encontre e escolha **o Google Chat**.

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

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

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

1. Escolha **Próximo**.

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

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

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

1. Selecione **Publish**.

## Ações disponíveis
<a name="google-chat-actions"></a>

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
<a name="google-chat-troubleshooting"></a>

Para editar, compartilhar ou excluir seu conector, consulte[Gerenciando integrações existentes](integration-workflows.md#managing-existing-integrations).

### Problemas de autenticação
<a name="google-chat-troubleshooting-auth"></a>
+ **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.