BambooHR Microsoft 365 Copilot コネクタ

ユーザーデータ用のMicrosoft 365 Copilot コネクタを使用すると、組織は BambooHR を含む外部システムから Microsoft 365 にデータのインデックスを作成できます。 BambooHR Microsoft 365 Copilot コネクタを使用すると、組織は BambooHR から Microsoft Graph にプロファイルのインデックスを作成して、Microsoft 365 Copilotや Microsoft Search など、Microsoft 365 エクスペリエンス全体でアクセスできるようにします。

このガイドは、Microsoft 365 管理者または BambooHR Copilot コネクタの構成、管理、監視を担当するすべてのユーザーを対象とします。

次のビデオでは、BambooHR コネクタの概要について説明します。

機能

包括的なプロファイルインデックス作成では、名前、連絡先の詳細、役職、部門、採用日、組織階層など、BambooHR の重要な従業員情報が自動的に同期されます。
Microsoft 365 Copilotエクスペリエンスの強化により、エンドユーザーは同僚に関する自然言語の質問をしたり、BambooHR プロファイルデータに基づいてインテリジェントな応答を受け取したりすることができます。 Copilot のセマンティック検索を使用して、ユーザーがキーワード、スキル、部門、場所、および組織の関係に基づいて関連する同僚を見つけるのに役立ちます。
リアルタイムデータ同期では、15 分ごとに既定の増分同期と完全同期を毎日行い、従業員の情報を最新の状態に保ちます。
Microsoft 365 のシームレスな統合により、Microsoft 365 エクスペリエンス全体でプロファイルデータを検出し、コラボレーションを強化し、組織の認識を高めます。
自動 ID マッピングは、BambooHR プロファイルをMicrosoft Entra IDユーザーとインテリジェントに照合し、正確なクロスプラットフォーム ID 関連付けを実現します。

詳細については、「ユーザーデータのコネクタMicrosoft 365 Copilot」を参照してください。

注:

ある人について Copilot に質問すると、引用文献は BambooHR ではなく office.com として表示されます。これは、Microsoft 365 のプロファイル情報が複数のソースから取得される可能性があるためです。たとえば、役職は BambooHR から取得され、名前やその他の詳細はMicrosoft Entraまたはその他の接続されたシステムから取得される場合があります。

制限事項

データインデックス作成スコープは、Microsoft 365 エクスペリエンスと Copilot を最適化するために、主要な従業員プロファイル情報に焦点を当てています。休暇、ドキュメント、特典、トレーニング、資産、メモ、緊急、オンボード、オフボード、カスタムプロパティは、現在のインデックス作成の範囲外です。
アクセス許可を使用すると、コネクタは、Microsoft テナント内のすべてのユーザーがアクセスできるプロファイルデータにインデックスを付け、Microsoft 365 エクスペリエンスと Copilot 全体の従業員情報の広範な検出可能性を確保できます。詳細なユーザーレベルのアクセス許可コントロールは、今後の更新プログラムで使用できるようになります。
ID マッピングでは、プロファイルマッピングを成功させるには、BambooHR の仕事用メールアドレスが、Microsoft Entraの UserPrincipalName (UPN) または電子メールアドレスと一致する必要があります。これにより、システム間の正確な ID 相関関係が保証されます。
スキーマ構成では、Microsoft 365 と Copilot の統合用に最適化された定義済みの従業員プロファイルプロパティのセットが使用されます。インデックス付きプロパティの完全な一覧については、スキーママッピングテーブルを参照してください。
アクティブな従業員フォーカスは、アクティブな従業員のみを含むように自動的にフィルター処理され、Microsoft 365 ディレクトリと Copilot に現在の組織構造が反映されます。

注:

BambooHR は、従業員の雇用 (または元の雇用) の日付が設定されていない従業員を非アクティブとして扱い、これらのプロファイルはインデックス作成から除外されます。

前提条件

BambooHR 開発者ポータルにアクセスし、既存の BambooHR 開発者アカウントの資格情報でサインインするか、新しい開発者アカウントがない場合は作成します。開発者ポータルはメインの BambooHR インスタンスとは別であり、BambooHR と統合される API アプリケーションの作成と管理に特に使用されることに注意してください。
開発者ポータルで、一意のアプリケーション名 ("Microsoft 365 Copilot コネクタ" やorganizationの名前など) を指定して、新しい BambooHR アプリを作成します。
[アプリの詳細] セクションで、認証中に Microsoft 365 が BambooHR と通信するために使用するリダイレクト URL を追加します。次の正確な URL をコピーして貼り付けます。 https://gcs.office.com/v1.0/admin/oauth/callback

[アプリケーションスコープ] セクションで、コネクタが BambooHR から特定の従業員データにアクセスできるようにする必要なアクセス許可を選択します。コネクタが必要なプロファイル情報を取得できるように、読み取り専用アクセス権を持つ次のスコープを選択します。

カテゴリ	必要なスコープ
クレーム	メール openid
従業員	使用人 employee:contact employee:identification employee:job employee:management employee:name employee_directory sensitive_employee:protected_info
その他	フィールド offline_access public.user
レポート	報告

[アプリの資格情報] セクションに移動して、アプリクライアント ID とアプリクライアントシークレットを取得します。これらの資格情報は、セットアップ中に BambooHR アプリケーションで Microsoft 365 コネクタを認証するために使用されます。

