This page describes how to implement user interactivity in Google Chat apps. From text-based messages to card-based graphical user interfaces, Chat apps support interactivity in some of the following ways:
- Introduce users to your Chat app
- Respond to Chat interactions
- Card messages
- Slash commands
- Preview links
- @mention users in a message
Introduce users to your Chat app
Onboard people and spaces to your Chat app with a welcome message that details what your Chat app does, and how people can best work with it.
An effective onboarding message has the following structure:
- Say hello. Set the right voice and tone with your users.
- Describe briefly what your Chat app does. Introduce your Chat app by telling people what it can help them do in one or two sentences.
- Tell people how to get started. Tell people how to work with your Chat app. If your Chat app requires configuration or authorization, this is a good place to prompt people to complete the set-up process. For example, suggest one or two common slash commands.
- Explain how to get help and how to give feedback. End the message by telling people how they can get help or offer feedback.
The following Chat app's onboarding message prepares users for success:
Receive and respond to Chat interactions
Your Chat app can receive and respond to user interactions, also known as Chat app interaction events. The interactions described in this page are all Chat interactions, but can also include other interactions such as adding or removing a Chat app to a space.
Send card messages
Card messages are UI elements that can contain both interactive and static widgets such as text, images, and buttons that Chat apps can send to users and spaces. If your Chat app needs to gather information from users, present detailed information, or guide users to take a next step, send a card message.
The following is a card message from a Chat app:
Open dialogs in messages
Dialogs are windowed, card-based interfaces that a user can open to interact with your Chat app. In dialogs, you can string together multiple card messages sequentially, which helps users complete multi-step processes, like filling in form data.
In the following example, a Chat app starts a dialog to
gather contact details from a user who issues the
Set up slash commands
let you register and advertise specific commands that users can
give your a Chat app by typing a command that begins
with a forward slash (
The following is a list of slash commands available for the Cymbal Chat app:
After you configure link previews for your Chat app, whenever someone shares a matching link, users can preview their link by attaching a card to their message.
The following Chat app helps customer service agents preview links to cases shared in a Chat space by attaching a card that shows information about the case.
@mention users in a message
Your Chat app can @mention specific users or all users in a space to notify them of the message. Before you mention a single user, and especially before you mention all users in a space, you should consider whether or not it's really necessary, and err on the side of not @mentioning people.
Mentioning single users causes them to receive a notification and interrupts whatever else they're doing. Mentioning all users in a space sends a notification to everyone in the space. Mention people too often, and they might become annoyed with your Chat app and start to view it as spam.
It is OK to mention users for very important or time-sensitive reasons. For example, the following Chat app @mentions a space full of software developers to notify them that code freeze is approaching and to give them the chance to say they need a bit more time before the deadline:
On the other hand, the following Chat app mentions a customer directly to thank them; which is polite, but not notification-worthy:
- Receive and respond to interactions with your Chat app
- Send card messages
- Open and respond to dialogs
- Set up slash commands to interact with Chat users
- Preview links
- Identify and specify Chat users