#Botpress 的 GoogleChat 整合Botpress
此整合功能可讓您將Botpress 聊天機與 GoogleChat 空間連結，讓您的Botpress 聊天機與 GoogleChat 使用者進行無縫溝通。
功能
- 在 GoogleChat 空間中發送和接收訊息
- 自動訊息處理與回應
- 支援多個 GoogleChat 空間
- 使用 Google 服務帳戶進行安全認證
先決條件
1.一個 Google Cloud Platform (GCP) 帳戶 2.您要部署機器人的 GoogleChat 空間 3.安裝了 GoogleChat 整合的Botpress 實例
設定說明
1.啟用 GoogleChat API
1.前往 Google Cloud Console。 2.導覽至「API 與服務」>「資料庫 3.搜尋「GoogleChat API 4.按一下 GoogleChat API 5.按一下「啟用」以啟用專案的 API
2.建立 Google 服務帳號
1.前往 Google Cloud Console。 2.建立新專案或選擇現有專案 3.導覽至 "IAM & Admin" > "Service Accounts" 4. 4.按一下「建立服務帳戶 5.填寫服務帳戶詳細資訊，然後按一下「建立 6.為服務帳戶建立新密鑰：
- 按一下服務帳戶
- 移至「金鑰」索引標籤
- 按一下「新增金鑰」>「建立新金鑰
- 選擇 JSON 格式
- 下載金鑰檔案
3.設定 GoogleChat 應用程式設定
1.前往 Google Cloud Console。 2.導覽至「API 與服務」>「GoogleChat API 3.按一下「組態 4.使用下列設定設定您的應用程式：
- ** 應用程式名稱**：為您的機器人選擇一個名稱
- Description：新增您的機器人功能描述
- Avatar URL：新增您機器人頭像的 URL
- 功能***：
- 啟用互動功能
- 啟用接收 1-1 訊息
- 啟用加入空間和群組對話
- HTTP 端點 URL：將此設定為您在 GoogleChat 整合設定中找到的Botpress webhook URL。
4.在Botpress
中設定整合Botpress
1.在您的Botpress 範例中，前往「整合」部分 2.找到並選擇 GoogleChat 整合 3.配置以下設定：
- 服務帳號 JSON：貼上下載的服務帳號金鑰檔案的全部內容
- 預設空間：輸入您的預設 GoogleChat 空間 ID (選用)
5.將 Bot 加入您的 GoogleChat 空間
1.開啟您的 GoogleChat 空間 2.按一下空間名稱以開啟空間詳細資訊 3.前往「應用程式與整合 4.按一下「新增應用程式 5.使用服務帳號電子郵件搜尋您的機器人 6.將機器人加入您的空間
使用方法
發送訊息
機器人可以傳送訊息到任何已加入的 GoogleChat 空間。訊息可以被傳送
- 回應使用者訊息
- 透過Botpress 流程編輯器主動發送
- 透過自訂程式碼的 API 呼叫
接收訊息
機器人會自動接收並處理在 GoogleChat 空間傳送的訊息。它會
- 解析收到的訊息
- 透過您的Botpress 流程處理訊息
- 傳送適當的回應回空間
訊息格式
整合支援 GoogleChat 空間的文字訊息。訊息可以包括
- 純文字
- 基本格式
- 連結
- 提及
安全考慮
- 妥善保管您的服務帳戶金鑰，切勿公開分享
- 定期輪換您的服務帳戶金鑰
- 為服務帳號指派角色時，請使用最少權限原則
- 監控您的機器人活動，並設定適當的記錄
疑難排解
常見問題
1.機器人沒有回應
- 確認服務帳號有正確的權限
- 檢查機器人是否已正確加入空間
- 確保整合已在Botpress 中正確設定Botpress
2.驗證錯誤
- 確認服務帳號 JSON 格式是否正確
- 檢查服務帳號金鑰是否有效且未過期
- 確保服務帳戶已啟用必要的 API 範圍
3.訊息傳送問題
- 確認空間 ID 是否正確
- 檢查機器人是否有在空間發佈的權限
- 確保訊息格式有效
API 參考
有關 GoogleChat API 的詳細資訊，請參考 官方文件。
