Salesforce Knowledge Microsoft Graph コネクタ

2025-07-09

Salesforce Knowledge Microsoft Graph コネクタを使用すると、organizationで Salesforce Knowledge の記事にインデックスを作成できます。コネクタを構成すると、エンドユーザーは、Microsoft Copilotおよび任意の Microsoft Search クライアントから Salesforce からナレッジ記事を検索できます。

このドキュメントは、Microsoft 365 管理者、または Salesforce Knowledge Microsoft Graph コネクタを構成、実行、監視するすべてのユーザー向けです。

機能

Salesforce ナレッジの記事にインデックスを付けます。
社内のユーザーが Copilot を使用して自然言語で質問し、Salesforce の記事に基づいて回答を受け取るようにします。例:
- 払い戻しを処理する手順は何ですか?
- 優先度の高いケースのエスカレーション手順は何ですか?
- 製品保証ポリシーの最新の更新プログラムは何ですか?
Copilot のセマンティック検索を使用して、ユーザーがキーワード、個人の好み、ソーシャル接続に基づいて関連するコンテンツを検索できるようにします。

制限事項

Salesforce Knowledge コネクタでは、現在、ナレッジエンティティのアクセスのみに基づくアクセス許可がサポートされています。データカテゴリベースのアクセス許可、フィールドレベルセキュリティ (FLS)、または共有ルールはサポートされていません。
英語で記述された記事と項目のみをサポートします。
公開されたアイテムのみがインデックス付けされます。

前提条件

注:

Salesforce Knowledge Microsoft Graph コネクタのログインに使用する Salesforce アカウントが、既に Salesforce にログインしているアカウントと同じであることを確認します。

必要な Salesforce アクセス許可

Salesforce Knowledge コネクタを構成するには、次のアクセス許可が必要です。

API が有効
セットアップと構成の表示
ビューのナレッジを許可する
Knowledge エンティティの読み取りアクセス権

Salesforce Knowledge Connector の資格情報を取得する

Salesforce インスタンスに接続するには、OAuth 2.0 認証用の Salesforce インスタンス URL、クライアント ID、クライアントシークレットが必要です。次の手順では、自分または Salesforce 管理者が Salesforce アカウントからこの情報を取得する方法について説明します。

Salesforce インスタンスにログインし、[ セットアップ] に移動します。
[アプリ] -> [App Manager] に移動します。
[ 新しい接続済みアプリ] を選択します。
次のように API セクションを完了します。
- [ Oauth 設定を有効にする] チェックボックスをオンにします。
- M365 Enterprise: https://gcs.office.com/v1.0/admin/oauth/callback、M365Government の場合は、コールバック URL をとして指定します。https://gcsgcc.office.com/v1.0/admin/oauth/callback
- 必要な OAuth スコープを選択します。
  - データにアクセスして管理する (API)。
  - お客様に代わっていつでも要求を実行します (refresh_token、offline_access)。
- [ Web サーバーフローにシークレットを要求する] チェックボックスをオンにします。
- アプリを保存します。
コンシューマーキーとコンシューマーシークレットをコピーします。この情報は、Microsoft 365 管理ポータルで Salesforce Knowledge Microsoft Graph コネクタの接続設定を構成するときに、クライアント ID とクライアントシークレットとして使用されます。
Salesforce インスタンスを閉じる前に、次の手順に従って、更新トークンの有効期限が切れないようにします。
- [アプリ] -> [App Manager] に移動します。
- 作成したアプリを見つけて、右側のドロップダウンを選択します。 [管理] を選択します。
- [ ポリシーの編集] を選択します。
- 更新トークンポリシーの場合は、[ 更新トークンは失効するまで有効です] を選択します。

Microsoft 365 管理センターを使用して、Salesforce Knowledge Microsoft Graph コネクタの残りのセットアッププロセスを完了できるようになりました。

はじめに

1. 表示名

表示名は、Copilot の各引用文献を識別するために使用され、ユーザーが関連付けられているファイルまたは項目を簡単に認識するのに役立ちます。表示名は、信頼されたコンテンツも示します。表示名は、コンテンツソースフィルターとしても使用されます。このフィールドには既定値が存在しますが、organizationのユーザーが認識する名前にカスタマイズできます。

