GoogleChat 空間

  #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](https://console.cloud.google.com)。
2.導覽至「API 與服務」>「資料庫
3.搜尋「GoogleChat API
4.按一下 GoogleChat API
5.按一下「啟用」以啟用專案的 API

### 2.建立 Google 服務帳號

1.前往 [Google Cloud Console](https://console.cloud.google.com)。
2.建立新專案或選擇現有專案
3.導覽至 "IAM & Admin" > "Service Accounts" 4.
4.按一下「建立服務帳戶
5.填寫服務帳戶詳細資訊，然後按一下「建立
6.為服務帳戶建立新密鑰：
   - 按一下服務帳戶
   - 移至「金鑰」索引標籤
   - 按一下「新增金鑰」>「建立新金鑰
   - 選擇 JSON 格式
   - 下載金鑰檔案

### 3.設定 GoogleChat 應用程式設定

1.前往 [Google Cloud Console](https://console.cloud.google.com)。
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 的詳細資訊，請參考 [官方文件](https://developers.google.com/chat/api/reference/rest)。