Visão geral da solução de problemas
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Nesta página, você aprende a ver, depurar e corrigir erros de apps de chat, cards e caixas de diálogo.
Como os erros aparecem
Quando um app do Google Chat retorna um erro, ele se manifesta assim:
- Uma mensagem como "O app não está respondendo". A mensagem "Algo deu errado" ou "Não foi possível processar sua solicitação" aparece.
- O app não funciona como esperado.
- Nenhuma mensagem é exibida, e o app não responde.
Quando um card retorna um erro, ele aparece assim:
- Parte de um card, como um widget ou componente, não aparece ou é renderizada de maneira inesperada.
- O card inteiro não aparece.
- Uma caixa de diálogo fecha, não abre ou não carrega.
Embora uma mensagem de erro não apareça na interface do Chat, mensagens de erro descritivas e dados de registro estão disponíveis para ajudar você a corrigir erros quando o registro de erros para apps do Chat está ativado.
Depurar e resolver problemas do Google Chat
- Ative o registro de erros para que o app Google Chat registre erros quando eles ocorrerem.
- Consulte os registros de erros do Google Chat para ler os registros, ver a frequência dos erros e ler mensagens de erro descritivas e dados de registro que ajudam a corrigir os erros.
- Saiba como corrigir erros comuns:
- Depure o app Chat para
executá-lo etapa por etapa.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-08-04 UTC.
[null,null,["Última atualização 2025-08-04 UTC."],[[["\u003cp\u003eThis page provides guidance on viewing, debugging, and resolving errors in Google Chat apps, cards, and dialogs.\u003c/p\u003e\n"],["\u003cp\u003eGoogle Chat errors can manifest as error messages, unexpected app behavior, or lack of response, while card errors might result in partial or complete rendering failures.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can leverage error logging, log querying, and troubleshooting resources to identify and fix errors in their Chat apps, cards, and dialogs.\u003c/p\u003e\n"],["\u003cp\u003eSpecific guides are available to address common Chat app errors, card and dialog issues, and enable step-by-step debugging for comprehensive troubleshooting.\u003c/p\u003e\n"]]],["This content details how to manage errors in Google Chat apps, cards, and dialogs. Errors manifest as unresponsive apps, missing or malfunctioning card elements, or closed/failed dialogs. To address this, enable error logging. Query error logs to identify the frequency and nature of errors. Resources are available to fix common app, card, and dialog issues, and a debug feature allows for step-by-step execution analysis.\n"],null,["This page helps you view, debug, and fix Chat apps, card, and dialog errors.\n\nHow errors appear\n\nWhen a Google Chat app returns an error, it manifests like this:\n\n- A message like \"App is not responding.\", \"Something went wrong.\", or \"Unable to process your request\" displays.\n- The app doesn't work as intended.\n- No message displays, and the app doesn't respond.\n\nWhen a [card](/workspace/chat/create-messages#create) returns an error, it manifests like this:\n\n- Part of a card, like a widget or component, doesn't appear or renders in an unexpected way.\n- The entire card doesn't appear.\n- A dialog closes, doesn't open, or doesn't load.\n\nAlthough an error message might not display in the Chat UI, descriptive error messages and log data are available to help you fix errors when error logging for Chat apps is turned on.\n\nDebug and troubleshoot Google Chat errors\n\n1. [Turn on error logging](/workspace/chat/turn-on-error-logging) so your Google Chat app logs errors if and when they occur.\n2. [Query error logs for Google Chat](/workspace/chat/query-logs) to read error logs, see how often errors occur, and read descriptive error messages and log data that help you fix the errors.\n3. Learn how to fix common errors:\n - [Fix Google Chat app errors](/workspace/chat/troubleshoot-chat-apps) like \"App is not responding\", \"Google Chat API is only available to Google Workspace users\", or \"Users can be excluded from spaces\".\n - [Fix card and dialog errors](/workspace/chat/troubleshoot-cards) like card messages, dialogs, or link previews not rendering or working as expected.\n4. [Debug your Chat app](/workspace/chat/debug-apps) to execute it step by step."]]
