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 の詳細については、公式ドキュメント を参照ください。
