Chat

  Botpress
GoogleChat 統合Botpress

この統合により、Botpress チャットボットをGoogleChat スペースに接続することができ、ボットと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 & Services" > "Library "に移動する。
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.サービスアカウントの作成」をクリックする。
5.サービスアカウントの詳細を入力し、"Create "をクリックします。
6.サービスアカウントの新しいキーを作成します：
   - サービスアカウントをクリックします。
   - キー "タブに移動
   - Add Key" > "Create new key "をクリックします。
   - JSON形式を選択
   - キーファイルをダウンロード

### 3.GoogleChat 設定

1.Google Cloud Console](https://console.cloud.google.com)にアクセスします。
2."APIとサービス" > "GoogleChat API "に移動します。
3."設定 "をクリック
4.以下の設定でアプリを設定します：
   - アプリ名**：ボットの名前を選択します。
   - 説明**：ボットの機能の説明を追加します。
   - アバターURL**：ボットのアバター画像のURLを追加します。
   - **Features**：
     - 対話機能を有効にする
     - 1-1メッセージの受信を有効にする
     - スペースやグループ会話への参加を有効にする
   - HTTPエンドポイントURLGoogleChat 統合設定にあるBotpress webhook URLに設定します。

### 4.Botpress
で統合を設定するBotpress

1.Botpress インスタンスで、Integrationsセクションに移動します。
2.GoogleChat 統合を検索し、選択します。
3.以下の設定を行います：
   - サービスアカウントJSON**：サービスアカウントJSON**: ダウンロードしたサービスアカウントキーファイルの全内容を貼り付けます。
   - デフォルトスペースデフォルトスペース**: デフォルトの GoogleChat スペースの ID を入力します。

### 5.GoogleChat スペースにボットを追加する

1.GoogleChat スペースを開く
2.スペース名をクリックしてスペースの詳細を開きます。
3.アプリと統合 "に進みます。
4.アプリの追加 "をクリックします。
5.サービスアカウントのEメールを使用してボットを検索します。
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) を参照ください。