Resolver problemas e corrigir erros no app Google Chat

Esta seção descreve problemas comuns que você pode encontrar ao criar e testar apps de chat.

Uma mensagem do card, caixa de diálogo ou visualização de link não é renderizada ou funciona como esperado

Para receber ajuda com a solução de erros de cartão, consulte Resolver e corrigir cartões.

O app não está respondendo

Se você enviar uma mensagem ao app do Chat e ele responder "O app não está respondendo", Verifique a configuração do app do Chat:

  1. No console do Google Cloud, clique em Menu > Mais produtos > Google Workspace > Biblioteca de produtos > API Google Chat > Gerenciar > Configuração.

    Acessar a API Chat

  2. Em Status do app, selecione Ativo: disponível para os usuários.

  3. Em Recursos interativos, verifique se as configurações são adequadas para a funcionalidade do app. Se o app de chat interage com os usuários, ative a opção Ativar recursos interativos:

    1. Se o app responder a mensagens, selecione Receber mensagens individuais.
    2. Em Configurações de conexão, verifique se o URL do endpoint HTTP, o ID de implantação do projeto do Apps Script, o Nome do tópico do Cloud Pub/Sub ou o agente do Dialogflow estão configurados e implantados corretamente.
    3. Em Visibilidade, verifique se os usuários apropriados têm acesso ao app com o endereço de e-mail ou um grupo no domínio do Google Workspace. Se o app for implantado com o SDK do Google Workspace Marketplace, as configurações de visibilidade não serão necessárias, porque as configurações do Google Workspace Marketplace têm precedência.
  4. Se o app for publicado com o SDK do Google Workspace Marketplace, revise as configurações do Google Workspace Marketplace.

  5. Clique em Salvar.

  6. Tente enviar uma mensagem para o app de novo.

A API Google Chat está disponível apenas para usuários do Google Workspace

Ao configurar o app Chat, você pode receber o erro Google Chat API is only available to Google Workspace users. Esta mensagem significa que a Conta do Google usada para configurar A API Chat não faz parte de uma organização do Google Workspace. Para criar um do Chat ou da API Chat, use uma Google Workspace padrão.

Os usuários do Google Chat podem usar os apps do Chat sem uma conta do Google Workspace. Para saber mais sobre como os usuários descobrem e instalam Apps do Chat, consulte Publicar Apps do Google Chat

Os usuários podem ser excluídos dos espaços

Se um administrador do Google Workspace não permitir que os usuários ativem ou desativem o histórico de chat, talvez os usuários não consigam entrar ou permanecer em um espaço devido a um conflito entre uma configuração no nível do usuário que força a ativação ou desativação do histórico de chat e um espaço que herda a configuração obrigatória no nível da organização.

Por exemplo, se um usuário tiver a configuração "Histórico de chat" ativada e um espaço tiver a configuração "Histórico de chat" desativada, esse usuário talvez não consiga entrar no espaço. Além disso, o usuário poderá ser removido do espaço se entrar antes do conflito e postar uma mensagem após o conflito.

Neste e em outros cenários em que há conflitos entre as configurações do histórico, a API Chat pode não conseguir criar uma associação ou criar uma mensagem com autenticação de usuário pode remover o usuário autenticado com uma configuração de histórico de chat conflitante do espaço.

Para saber mais, consulte Os usuários podem ser excluídos dos espaços na Central de Ajuda para administradores do Google Workspace.

Resolver problemas do serviço avançado do Chat no Google Apps Script

Consulte a página do Apps Script sobre o Serviço avançado de chat.

Os usuários não conseguem adicionar um app do Chat a um espaço

Se os usuários receberem a mensagem de erro This organization's administrator must allow users to install this Chat app ao tentar adicionar um app do Chat a um espaço, esse erro pode ser causado por um dos seguintes motivos:

  • A organização desativou os apps do Chat.
  • A organização não adicionou essa informação o app do Chat à lista de permissões da organização.

Se um usuário encontrar essa mensagem de erro ao tentar interagir com um app de chat, ela pode ser causada pela organização concedendo acesso a uma unidade suborganizacional, sem ativar para a unidade organizacional principal.

Para saber como resolver esse problema, consulte Permitir que os usuários instalem apps do Chat.

