前提条件
- AI Helpdesk の 管理者（Admin） ロールが必要です
- Google Workspace の特権管理者権限 が必要です（ドメイン全体の委任の設定に必要）
- Google Cloud Console（GCP） にアクセスできるアカウントが必要です（Google Workspace 管理者と同じアカウントでも、別アカウントでも構いません）
接続に必要な情報
接続フォームでは以下 4 つの値を入力します。手順内で順に取得します。| 項目 | 説明 |
|---|---|
| GCPプロジェクト番号 | GCP プロジェクトの プロジェクト番号（Project ID ではなく数値の方） |
| サービスアカウントJSON | サービスアカウントの JSON キー全体 |
| ボット表示名 | Google Chat 上でのボットの表示名（Step 5 で設定する App name と同じ値） |
| 管理者メール | サービスアカウントが代理アクセスする Google Workspace 特権管理者のメールアドレス |
Step 1: GCP プロジェクトを作成する
Google Cloud Console を開く
https://console.cloud.google.com を開き、画面上部のプロジェクトセレクターから 新しいプロジェクト をクリックします。
Step 2: 必要な API を有効化する
GCP プロジェクトで API とサービス > ライブラリ を開き、以下 2 つの API を有効化します。- Google Chat API
- Admin SDK API
Step 3: サービスアカウントを作成する
サービスアカウントを作成する
GCP プロジェクトで IAM と管理 > サービスアカウント を開き、サービスアカウントを作成 をクリックします。
- 名前: 任意（例:
minabot-chat-bot） - 説明: 任意
Step 4: ドメイン全体の委任（DWD）を設定する
サービスアカウントが Google Workspace のディレクトリ情報を参照できるようにします。サービスアカウント側で DWD を有効化する
GCP の IAM と管理 > サービスアカウント で対象のサービスアカウントを開きます。
詳細 タブの 詳細設定 で ドメイン全体の委任 を有効化し、保存してください。保存後に表示される クライアント ID（数値）を控えます。
Google Workspace 管理コンソールでスコープを認可する
https://admin.google.com を開き、セキュリティ > アクセスとデータ管理 > API の制御 に移動します。
ドメイン全体の委任の管理 で 新しく追加 をクリックします。
- クライアント ID: 前のステップで控えた値
-
OAuth スコープ: 以下 3 つを カンマ区切りで 1 行 に入力します
https://www.googleapis.com/auth/chat.spaces.createhttps://www.googleapis.com/auth/admin.directory.user.readonlyhttps://www.googleapis.com/auth/chat.bot
Step 5: Google Chat アプリを構成する
Google Chat API の Configuration を開く
GCP プロジェクトで API とサービス > Google Chat API > Configuration タブを開きます。
機能と接続先を設定する
Functionality で以下を有効にします。
- Receive 1:1 messages
- Join spaces and group conversations
Step 6: ボットをスペースに追加する
Google Chat を開き、ボットを利用したいスペースで以下を実行します。- スペース名 > アプリと統合 > アプリを追加 をクリック
- 構成したアプリ名で検索し、追加 をクリック
Step 7: AI Helpdesk で接続を完了する
認証情報を入力する
以下の値を入力します。
- GCPプロジェクト番号: Step 1 で取得した数値
- サービスアカウントJSON: Step 3 でダウンロードした JSON の全体
- ボット表示名: Step 5 で設定した Google Chat アプリの App name
- 管理者メール: Step 4 で決めた Google Workspace 特権管理者のメールアドレス
ボットを利用する
接続が完了すると、Google Chat 上でボットに対して問い合わせができるようになります。ダイレクトメッセージで質問する
ボットとの DM にメッセージを送信すると、AI が応答します。スペースでメンションして質問する
スペースでボットをメンションすると、スレッドで AI が応答します。 スレッド内で続けて返信することで、同じセッションを継続できます。Google Chat 接続を解除する
設定 > 連携 タブの メッセージング セクションで、切断するカードのゴミ箱アイコンをクリックしてください。トラブルシューティング
「認証情報が無効です」と表示される- GCPプロジェクト番号 が数値のみ（Project ID ではない）であることを確認してください
- サービスアカウントJSON の中括弧
{}を含めて全体を貼り付けているか確認してください - 管理者メール が Google Workspace の特権管理者のメールアドレスであることを確認してください
- Step 2 で Google Chat API と Admin SDK API の両方が有効化されているか確認してください
- Step 4 の Google Workspace 管理コンソールで、必要な OAuth スコープがすべて認可されているか確認してください
- Step 5 の Connection settings > App URL に正しい webhook URL が設定されているか確認してください
- Step 6 でボットがスペースに追加されているか確認してください
- スペース内で正しくボットをメンションしているか確認してください