사용자가 Chat 앱에 메시지를 보내거나 스페이스에서 Chat 앱을 호출합니다. 메시지 이벤트의 예는 다음과 같습니다.
Chat 앱이 포함된 채팅 메시지 (DM) 스페이스의 모든 메시지
사용자가 Chat 앱을 @멘션하거나 슬래시 명령어 중 하나를 사용하는 여러 사용자가 있는 스페이스의 메시지
채팅 앱에 링크 미리보기를 구성한 경우 사용자가 구성된 URL 패턴과 일치하는 링크가 포함된 메시지를 게시합니다.
ADDED_TO_SPACE
사용자가 Chat 앱을 스페이스에 추가하거나 Google Workspace 관리자가 조직의 사용자를 위해 채팅 메시지 스페이스에 Chat 앱을 설치합니다. 채팅 앱은 일반적으로 스페이스에 환영 메시지를 게시하여 이 상호작용 이벤트에 응답합니다.
관리자가 Chat 앱을 설치하면 space.adminInstalled 필드가 true로 설정되고 사용자는 앱을 제거할 수 없습니다. 관리자가 설치한 Chat 앱에 대해 알아보려면 Google Workspace 관리자 도움말의 도메인에 Marketplace 앱 설치하기 문서를 참고하세요.
REMOVED_FROM_SPACE
사용자가 스페이스에서 Chat 앱을 삭제하거나 Google Workspace 관리자가 조직의 사용자를 대상으로 Chat 앱을 제거합니다. 채팅 앱이 이미 삭제되었으므로 이 이벤트에 메시지로 응답할 수 없습니다.
관리자가 Chat 앱을 제거하면 space.adminInstalled 필드가 false로 설정됩니다. 사용자가 관리자보다 먼저 Chat 앱을 설치한 경우 Chat 앱은 사용자에게 설치된 상태로 유지되며 Chat 앱은 REMOVED_FROM_SPACE 상호작용 이벤트를 수신하지 않습니다.
CARD_CLICKED
사용자가 Chat 앱의 카드 또는 대화상자에서 버튼과 같은 대화형 요소를 클릭합니다. 상호작용 이벤트를 수신하려면 버튼이 Chat 앱과의 다른 상호작용을 트리거해야 합니다. 예를 들어 사용자가 웹사이트 링크를 여는 버튼을 클릭하면 Chat 앱이 CARD_CLICKED 상호작용 이벤트를 수신하지 않지만 다음 예에서는 상호작용 이벤트를 수신합니다.
사용자가 카드에서 Send feedback 버튼을 클릭하면 정보를 입력할 수 있는 대화상자가 열립니다.
사용자가 카드나 대화상자에 정보를 입력한 후 Submit 버튼을 클릭합니다.
사용자가 버튼을 클릭하여 대화상자를 열거나 제출하거나 취소하면 CARD_CLICKED 상호작용 이벤트의 isDialogEvent 필드가 true로 설정되고 DialogEventType가 포함됩니다.
WIDGET_UPDATED
사용자가 카드 메시지 또는 대화상자에서 위젯을 업데이트합니다. 이 이벤트는 사용자가 연결된 작업이 있는 위젯과 상호작용할 때 트리거됩니다.
[[["이해하기 쉬움","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,[]]
