משתמש שולח הודעה לאפליקציית Chat או מפעיל את אפליקציית Chat במרחב. דוגמאות לאירועים שקשורים להודעות:
כל הודעה במרחב של צ'אט ישיר (DM) עם אפליקציית Chat.
הודעה במרחב עם כמה אנשים שבה מישהו מתייג את אפליקציית Chat עם @או משתמש באחת מפקודות הסלאש שלה.
אם הגדרתם תצוגה מקדימה של קישורים באפליקציית Chat, משתמש יפרסם הודעה שמכילה קישור שתואם לתבנית כתובת ה-URL שהוגדרה.
ADDED_TO_SPACE
משתמש מוסיף את אפליקציית Chat למרחב, או שאדמין ב-Google Workspace מתקין את אפליקציית Chat במרחבים לצ'אטים ישירים עבור משתמשים בארגון שלו. אפליקציות צ'אט בדרך כלל מגיבות לאירוע האינטראקציה הזה בפרסום הודעת ברוכים הבאים במרחב.
כשאדמינים מתקינים אפליקציות ל-Chat, השדה space.adminInstalled מוגדר לערך true והמשתמשים לא יכולים להסיר אותן. מידע על אפליקציות ל-Chat שהאדמינים התקינו זמין במאמר התקנת אפליקציות מ-Marketplace בדומיין במרכז העזרה לאדמינים של Google Workspace.
REMOVED_FROM_SPACE
משתמש מסיר את אפליקציית Chat מהמרחב, או שאדמין ב-Google Workspace מסיר את ההתקנה של אפליקציית Chat עבור משתמש בארגון. אפליקציות צ'אט לא יכולות להגיב לאירוע הזה בהודעות, כי הן כבר הוסרו.
כשאדמינים מסירים אפליקציות ל-Chat, השדה space.adminInstalled מוגדר לערך false. אם משתמש התקין את אפליקציית Chat לפני האדמין, אפליקציית Chat תישאר מותקנת אצל המשתמש, והיא לא תקבל REMOVED_FROM_SPACE אירוע אינטראקציה.
CARD_CLICKED
משתמש לוחץ על אלמנט אינטראקטיבי בכרטיס או בתיבת דו-שיח באפליקציית Chat, כמו לחצן. כדי לקבל אירוע אינטראקציה, הלחיצה על הלחצן צריכה להפעיל אינטראקציה נוספת עם אפליקציית הצ'אט. לדוגמה, אפליקציית צ'אט לא מקבלת אירוע אינטראקציה CARD_CLICKED אם משתמש לוחץ על לחצן שפותח קישור לאתר, אבל היא מקבלת אירועי אינטראקציה בדוגמאות הבאות:
המשתמש לוחץ על כפתור Send feedback בכרטיס, ונפתחת תיבת דו-שיח שבה הוא יכול להזין מידע.
המשתמש לוחץ על לחצן Submit אחרי שהוא מזין מידע בכרטיס או בתיבת דו-שיח.
אם משתמש לוחץ על לחצן כדי לפתוח, לשלוח או לבטל תיבת דו-שיח, השדה isDialogEvent של אירוע האינטראקציה CARD_CLICKED מוגדר לערך true וכולל DialogEventType.
WIDGET_UPDATED
משתמש מעדכן ווידג'ט בהודעה או בתיבת דו-שיח של כרטיס. האירוע הזה מופעל כשמשתמש מבצע אינטראקציה עם ווידג'ט שמשויכת אליו פעולה.
APP_COMMAND
משתמש מריץ פקודה באפליקציית Chat, כולל פקודות סלאש ופקודות מהירות.
APP_HOME
משתמש פותח צ'אט ישיר מאפליקציית Chat שמשתמשת בדף הבית של האפליקציה. רק השדות type, user ו-space נכללים באירועים מהסוג הזה. מידע נוסף זמין במאמר בנושא בניית דף בית לאפליקציה ל-Google Chat.
SUBMIT_FORM
משתמש שולח מידע בכרטיס הבית של האפליקציה. רק השדות type, user ו-space נכללים באירועים מהסוג הזה. מידע נוסף זמין במאמר בנושא בניית דף בית לאפליקציה ל-Google Chat.
[[["התוכן קל להבנה","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-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,[]]