作業の開始

BambooHR Microsoft 365 Copilot コネクタを追加します。

1. 表示名を選択する

ユーザーが Copilot 応答で関連付けられているプロファイルを簡単に認識できるようにする表示名 (BambooHR プロファイルなど) を選択します。

2. インスタンス URL を追加する

BambooHR インスタンス URL を入力します(例: https://contoso.bamboohr.com/

3. 認証の種類を選択する

認証の種類の一覧から [OAuth 2.0] を選択し、BambooHR 開発者ポータルからクライアント ID とクライアントシークレットを入力します。 [ 承認] をクリックすると、従業員データを含む BambooHR インスタンスの管理者資格情報を使用してサインインし、必要なアクセス許可に同意する必要があります。

アクセス許可、データ包含ルール、スキーマ、クロール頻度などのその他の設定については、BambooHR のデータに最も適したものに基づいて既定値を設定します。既定値の設定は次のとおりです。

Page	Settings	既定値
ユーザー	アクセス許可注: BambooHR Copilot コネクタを介して取得されたすべてのデータは、Microsoft テナント内のすべてのユーザーに表示されます。ただし、アクセス制限の尊重など、システムの動作は変更されません。ユーザーが別のユーザーのプロファイルデータの表示をブロックされた場合、そのプロファイルデータ (BambooHR Copilot データを含む) は、ブロックされたユーザーのビューで共有または格納されません。ユーザーレベルのアクセス許可制御が実装されている場合、アクセス制限付きデータは今後の更新プログラムに含まれる予定です。	すべてのプロファイルに誰でもアクセスできます。
ID のマッピング	Microsoft Entra ID を使用してマップされたデータソース ID。
同期	増分クロール	頻度: 15 分ごとに。
同期	フルクロール	頻度: 毎日。

Schema プロパティ	説明	Microsoft 365 ユーザープロファイルスキーマのプロパティ
名	従業員の名	names->first
姓	従業員の姓	names->last
Name	従業員のフルネーム	names->displayName
電子メール	従業員の職場のメールアドレス	emails->address[type='work'] 注: EmailはエンドユーザーのMicrosoft Entra objectId に変換され、内部処理に使用されます。
誕生日	従業員の生年月日	anniversaries->date[type='birthday']
求人情報部	従業員の仕事部門 (人事など)	positions->detail->company->department
ジョブ情報部門	従業員の仕事部門 (たとえば、北米)	position->detail->company->division
従業員番号	従業員の番号	position->detail->employeeId
従業員 Eeid	BambooHR の従業員 ID	webAccounts->userId 注: 従業員の eeid は、BambooHR の特定の従業員の更新プログラムを定期的にチェックするために内部的にも使用されます。
雇用状態	従業員のステータス (たとえば、フルタイム、請負業者など)。	position->detail->employeeType
元の雇用日時	従業員の雇用日	anniversaries->date[type='originalHireDate']
雇用日時	従業員の雇用日注: 元の雇用日時が null の場合は、雇用日時のインデックスを作成します	anniversaries->date[type='originalHireDate']
ジョブ情報の役職	従業員の役職 (たとえば、上級人事管理者)	positions->detail->jobTitle
スーパーバイザ ID	従業員のマネージャー識別子	positions->manager->userId 注: スーパーバイザ ID はスーパーバイザーの電子メールを見つけるために使用され、内部処理のためにマネージャーのMicrosoft Entra objectId に変換されます。
携帯電話	従業員の職場の携帯電話	phones->number(type=mobile)
勤務先の電話番号	従業員の職場の電話	phones->number(type=work)
ジョブ情報の場所	従業員のオフィスの場所	positions->positionDetail->companyDetail->officeLocation
状態	従業員の状態 (アクティブまたは非アクティブなど)	該当なし注: 非アクティブな従業員をフィルター処理するための内部使用。BambooHR データ取得から除外されるようにします。

カスタムセットアップ

カスタムセットアップでは、ユーザー、コンテンツ、同期の既定値を編集できます。

ユーザー

BambooHR Copilot コネクタは、Everyone に表示されるデータのみをサポートします。つまり、すべてのユーザーの検索結果にインデックス付きデータが表示されます。 BambooHR Copilot コネクタでは、BambooHR プロファイルのメールアドレスが UserPrincipalName (UPN) と同じか、Microsoft Entra IDのユーザーの電子メールであるかを確認することで、データソース ID とMicrosoft Entra IDのマッピングのみがサポートされます。

コンテンツ

BambooHR Copilot コネクタでは、このタブでの新しいプロパティの追加や既存のプロパティの削除はサポートされていません。このタブには、前述したすべての既定のプロパティを含む annotationSerialized という名前のプロパティがあります。

同期

更新間隔は、データソースと BambooHR Copilot コネクタインデックスの間でデータを同期する頻度を決定します。更新間隔には、フルクロールと増分クロールの 2 種類があります。詳細については、「更新設定」を参照してください。

次の手順

接続を発行したら、管理センターの [コネクタ] セクションで状態を確認できます。更新と削除を行う方法については、「接続を監視する」をご覧ください。

問題がある場合、またはフィードバックを提供する場合は、「 Microsoft Graph サポート」を参照してください。

Last updated on 2025-11-19