本頁面說明 Google Chat 應用程式如何接收及 回應使用者互動 (也稱為 Google Chat 應用程式) 互動事件。
「Google Chat 應用程式互動事件」代表使用者採取的動作 使用者如何叫用 Chat 應用程式或與 Chat 應用程式互動。例如 使用 @號提及 Chat 應用程式,或將該應用程式新增至 空白鍵。當使用者與 Chat 應用程式互動時, Google Chat 會傳送互動事件給 Chat 應用程式。 Chat 應用程式可以利用活動處理 互動及產生回應
舉例來說,Chat 擴充應用程式會利用互動事件執行下列任一操作: 包括:
互動事件範例 | Chat 應用程式的一般回覆 |
---|---|
使用者叫用 Chat 應用程式的方式如下: 使用 @ 號提及他人,或是使用斜線指令。 |
Chat 應用程式會處理訊息的指令
建立訊息。例如,Chat 即時通訊應用程式
/about 指令,其中顯示訊息來說明
Chat 應用程式可以執行多項操作。 |
使用者將 Chat 應用程式新增到 聊天室。 | Chat 應用程式傳送新手上路程序 訊息,說明聊天室的用途以及使用者與聊天室互動的方式 基礎架構 |
使用者移除 聊天室中的 Chat 應用程式。 | Chat 擴充應用程式會移除所有收到的通知 (例如刪除 webhook) 並清除任一 內部儲存空間 |
使用者點選 Chat 應用程式。 | Chat 應用程式會處理並儲存 使用者提交的資料,或傳回其他資訊卡或對話方塊。 |
Google Chat 會針對每種使用者互動類型傳送不同類型的
協助 Chat 應用程式處理
對應的事件類型舉例來說,Google Chat 會使用活動類型
ADDED_TO_SPACE
用於使用者加入
將即時通訊應用程式加到聊天室,
Chat 擴充應用程式可處理回覆,例如:
歡迎訊息加入聊天室。如要查看所有支援的互動事件,請參閱
EventType
參考資料
說明文件。
本頁說明如何執行下列操作:
- 設定 Chat 應用程式來接收事件。
- 處理基礎架構中的互動事件。
- 在適當情況下,回應互動事件。
接收 Chat 應用程式互動事件
本節將說明如何接收及處理以下項目的互動事件: Chat 應用程式。
設定 Chat 應用程式以接收互動事件
並非所有 Chat 擴充應用程式都具有互動功能。例如: 連入 Webhook 只能傳送送出訊息, 無法回覆使用者如果您要建立互動式 Chat 應用程式,您必須選擇能允許 Chat 擴充應用程式接收、處理及回覆互動 事件。如要進一步瞭解如何設計 Chat 應用程式,請參閱 Chat 擴充應用程式實作架構。
如果您建構的是互動式 Chat 應用程式 必須設定 Google Chat API,Google Chat 才能傳送 互動事件:
- 在 Google Cloud 控制台中,開啟 Google Chat API 頁面:
- 點選「設定」分頁標籤。
- 在「互動功能」部分中,按一下「啟用互動功能」切換按鈕,將功能設為開啟。
- 在「功能」中,勾選下列一或兩個核取方塊:
- 接收 1:1 訊息:允許使用者在即時訊息 (DM) 聊天室中與 Chat 應用程式互動。每當使用者在即時訊息聊天室中傳送訊息,Chat 應用程式就會收到互動事件。
- 加入聊天室和群組對話:允許使用者在有多位使用者的聊天室中新增及移除 Chat 應用程式。在聊天室中新增或移除應用程式,以及每當使用者在聊天室中使用 @號提及或使用斜線指令,Chat 應用程式都會收到互動事件。
- 在「連線設定」中,指定 Google Chat 傳送 Chat 應用程式互動事件的位置。
- 選用:在「Slash 指令」中新增並設定一或多個斜線指令。詳情請參閱設定斜線指令。
- 選用:在「連結預覽」中,新增並設定一或多個要用於 Chat 應用程式預覽的網址模式。詳情請參閱「預覽連結」一文。
- 按一下 [儲存]。
Chat 應用程式現已設為可接收互動 以及 Google Chat 中的活動。
處理服務的 HTTP 呼叫重試作業
如果傳送至服務的 HTTPS 要求失敗 (例如逾時或臨時網路) 如果 HTTPS 狀態有誤或非 2xx HTTPS 狀態碼,Google Chat 可能會再次嘗試傳送 數次 (但不保證有效)。因此, 即時通訊應用程式可能會在以下時間多次收到相同的訊息: 或在特定情況下。如果要求成功完成,但傳回無效 訊息酬載,Google Chat 不會重試要求。
處理或回應互動事件
本節說明 Google Chat 應用程式可如何處理及回覆 互動事件。
Chat 應用程式從以下來源收到互動事件後: Google Chat 的回覆方式很多,在許多情況下 即時通訊應用程式會透過訊息回覆使用者。 Google Chat 應用程式也可以查詢資料中的部分資訊 記錄互動事件資訊等等。 這個處理行為基本上是定義 Google Chat 應用程式。
Chat 擴充應用程式會針對每個互動事件收到「要求主體」。 這是代表事件的 JSON 酬載您可以使用 用於處理回應的資訊如需事件酬載的範例,請參閱 Chat 應用程式互動事件類型。
下圖示範瞭如何 Google Chat 應用程式通常會處理或回覆不同類型的問題 互動事件:
即時回覆
互動事件可讓 Chat 擴充應用程式即時回應。 同步方式。同步回應不需要 authentication。
如要建立互動事件的同步回應,請參閱下文 指南:
如要同步回覆,Chat 應用程式必須回應 回應,且回應必須張貼在 是否有互動發生。否則,Chat 應用程式可以 以非同步方式回應
以非同步方式回應
即時通訊應用程式有時必須在 30 秒後回應互動事件 或是在聊天室外執行的工作,在聊天室中發生互動事件 。舉例來說,Chat 應用程式可能需要 則在完成長時間執行的工作後回應使用者在本例中 即時通訊應用程式可以呼叫 Google Chat API,以非同步的方式回應。
如要使用 Chat API 建立訊息,請參閱 建立訊息。如需使用指南 如需其他 Chat API 方法,請參閱 Chat API 總覽。