Esta seção descreve problemas comuns que você pode encontrar ao criar e testar apps do Chat.
Uma mensagem de card, uma caixa de diálogo ou uma visualização de link não é renderizada ou funciona como esperado.
Para receber ajuda com a solução de problemas de cards, consulte Resolver problemas e corrigir cards.
O app não está respondendo
Se você enviar uma mensagem para o app do Chat e ele responder "O app não está respondendo", verifique a configuração dele:
No console do Google Cloud, clique em Menu > Mais produtos > Google Workspace > Biblioteca de produtos > API Google Chat > Gerenciar > Configuração.
Em Status do app, verifique se você selecionou Ativo - disponível para os usuários.
Em Recursos interativos, verifique se as configurações são adequadas para a funcionalidade do seu app. Se o app do Chat interagir com usuários, ative a opção Ativar recursos interativos:
- Se o app responder a mensagens, selecione Receber mensagens individuais.
- Em Configurações de conexão, verifique se o URL do app, 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 definidos corretamente e foram implantados.
- Em Visibilidade, confira se os usuários apropriados têm acesso ao app com um 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 do Google Workspace Marketplace terão precedência.
Se o app for publicado com o SDK do Google Workspace Marketplace, verifique as configurações do Google Workspace Marketplace.
Clique em Salvar.
Tente enviar mensagens para o app novamente.
A API Google Chat está disponível apenas para usuários do Google Workspace
Ao configurar o app do Chat, talvez você receba o erro Google Chat API is only available to Google Workspace users. Essa mensagem
significa que a Conta do Google que você usou para configurar a
API Chat não faz parte de uma organização do Google Workspace. Para criar um
app do Chat ou usar a API Chat, você precisa de uma
conta do
Google Workspace.
Observe que 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.
É possível excluir os usuários dos espaços
Se um administrador do Google Workspace não permitir que os usuários ativem ou desativem o histórico de chat, às vezes os usuários não conseguem participar 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 forçada no nível da organização.
Por exemplo, se um usuário tiver definido a configuração "Histórico do Chat" como "ativada" em um espaço e um espaço tiver essa configuração definida como "desativada", talvez esse usuário não consiga participar do espaço. Além disso, essa pessoa pode ser removida do espaço se entrou antes do conflito e depois posta uma mensagem no espaço após o conflito.
Neste e em outros cenários em que há conflitos entre as configurações do histórico, a API Chat talvez não consiga criar uma associação, ou criar uma mensagem com a autenticação de usuário pode remover do espaço o usuário autenticado com uma configuração de histórico conflitante.
Saiba mais em Usuários podem ser excluídos dos espaços na Central de Ajuda para admins 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 do Chat.
Os usuários não conseguem adicionar um app do Chat a um espaço
Se os usuários encontrarem 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 este app do Chat específico à lista de permissões.
Se um usuário encontrar essa mensagem de erro ao tentar interagir com um app do Chat, é possível que a organização conceda acesso a uma subunidade organizacional sem ativá-la para a unidade organizacional mãe.
Para mais informações sobre como resolver esse problema, consulte Permitir que os usuários instalem apps do Chat.
Resolver erros da função do Cloud
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 e corrigir o problema.
Verificar os registros da função do Cloud
Para começar, verifique se há erros nos registros do Cloud Functions.
No console do Google Cloud, acesse a página do Cloud Functions:
Para abrir os registros, encontre a função do Cloud do app do Chat e clique em Mostrar ações > Ver registros.
A Análise de registros abre e executa uma consulta mostrando os registros da função do Cloud, incluindo erros.
Se as informações padrão registradas não forem suficientes para depurar seu app, adicione mais registros do código da função do Cloud. Consulte Visualizar e gravar registros do Cloud Functions.
Verificar erros da função do Cloud
Além dos registros, a função do Cloud também pode relatar erros encontrados durante a execução.
No console do Google Cloud, acesse a página do Cloud Functions:
Clique na função do Cloud do app do Chat.
Na página "Detalhes da função", os erros são listados em Erros.
Para solucionar mais problemas, clique nele.
Corrigir erros comuns da função do Cloud
Os erros a seguir às vezes são encontrados ao criar um app do Chat com o Cloud Functions.
A função ChatApp na região REGION_NAME do 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 função do Cloud tem o mesmo nome da que você está implantando. Altere o nome e implante a função novamente. Verifique se o app do Chat usa o URL do gatilho da função do Cloud, não o URL do gatilho da função preexistente do Cloud.
Um ou mais usuários nomeados nesta política não pertencem a um cliente permitido
Ao implantar uma função do Cloud, talvez você receba 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 isso acontecer, e você enviar uma mensagem para o
app do Chat, vai receber uma mensagem de erro 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.
Atribuir a "allUsers" o papel "Invocador do Cloud Functions" significa que a função do Cloud que alimenta o aplicativo está disponível 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 é restrito ao domínio. Para mais informações sobre restrições de restrição 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 atual, consulte Como permitir acesso público (não autenticado).