Người dùng gửi tin nhắn cho ứng dụng Chat hoặc gọi ứng dụng Chat trong một không gian. Sau đây là ví dụ về các sự kiện thông báo:
Mọi tin nhắn trong không gian tin nhắn trực tiếp (DM) có ứng dụng Chat.
Một tin nhắn trong không gian có nhiều người tham gia, trong đó một người @đề cập đến ứng dụng Chat hoặc sử dụng một trong các lệnh dấu gạch chéo của ứng dụng.
Nếu bạn đã định cấu hình tính năng xem trước đường liên kết cho ứng dụng Chat, thì người dùng sẽ đăng một thông báo có chứa đường liên kết khớp với mẫu URL đã định cấu hình.
ADDED_TO_SPACE
Người dùng thêm ứng dụng Chat vào một không gian hoặc quản trị viên Google Workspace cài đặt ứng dụng Chat trong không gian nhắn tin trực tiếp cho người dùng trong tổ chức của họ. Các ứng dụng trò chuyện thường phản hồi sự kiện tương tác này bằng cách đăng một tin nhắn chào mừng trong không gian.
Khi quản trị viên cài đặt các ứng dụng Chat, trường space.adminInstalled sẽ được đặt thành true và người dùng không thể gỡ cài đặt các ứng dụng này. Để tìm hiểu về các ứng dụng Chat do quản trị viên cài đặt, hãy xem tài liệu Cài đặt các ứng dụng trên Marketplace trong miền của bạn trong phần Trợ giúp dành cho quản trị viên Google Workspace.
REMOVED_FROM_SPACE
Người dùng xoá ứng dụng Chat khỏi một không gian hoặc quản trị viên Google Workspace gỡ cài đặt ứng dụng Chat cho một người dùng trong tổ chức của họ. Các ứng dụng nhắn tin không thể phản hồi sự kiện này bằng tin nhắn vì đã bị xoá.
Khi quản trị viên gỡ cài đặt các ứng dụng trong Chat, trường space.adminInstalled sẽ được đặt thành false. Nếu người dùng cài đặt ứng dụng Chat trước quản trị viên, thì ứng dụng Chat vẫn được cài đặt cho người dùng và ứng dụng Chat không nhận được sự kiện tương tác REMOVED_FROM_SPACE.
CARD_CLICKED
Người dùng nhấp vào một phần tử tương tác của thẻ hoặc hộp thoại trong ứng dụng Chat, chẳng hạn như một nút. Để nhận được một sự kiện tương tác, nút phải kích hoạt một lượt tương tác khác với ứng dụng Chat. Ví dụ: ứng dụng Chat không nhận được sự kiện tương tác CARD_CLICKED nếu người dùng nhấp vào một nút mở đường liên kết đến một trang web, nhưng sẽ nhận được các sự kiện tương tác trong những ví dụ sau:
Người dùng nhấp vào nút Send feedback trên thẻ. Thao tác này sẽ mở ra một hộp thoại để người dùng nhập thông tin.
Người dùng nhấp vào nút Submit sau khi nhập thông tin vào thẻ hoặc hộp thoại.
Nếu người dùng nhấp vào một nút để mở, gửi hoặc huỷ hộp thoại, thì trường isDialogEvent của sự kiện tương tác CARD_CLICKED sẽ được đặt thành true và bao gồm một DialogEventType.
WIDGET_UPDATED
Người dùng cập nhật một tiện ích trong thông báo hoặc hộp thoại của thẻ. Sự kiện này được kích hoạt khi người dùng tương tác với một tiện ích có hành động liên kết.
APP_COMMAND
Người dùng sử dụng lệnh của ứng dụng Chat, bao gồm cả lệnh dấu gạch chéo và lệnh nhanh.
APP_HOME
Người dùng mở một tin nhắn trực tiếp trong một ứng dụng Chat có sử dụng trang chủ của ứng dụng. Chỉ các trường type, user và space được đưa vào cho các sự kiện thuộc loại này. Để biết thêm thông tin, hãy xem bài viết Tạo trang chủ cho ứng dụng Google Chat.
SUBMIT_FORM
Người dùng gửi thông tin trong thẻ trang chủ của ứng dụng. Chỉ các trường type, user và space được đưa vào cho các sự kiện thuộc loại này. Để biết thêm thông tin, hãy xem bài viết Tạo trang chủ cho ứng dụng Google Chat.
[[["Dễ hiểu","easyToUnderstand","thumb-up"],["Giúp tôi giải quyết được vấn đề","solvedMyProblem","thumb-up"],["Khác","otherUp","thumb-up"]],[["Thiếu thông tin tôi cần","missingTheInformationINeed","thumb-down"],["Quá phức tạp/quá nhiều bước","tooComplicatedTooManySteps","thumb-down"],["Đã lỗi thời","outOfDate","thumb-down"],["Vấn đề về bản dịch","translationIssue","thumb-down"],["Vấn đề về mẫu/mã","samplesCodeIssue","thumb-down"],["Khác","otherDown","thumb-down"]],["Cập nhật lần gần đây nhất: 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,[]]
