Google Chatと接続する

接続前の確認事項

接続前の確認事項は以下のとおりです。

• Google Cloud Platform（GCP）へのアクセス権を持つアカウント（IT部門）が対応できること
• Google Workspace管理者権限を持つアカウントが対応できること

Google Chat連携は、GCPでのService Account作成とGoogle Workspace管理コンソールでのドメイン全体の委任設定が必要です。事前にIT部門と調整してください。

ステップ1：Google Cloud Consoleでプロジェクトを作成する

Google Cloud Consoleにアクセスし、サービスアカウント用のプロジェクトを作成します。

※既存のプロジェクトを使用する場合は、本ステップをスキップしてください。

1. ブラウザで「Google Cloud Console」にアクセスし、Googleアカウントでログインします。
2. 画面上部の［プロジェクト名］をクリックします。
   
3. 表示されたダイアログで［新しいプロジェクト］を選択します。
   
4. プロジェクト名を入力し、［作成］をクリックします。
   

ステップ2：Google Chat APIを有効化する

作成したプロジェクトでGoogle Chat APIを有効にします。これにより、サービスアカウントがGoogle Chatにアクセスできるようになります。

1. 画面上部のプロジェクト名をクリックし、「ステップ1：Google Cloud Consoleでプロジェクトを作成する」で作成したプロジェクトを選択します。
2. 左上の［☰（ナビゲーションメニュー）］をクリックします。
   
3. ナビゲーションメニューから［APIとサービス］→［ライブラリ］を選択します。
   
4. 検索ボックスに「Google Chat API」と入力して検索します。
   
5. 検索結果から［Google Chat API］をクリックします。
   
6. ［有効にする］ボタンをクリックしてAPIを有効化します。
   

ステップ3：Admin SDK APIを有効化する

ドメイン全体の委任で必要となるAdmin SDK APIも有効にします。これにより、組織内のユーザー情報にアクセスできるようになります。

1. 再度［APIとサービス］→［ライブラリ］に戻ります。
2. 検索ボックスに「Admin SDK API」と入力して検索します。
3. 検索結果から［Admin SDK API］をクリックします。
   
4. ［有効にする］ボタンをクリックしてAPIを有効化します。
   

ステップ4：サービスアカウントを作成する

Google Chatにアクセスするためのサービスアカウントを作成します。サービスアカウントは、ユーザーの代わりにAPIにアクセスするための特別なアカウントです。

1. ナビゲーションメニューから［APIとサービス］→［認証情報］を選択します。
   
2. 画面上部の［＋認証情報を作成］をクリックし、ドロップダウンから［サービスアカウント］を選択します。
   
3. サービスアカウント名を入力し、［作成して続行］をクリックします。
   
4. ［ロールを選択］は空のままで［続行］をクリックします。
   ※ロールの付与は不要です。
   
5. 「アクセス権を持つプリンシパル」は空のままで［完了］をクリックしてサービスアカウントを作成します。
   

ステップ5：クライアントIDを取得する

作成したサービスアカウントのクライアントIDを取得します。このIDは後でGoogle Workspace管理コンソールでドメイン全体の委任を設定する際に使用します。

1. 「認証情報」画面のサービスアカウント一覧から、作成したサービスアカウントのメールアドレスをクリックします。
2. 「詳細設定」セクションを展開（または画面下部にスクロール）します。
3. 「ドメイン全体の委任」セクションに表示されている「クライアントID」（数字の羅列）をコピーしてメモ帳などに保存します。
   

ステップ6：サービスアカウントキー（JSON）をダウンロードする

サービスアカウントの認証に使用するJSONキーファイルをダウンロードします。このファイルは後でfreee AIヘルプデスクにアップロードします。

1. サービスアカウントの詳細画面で［鍵］タブを選択します。
2. ［キーを追加］をクリックし、［新しい鍵を作成］を選択します。
   
3. キーのタイプは「JSON」を選択し、［作成］をクリックします。
   
4. JSONファイルが自動的にダウンロードされます。このファイルは安全な場所に保管してください。紛失した場合は再作成が必要です。

ステップ7：Google Chatアプリを設定する

Google Chat APIの構成画面でアプリの設定を行います。

1. ［有効なAPIとサービス］から「Google Chat API」を開き、［構成］タブを選択します。
2. 「アプリのステータス」を［ライブ - ユーザーが利用可能］に設定します。
3. 「アプリ名」「アバターのURL」「説明」を入力します。
   
4. 「インタラクティブ機能」を有効にします。
5. 機能の「スペースとグループの会話に参加する」にチェックを入れます。
6. 接続設定の「HTTP エンドポイント URL」を選択します。
7. トリガーの「すべてのトリガーに共通の HTTP エンドポイント URL を使用する」にチェックを入れ、「HTTPエンドポイントURL」に以下URLを入力します。
   • https://hd.secure.freee.co.jp/integrations/google_chat/events
     
8. 「公開設定」で組織内のユーザーがアプリを利用できるよう設定し、［保存］をクリックします。

ステップ8：Google Workspace管理コンソールでドメイン全体の委任を設定する

Google Workspace管理コンソールで、サービスアカウントにGoogle Chatへのアクセス権限を付与します。

※本設定には管理者権限が必要です。

1. ブラウザで「Google Workspace管理コンソール」にアクセスし、管理者アカウントでログインします。
2. 左側のナビゲーションメニューから［セキュリティ］→［アクセスとデータ管理］→［APIの制御］を選択します。
   
3. 「ドメイン全体の委任」セクションの［ドメイン全体の委任を管理］をクリックします。
   
4. ［新しく追加］をクリックします。
   
5. 「クライアントID」欄に本ページ「ステップ5：クライアントIDを取得する」でコピーしたクライアントIDを貼り付け、「OAuthスコープ」欄に以下のスコープを入力し、［承認］をクリックします。
   • OAuthスコープ：以下をコピーして貼り付けます。
     • https://www.googleapis.com/auth/admin.directory.customer.readonly
       

ステップ9：freee AIヘルプデスクで認証情報を入力する

freee AIヘルプデスクの［Google Chatと接続］ボタンをクリックし、表示されるダイアログに認証情報を入力します。

ステップ10：Google Chatアプリを追加する

問い合わせを受け付けるGoogle Chatスペースにfreee AIヘルプデスクアプリを追加します。

1. Google Chatで問い合わせを受け付けたいスペースを開きます。
2. スペース名をクリックし、「アプリと統合」を開きます。
   
3. 「アプリを追加」からfreee AIヘルプデスクアプリを検索し、追加します。

ステップ11：連携の完了

連携が正常に完了すると、Google Chatからの問い合わせがfreee AIヘルプデスクで受け付けられるようになります。

トラブルシューティング: 連携に失敗する場合は、以下を確認してください。

• Google Chat APIとAdmin SDK APIが有効になっている
• Google Workspace管理コンソールでドメイン全体の委任が正しく設定されている
• Google Workspace管理コンソールで正しいクライアントIDとOAuthスコープが設定されている
• 委任するユーザーがGoogle Workspaceの有効なユーザーである
• Google Chatアプリの設定で「HTTPエンドポイントURL」が正しく設定されている

接続後の動作を確認する

接続が完了すると、Google Chat のアカウントを持つ従業員の方が同サービス上でAIに問い合わせを送れるようになります。

利用可能・不可のGoogle Chat上のチャネルは以下です。

• 利用可能
  • スペース内での質問
  • ダイレクトメッセージでの質問
• 利用不可
  • 特になし

参考：関連ヘルプページ

• チャットツール連携の概要
• 接続設定を変更・削除する