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) を参照ください。