EventType

Types of Google Chat app interaction events.

To configure your Chat app to receive interaction events, see Receive and respond to user interactions.

Enums
UNSPECIFIED Default value for the enum. DO NOT USE.
MESSAGE

A user sends the Chat app a message, or invokes the Chat app in a space, such as any of the following examples:

  • Any message in a direct message (DM) space with the Chat app.
  • A message in a multi-person space where a person @mentions the Chat app, or uses one of its slash commands.
  • If you've configured link previews for your Chat app, a user posts a message that contains a link that matches the configured URL pattern.
ADDED_TO_SPACE

A user adds the Chat app to a space, or a Google Workspace administrator installs the Chat app in direct message spaces for users in their organization. Chat apps typically respond to this interaction event by posting a welcome message in the space.

When administrators install Chat apps, the space.adminInstalled field is set to true and users can't uninstall them. To learn about Chat apps installed by administrators, see Google Workspace Admin Help's documentation, Install Marketplace apps in your domain.

REMOVED_FROM_SPACE

A user removes the Chat app from a space, or a Google Workspace administrator uninstalls the Chat app for a user in their organization. Chat apps can't respond with messages to this event, because they have already been removed.

When administrators uninstall Chat apps, the space.adminInstalled field is set to false. If a user installed the Chat app before the administrator, the Chat app remains installed for the user and the Chat app doesn't receive a REMOVED_FROM_SPACE interaction event.

CARD_CLICKED

A user clicks an interactive element of a card or dialog from a Chat app, such as a button. To receive an interaction event, the button must trigger another interaction with the Chat app. For example, a Chat app doesn't receive a CARD_CLICKED interaction event if a user clicks a button that opens a link to a website, but receives interaction events in the following examples:

  • The user clicks a Send feedback button on a card, which opens a dialog for the user to input information.
  • The user clicks a Submit button after inputting information into a card or dialog.

If a user clicks a button to open, submit, or cancel a dialog, the CARD_CLICKED interaction event's isDialogEvent field is set to true and includes a DialogEventType.

WIDGET_UPDATED A user updates a widget in a card message or dialog.
APP_HOME

A user opens a direct message from a Chat app that uses app home. Only the type, user, and space fields are included for events of this type. For more information, see Build a homepage for a Google Chat app.

SUBMIT_FORM

A user submits information in an app home card. Only the type, user, and space fields are included for events of this type. For more information, see Build a homepage for a Google Chat app.