O administrador precisa conceder ao app o escopo de autorização OAuth necessário para essa ação

Quando Como autenticar como um app do Chat, este erro pode aparecer:

<HttpError 403 when requesting https://chat.googleapis.com/v1/spaces/{space}?alt=json returned "The administrator must grant the app the required OAuth authorization scope for this action.". Details: "The administrator must grant the app the required OAuth authorization scope for this action.">

Esta mensagem de erro significa que um administrador do Google Workspace mas concedeu uma aprovação única para uso do app do Chat escopos de autorização que começam com o nome https://www.googleapis.com/auth/chat.app.*:

Para resolver o erro:

  • Peça para o administrador do Google Workspace conceder aprovação ao seu app do Chat. Ao lidar com esse erro na lógica do app do Chat, considere enviar uma mensagem anunciando que o app do Chat precisa da aprovação do administrador para realizar a ação solicitada, talvez: To perform this action, I need approval. <https://support.google.com/a?p=chat-app-auth|Learn more>.
  • Se o método da API Chat oferecer suporte à https://www.googleapis.com/auth/chat.bot escopo de autorização, que não exigir a aprovação do administrador, considere usá-la. Para verificar quais escopos de autorização compatíveis com um método, consulte a Autentique e autorize apps do Google Chat e solicitações da API Google Chat.

Resolver erros do Cloud Functions

Se o app do Chat for implementado com o Cloud Functions e não estiver funcionando, as seções a seguir ajudarão a solucionar o problema.

Verificar os registros da função do Cloud

Como primeira etapa, verifique se há erros nos registros do Cloud Functions.

  1. No console do Google Cloud, acesse a página Cloud Functions:

    Acesse o Cloud Functions

  2. Para abrir os registros, encontre a função do Cloud da sua app de chat e clique em Mostrar ações > Conferir registros.

A Análise de registros abre e executa uma consulta que mostra os registros de funções do Cloud, incluindo erros.

Se as informações padrão registradas não forem suficientes para depurar o app, adicione mais registros do código da Função do Cloud. Consulte Ver e gravar dados do Registros da função.

Verificar erros da Função do Cloud

Além dos registros, a função do Cloud também pode relatar erros encontrados durante em execução.

  1. No console do Google Cloud, acesse a página Cloud Functions:

    Acesse o Cloud Functions

  2. Clique na função do Cloud do seu app do Chat.

  3. Na página "Detalhes da função", os erros são listados em Erros.

  4. Para resolver o problema, clique nele.

Corrigir erros comuns da função do Cloud

Os erros a seguir às vezes são encontrados durante a criação de um App de chat com o Cloud Functions.

A função ChatApp na região REGION_NAME no projeto PROJECT_NAME já existe

Ao implantar uma função do Cloud, talvez você receba o erro Function ChatApp in region REGION_NAME in project PROJECT_NAME already exists. Essa mensagem significa que outra Cloud Function tem o mesmo nome que a que você está implantando. Mude o nome e implante a função novamente. Verifique se o app de chat usa o URL do acionador da sua função do Cloud, e não o URL do acionador da função do Cloud já existente.

Um ou mais usuários nomeados na política não pertencem a um cliente permitido

Ao implantar uma função do Cloud, você pode receber o erro The operation cannot be completed on the function: "One or more users named in the policy do not belong to a permitted customer.". Se você receber esse erro e enviar uma mensagem para o app Chat, vai receber uma mensagem informando que o app não está respondendo porque o Google Chat não consegue acessar o servidor que hospeda a função do Cloud. Essa mensagem significa que um usuário chamado "allUsers" não tem permissão para chamar a função do Cloud. Atribuição de "allUsers" o "Invocador do Cloud Functions" o Cloud Storage significa A função que alimenta o app é disponibilizada publicamente e acessível sem autenticação. Para saber como atribuir um papel, consulte Conceder um único papel.

Esse erro pode significar que o projeto do Google Cloud tem restrição de domínio. Para mais informações sobre restrições de domínio, consulte Como restringir identidades por domínio.

Para resolver esse problema, verifique se a Função do Cloud permite invocações não autenticadas. Para saber como permitir invocações não autenticadas para uma função do Cloud existente, consulte Permitir acesso público (não autenticado).