Um usuário envia uma mensagem para o app do Chat ou o invoca em um espaço. Exemplos de eventos de mensagem:
Qualquer mensagem em um espaço de mensagem direta (DM) com o app Chat.
Uma mensagem em um espaço com várias pessoas em que alguém @menciona o app do Chat ou usa um dos comandos de barra.
Se você configurou prévias de link para o app Chat, um usuário posta uma mensagem que contém um link que corresponde ao padrão de URL configurado.
ADDED_TO_SPACE
Um usuário adiciona o app do Chat a um espaço ou um administrador do Google Workspace instala o app do Chat em espaços de mensagens diretas para usuários da organização. Os apps de chat geralmente respondem a esse evento de interação postando uma mensagem de boas-vindas no espaço.
Quando os administradores instalam apps do Chat, o campo space.adminInstalled é definido como true, e os usuários não podem desinstalá-los. Para saber mais sobre os apps do Chat instalados por administradores, consulte a documentação da Ajuda do administrador do Google Workspace, Instalar apps do Marketplace no seu domínio.
REMOVED_FROM_SPACE
Um usuário remove o app Chat de um espaço ou um administrador do Google Workspace desinstala o app Chat para um usuário na organização. Os apps de chat não podem responder com mensagens a esse evento porque já foram removidos.
Quando os administradores desinstalam apps do Chat, o campo space.adminInstalled é definido como false. Se um usuário instalou o app Chat antes do administrador, ele permanece instalado para o usuário e não recebe um evento de interação REMOVED_FROM_SPACE.
CARD_CLICKED
Um usuário clica em um elemento interativo de um card ou caixa de diálogo de um app Google Chat, como um botão. Para receber um evento de interação, o botão precisa acionar outra interação com o app Chat. Por exemplo, um app Chat não recebe um evento de interação CARD_CLICKED se um usuário clicar em um botão que abre um link para um site, mas recebe eventos de interação nos seguintes exemplos:
O usuário clica em um botão Send feedback em um card, o que abre uma caixa de diálogo para que ele insira informações.
O usuário clica em um botão Submit depois de inserir informações em um card ou caixa de diálogo.
Se um usuário clicar em um botão para abrir, enviar ou cancelar uma caixa de diálogo, o campo isDialogEvent do evento de interação CARD_CLICKED será definido como true e vai incluir um DialogEventType.
WIDGET_UPDATED
Um usuário atualiza um widget em uma mensagem de card ou caixa de diálogo. Esse evento é acionado quando um usuário interage com um widget que tem uma ação associada.
APP_COMMAND
Um usuário usa um comando do app Chat, incluindo comandos de barra e comandos rápidos.
APP_HOME
Um usuário abre uma mensagem direta de um app do Chat que usa a página inicial do app. Apenas os campos type, user e space são incluídos para eventos desse tipo. Para mais informações, consulte Criar uma página inicial para um app do Google Chat.
SUBMIT_FORM
Um usuário envia informações em um card da página inicial do app. Apenas os campos type, user e space são incluídos para eventos desse tipo. Para mais informações, consulte Criar uma página inicial para um app do Google Chat.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-09-12 UTC."],[[["\u003cp\u003eGoogle Chat app interaction events are triggered by various user actions, such as sending messages, adding/removing the app, interacting with cards, and updating widgets.\u003c/p\u003e\n"],["\u003cp\u003eThese events provide context about the interaction, like the user, space, and specific action taken, allowing your app to respond appropriately.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eADDED_TO_SPACE\u003c/code\u003e and \u003ccode\u003eREMOVED_FROM_SPACE\u003c/code\u003e events help manage the app's presence in spaces, while \u003ccode\u003eCARD_CLICKED\u003c/code\u003e enables handling user interactions with card elements.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eMESSAGE\u003c/code\u003e events cover various scenarios, including direct messages, @mentions, slash commands, and link previews, enabling diverse app functionalities.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eAPP_HOME\u003c/code\u003e and \u003ccode\u003eSUBMIT_FORM\u003c/code\u003e events allow for interactions specific to apps that utilize the app home feature for a more integrated experience within Google Chat.\u003c/p\u003e\n"]]],["Google Chat apps can receive various interaction events. These include `MESSAGE` (user messages or @mentions), `ADDED_TO_SPACE` (app added to space), `REMOVED_FROM_SPACE` (app removed), `CARD_CLICKED` (user clicks a card element), `WIDGET_UPDATED` (widget update), `APP_COMMAND` (user command), `APP_HOME` (user opens app home), and `SUBMIT_FORM` (user submits app home card). Each event triggers specific app actions, like posting welcome messages or responding to user input.\n"],null,[]]
