[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["缺少我需要的資訊","missingTheInformationINeed","thumb-down"],["過於複雜/步驟過多","tooComplicatedTooManySteps","thumb-down"],["過時","outOfDate","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["示例/程式碼問題","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間：2025-03-06 (世界標準時間)。"],[[["\u003cp\u003eGoogle Chat apps can enhance user interaction through features like slash commands, interactive cards, and dialogs.\u003c/p\u003e\n"],["\u003cp\u003eOnboarding messages are crucial for introducing your Chat app's functionality and guiding users on how to get started.\u003c/p\u003e\n"],["\u003cp\u003eCards provide a visually engaging way to gather information, display details, and guide users within Chat.\u003c/p\u003e\n"],["\u003cp\u003eDialogs facilitate multi-step processes by enabling sequential card interactions within a dedicated window.\u003c/p\u003e\n"],["\u003cp\u003eChat apps can preview links shared by users, enhancing the context and information associated with them.\u003c/p\u003e\n"]]],["Google Chat apps interact with users by sending welcome messages, responding to slash commands (e.g., `/help`), and using interactive cards for UI. Apps can also open dialogs for multi-step processes, preview shared links with detailed information, and @mention users for important notifications, though overuse should be avoided. Building these interactive features requires the app to be configured to receive interaction events from Google chat.\n"],null,["# Design user interactions\n\nThis page describes how Google Chat apps can design and respond to\ninteractions with users.\n\nChat apps support interactivity in some of the\nfollowing ways:\n\n- Introduce users to your Chat app\n- Respond to commands\n- Display or send interactive card-based interfaces\n- Open interactive dialogs\n- Preview links\n- @mention users in a message\n\nIntroduce users to your Chat app\n--------------------------------\n\nOnboard people and spaces to your Chat app with a\nwelcome message that details what your Chat app does,\nand how people can best work with it.\n\nAn effective onboarding message has the following structure:\n\n- **Say hello**. Set the right voice and tone with your users.\n- **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.\n- **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 commands.\n- **Explain how to get help and how to give feedback**. End the message by telling people how they can get help or offer feedback.\n\nThe following Chat app's onboarding message prepares\nusers for success:\n\nRespond to commands\n-------------------\n\n[Commands](/workspace/chat/commands)\nlet users request or interact with your Chat app in\nspecific or repeatable ways. Users can use commands in messages (such as typing\n`/help`), or select them from a menu in the reply area.\n\nThe following is a list of commands available for the Cymbal\nChat app:\n\n@mention users in messages\n--------------------------\n\nYour Chat app can\n[@mention specific users or all users](/workspace/chat/format-messages#messages-@mention)\nin a space to notify them of the message.\nBefore you mention a single user, and especially before you\nmention all users in a space, you should consider whether or not it's really\nnecessary, and err on the side of **not @mentioning people**.\n\nMentioning single users causes them to receive a notification and interrupts\nwhatever else they're doing. Mentioning all users in a space sends a\nnotification to everyone in the space. Mention people too often, and they might\nbecome annoyed with your Chat app and start to view it\nas spam.\n\nIt is OK to mention users for very important or time-sensitive reasons. For\nexample, the following Chat app @mentions a space full\nof software developers to notify them that code freeze is approaching and to\ngive them the chance to say they need a bit more time before the deadline:\n\nOn the other hand, the following Chat app mentions a\ncustomer directly to thank them; which is polite, but not notification-worthy:\n\nSend or display interactive cards\n---------------------------------\n\nCards are UI elements that can contain both interactive and static\nwidgets such as text, images, and buttons that Chat apps can send\nto users and spaces. If your Chat app needs to gather\ninformation from users, present detailed information, or guide users to take a\nnext step, send a card message.\n\nAs a Chat app, you can send card interfaces in\n[messages](/workspace/chat/create-messages#create) or display cards as a\n[homepage](/workspace/chat/send-app-home-card-message) in direct message spaces.\n\n\n*** ** * ** ***\n\nUse the Card Builder to design and preview messaging and user interfaces for Chat apps:\n[Open the Card Builder](https://addons.gsuite.google.com/uikit/builder)\n\n*** ** * ** ***\n\n\u003cbr /\u003e\n\nThe following is a card message from a Chat app:\n\n### Open interactive dialogs\n\n[Dialogs](/workspace/chat/dialogs) are windowed, card-based interfaces that a\nuser can open to interact with your Chat app. In\ndialogs, you can string together multiple card messages sequentially, which\nhelps users complete multi-step processes, like filling in\n[form data](/workspace/chat/read-form-data).\n\nIn the following example, a Chat app starts a dialog to\ngather contact details from a user who issues the `/createContact` slash\ncommand:\n\n### Preview links sent by Chat users\n\nChat apps can [preview links](/workspace/chat/preview-links)\nfor users in a space. Whenever someone shares a matching link,\na Chat app can attach a card to their message that\ndisplays information about the link.\n\nThe following Chat app helps customer service agents\npreview links to cases shared in a Chat space:\n\nNext steps\n----------\n\nTo build interactive features, you must configure your\nChat app to receive interaction events. For steps,\n[Receive and respond to interactions with your Chat app](/workspace/chat/receive-respond-interactions)"]]