2. Salesforce ナレッジ URL

organizationの Salesforce Knowledge Instance URL を使用します。この URL は、データ取得のために Salesforce Knowledge の API サービスにアクセスして操作するために使用される特定の Web アドレスです。通常は次のようになります。 https://[COMPANY_NAME].my.salesforce.com

3. 認証の種類

Salesforce Knowledge Microsoft Graph コネクタの場合は、認証に OAuth 2.0 を使用します。

認証するには、クライアント ID とクライアントシークレットを入力します。クライアント ID は、Salesforce Knowledge API への要求を行うためにアプリケーションに割り当てられた一意の識別子です。クライアントシークレットは、Salesforce Knowledge API を使用してアプリケーションを安全に認証するためにクライアント ID と共に使用される機密キーです。

これらの設定で初めてサインインしようとすると、管理者のユーザー名とパスワードを使用して Salesforce にログインするように求めるポップアップが表示されます。

注:

ポップアップが表示されない場合は、ブラウザーでブロックされている可能性があるため、ポップアップとリダイレクトを許可する必要があります。
Graph コネクタのログインに使用されている Salesforce アカウントが、Salesforce に既にログインしているユーザーと同じであることを確認します。
ユーザーログインに、organizationに必要なすべてのオブジェクトアクセス許可があることを確認します。

4. 限定対象ユーザーにロールアウトする

ロールアウトを広範な対象ユーザーに展開する前に、Copilot やその他の Search サーフェスで検証する場合は、制限付きユーザーベースにこの接続をデプロイします。制限付きロールアウトの詳細については、「段階的なロールアウト」を参照してください。

この時点で、Salesforce Knowledge の接続を作成する準備ができました。 [作成] ボタンをクリックすると、Salesforce ナレッジアカウントから接続とインデックスの投稿を発行できます。

アクセス許可、データ包含ルール、スキーマ、クロール頻度などの他の設定の場合、既定値は Salesforce ナレッジデータ用に事前構成され、最適化されています。既定値は次のとおりです。

ユーザー	説明
アクセス許可	データソース内のコンテンツにアクセスできるユーザーのみ。
ID のマップ	Microsoft Entra ID を使用してマップされたデータソース ID。

コンテンツ	説明
プロパティの管理	既定のプロパティとそのスキーマをチェックするには、コンテンツに関するページを参照してください。

同期	説明
増分クロール	頻度: 15 分ごと
フルクロール	頻度: 毎日

これらの値のいずれかを変更するには、[ カスタムセットアップ ] オプションを選択します。

カスタムセットアップ

カスタムセットアップは、設定の既定値を編集する管理者向けです。 [カスタムセットアップ] オプションをクリックすると、他の 3 つのタブ (ユーザー、コンテンツ、同期) が表示されます。

ユーザー

アクセス許可

Salesforce ナレッジコネクタでは、このデータソースへのアクセス権を持つすべてのユーザーまたは唯一のユーザーに表示される検索アクセス許可がサポートされています。 [ すべてのユーザー] を選択すると、すべてのユーザーの検索結果にインデックス付きデータが表示されます。 [このデータソースへのアクセス権を持つユーザーのみ] を選択すると、インデックス付きデータが検索結果に表示され、アクセス権を持つユーザーが表示されます。 organizationに最適なものを選択します。

マッピング ID

Salesforce インスタンスからAccess Control Lists (ACL) を取り込むか、organizationのすべてのユーザーにこのデータソースの検索結果を表示することを許可するように選択できます。 ACL には、Microsoft Entra ID (Microsoft Entra IDから Salesforce にフェデレーションされているユーザー)、Azure AD 以外の ID (Microsoft Entra IDで対応する ID を持つネイティブ Salesforce ユーザー)、またはその両方を含めることができます。

注:

Ping ID や secureAuth などのサードパーティの ID プロバイダーを使用する場合は、ID の種類として [非Microsoft Entra] を選択する必要があります。

