將 Chat 應用程式與其他服務和工具連結

本頁面說明如何將 Google Chat 應用程式連結至服務 Google Chat 以外的工具Chat 擴充應用程式 通常也會與其他系統一起協作 隨附應用程式,以便連結帳戶、授權資料存取、顯示 或調整使用者的偏好設定

必要條件

已啟用互動功能的 Google Chat 應用程式。如要建立 互動式 Chat 應用程式,請完成下列其中一個快速入門導覽課程 在要使用的應用程式架構中:

要求使用者授予 Chat 應用程式設定

如完成要求所需的額外設定 直接在 Chat 應用程式中完成、傳回 作為一般回覆的一部分,或以私人方式向使用者呈現設定網址 格式如下:

{
  "actionResponse": {
    "type": "REQUEST_CONFIG",
    "url": "CONFIGURATION_URL"
  }
}

這樣一來,Google Chat 就會向使用者顯示私人提示,其中 「CONFIGURATION_URL」是連結 使用者造訪的其他驗證、授權或 此外還會從 0 自動調整資源配置 您完全不必調整資源調度設定REQUEST_CONFIG 回應與一般的 回應訊息。系統會忽略所有文字、資訊卡或其他屬性。

完成設定要求

每次 MESSAGE 互動事件 使用者可能會收到 Chat 擴充應用程式 configCompleteRedirectUrl。您必須將這個網址編碼成 完成程序時要使用的設定網址正在重新導向至這個網頁 網址會向 Google Chat 發出信號,表示已完成設定要求。

Chat 應用程式啟動後,流程取決於 收到的特定訊息回應「@app help」這類訊息時, Chat 應用程式應回覆沒有訊息 需要額外設定

當成功將使用者重新導向至 configCompleteRedirectUrl 時 提供原始訊息,Google Chat 會執行下列步驟:

  1. 清除向啟動使用者顯示的提示。
  2. 將原始訊息轉換為公開,讓「 」的其他成員查看 在這個空間中
  3. 將原始訊息傳送到同一個 Chat 應用程式 第二次。

造訪 configCompleteRedirectUrl 只會影響單一使用者訊息。 如果使用者多次嘗試傳送訊息給 Chat 應用程式 因而收到多次提示,按下了 提示並完成驗證程序和設定程序只會影響 指出特定訊息的內容其他訊息則維持不變。

以這種方式重新傳送 MESSAGE 互動事件時,應呈現相同 原始事件;但有些情況下MESSAGE 互動事件舉例來說,如果訊息同時提及 Chat 應用程式 A 和 Chat 應用程式 B。 如果 Chat 應用程式 A 中,使用者能夠編輯訊息 進行驗證前,請先一般訊息回覆 Chat 應用程式 B。在本例中 Chat 應用程式 B 會在 使用者完成驗證和設定。

透過 Chat 以外的方式驗證 Chat 使用者

在某些情況下 (例如為 API 要求 OAuth 授權) 時,您的應用程式需要 連結至 Chat 外的網址,同時維持使用者 識別個人身分如要在這類情況下識別使用者身分,最好的方法就是保護使用者的 使用 Google 登入功能前往目的地應用程式。

使用 識別權杖 取得使用者 ID。sub 聲明包含使用者的 專屬 ID,可以與 Google Chat 中的使用者 ID 建立關聯。

這兩個 ID 不完全相同,但可以強制進行。目的地: 將 sub 的價值主張轉換為 Google Chat users/{user},在前面加上 值為 users/。例如,123 的索賠值相同 傳送至您的以下使用者名稱:users/123 Chat 應用程式。