Salesforce インスタンスから ACL を取り込み、ID の種類に "ME 以外の ID" を選択した場合は、ID のマッピング手順については、「Microsoft Entra以外の ID をマップする」を参照してください。

Salesforce インスタンスから ACL を取り込み、ID の種類に "ME-ID" を選択した場合は、ID のマッピング手順については、「Microsoft Entra ID のマップ」を参照してください。 Salesforce Microsoft Entra SSO を設定する方法については、このチュートリアルを参照してください。

注:

アクセス許可を管理するグループへのUpdatesは、フルクロールでのみ同期されます。増分クロールでは、アクセス許可に対する更新の処理はサポートされていません。

次のビデオでは、Salesforce インスタンスに対して認証を行い、Microsoft Entra以外の ID をMicrosoft Entra ID と同期し、Salesforce 項目に適切なセキュリティ設定を適用する方法について説明します。このガイドは Salesforce CRM コネクタ専用ですが、Salesforce ナレッジコネクタにも同じ手順を適用できます。

コンテンツ

プロパティの管理

ここでは、Salesforce Knowledge データソースから使用可能なプロパティを追加または削除したり、プロパティにスキーマを割り当てたり (プロパティが検索可能、クエリ可能、取得可能、または絞り込み可能かどうかを定義する)、セマンティックラベルを変更してプロパティにエイリアスを追加したりできます。既定で選択されているプロパティを次に示します。

Source プロパティ (ADO MD)	セマンティックラベル	説明	Schema
ArticleId			クエリ、取得
ArticleNumber		記事の作成時に自動的に割り当てられる一意の番号。	クエリ、取得
ArticleType		ナレッジ記事の種類またはカテゴリ (FAQ、サポート記事、ハウツーなど)。	取り戻す
CondensedBody		記事の完全なコンテンツまたはメイン本文が含まれています	取得、検索
CreatedById			クエリ、取得、検索
CreatedByName	createdBy	最初に記事を作成したユーザー。	クエリ、取得、検索
CreatedDate	createdDateTime	アーティクルが最初に作成されたときのタイムスタンプ。	クエリ、取得
IconUrl	iconUrl		取り戻す
言語		記事が書き込まれる言語。	取り戻す
LastModifiedById			クエリ、取得、検索
LastModifiedByName	lastModifiedBy	記事を最後に更新したユーザー。	クエリ、取得、検索
LastModifiedDate	lastModifiedDateTime	記事に対する最新の更新プログラムのタイムスタンプ。	クエリ、取得
LastPublishedDate		記事が最後に公開された日付。	クエリ、取得
LastPublishedVersionId			クエリ、取得
概要		記事の内容の概要または要約。	検索
タイトル	title	記事のメイン見出しまたはタイトル。	クエリ、取得、検索
Url	url	Salesforce ナレッジの記事へのリンク。	取り戻す
UrlName		記事に対して生成された一意の URL フレンドリ名。	クエリ、取得

同期

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

トラブルシューティング

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

インデックスブラウザーでの項目の検索

インデックスブラウザーで特定のナレッジ記事を調査する場合は、まず その KnowledgeArticleId (記事のすべてのバージョンをリンクするマスター ID) が必要です。 Salesforce から取得する方法を次に示します。

URL から記事のバージョン ID を取得する: Salesforce で記事を開きます。 URL から ID をコピーします。例: /lightning/r/Knowledge__kav/kav1234567890ABC/view。ここで、 kav1234567890ABC は ID です。
開発者コンソールを開く
SOQL クエリを実行する: [クエリエディター] タブに移動し、次のクエリを実行します (ID に置き換えます)。
```
SELECT Id, KnowledgeArticleId, Title 
FROM KnowledgeArticleVersion 
WHERE Id = '<<KNOWLEDGE_URL_ID>>'
```
結果で、 KnowledgeArticleId
インデックスブラウザーでこの KnowledgeArticleId を入力して、関連するすべてのインデックス付きデータを表示します。

問題がある場合、またはフィードバックを提供する場合は、Microsoft Graph にお問い合わせください |サポート。