アプリケーションからの分析情報を活用して CRM レコードの詳細を充実させる (プレビュー)
重要
- これは運用に対応したプレビュー機能です。
- 運用に対応したプレビューには 追加使用条件 が適用されます。
[この記事はプレリリース ドキュメントであり、変更されることがあります。]
営業担当者は、保存された取引先担当者の詳細を、取引先担当者や営業案件などの関連レコードと一緒に表示することができます。 Copilot for Sales が提供する顧客関係管理 (CRM) レコードの詳細機能を、独自のアプリケーションからの分析情報で拡張できます。
API の説明
次の API の説明をアクションに追加する必要があります。 このようにして、Copilot for Sales は、機能を充実させるために呼び出す必要のある正しい API を特定できます。
このアクションは、CRM レコードに関連するレコードを取得します。 このアクションにより、Copilot for Sales の既存のスキルが強化されます。
入力パラメーター
Copilot for Sales は、API に次の入力パラメータを提供するように設計されています。
| 件名 | データ型 / 形式 | Required | Details | アクションに追加する説明 |
|---|---|---|---|---|
| レコード タイプ | String | 可 | 関連レコードが要求される CRM のエンティティまたはオブジェクトのタイプ。 値には、ローカライズ可能な表示名ではなく、エンティティまたはオブジェクト タイプの言語に依存しない一意の名前が含まれます。 例としては 取引先企業 と 営業案件 が含まれます。 | この入力は、関連レコードが要求される CRM 内の レコードの種類 を識別します。 |
| recordId | String | 可 | CRM レコードの一意識別子です。 | この入力は、関連レコードが要求される CRM レコードの一意識別子を提供します。 |
| 上部 | 整数 | いいえ | 取得するアクティビティの数です。 | この入力は、取得する関連レコードの数を示します。 |
| skip | 整数 | いいえ | スキップするアクティビティの数です。 | この入力は、関連レコードを取得する時にレコードの数を示します。 |
| crmType | String | いいえ | CRM システムの種類です。 有効な値は Dynamics 365 と Salesforce です。 | この入力は、関連レコードが取得される CRM のタイプを示します。 |
| crmOrgUrl | String | いいえ | CRM 組織のホスト名 ( contoso.crm.dynamics.com など)。 | この入力は、関連レコードが取得される CRM 環境の URL を示します。 |
ヒント
この拡張ポイントは、Outlook サイドカーで最大 5 つのコネクター拡張機能からの分析情報のレンダリングをサポートします。
出力パラメーター
Copilot for Sales は、API から分析情報 (オブジェクト) のリストを受け取ることを想定しており、各分析情報には特定のパラメーターがあることを想定しています。 Copilot for Sales が出力を正しく解析できるように、応答構造は次の表のガイドラインに従う必要があります。
| パラメーター | データ型 | Required | Details |
|---|---|---|---|
| 価値 | Array | 可 | 分析情報のスキーマ セクションの説明に従って定義された分析情報 (オブジェクト) のリスト。 |
| hasMoreResults | ブール値 | いいえ | より多くの結果が利用可能かどうかを示す値です。 |
分析情報のためのスキーマ
| 件名 | データ型 / 形式 | Required | Details | アクションに追加する説明 |
|---|---|---|---|---|
| recordId | String | 可 | レコードの一意識別子。 | この出力は、アクションによって返される各関連レコードを一意に識別します。 |
| recordTypeDisplayName | String | 可 | レコードの種類の表示名 (Contracts など)。 Accept-Language ヘッダーで指定された言語でローカライズする必要があります。 |
この出力は、アクションによって返された各関連レコードの レコードの種類 の 表示名 を示します。 |
| recordTypePluralDisplayName | String | 可 | Contractsなど、レコード タイプの複数形の表示名です。 Accept-Language ヘッダーで指定された言語でローカライズする必要があります。 |
この出力は、アクションによって返された各関連レコードの レコードの種類の複数の表示名 を示します。 |
| レコード タイプ | String | 可 | レコードの種類のシステム名 (Contracts など)。 | この出力は、アクションによって返された各関連レコードの表示名を示します。 |
| recordTitle | String | 可 | レコードの種類の表示名 (Contoso 2023 新規契約 など)。 | この出力は、アクションによって返された各関連レコードのタイトルを示します。 |
| url | String | いいえ | パートナー アプリケーションでレコードを開くための有効な URL です。 | この出力は、アクションによって返された各関連レコードの URL を示します。 |
| additionalProperties | String 型の プロパティ名 と プロパティ値 の値を持つオブジェクト | いいえ | 詳細ビューに表示される追加プロパティです。 プロパティ名と値は、 { |
この出力は、アクションによって返された各関連レコードの名前‐値のペアとして追加のプロパティを示します。 |
例
{
"value": [
{
"recordId": "ID1",
"recordTypeDisplayName": "Contract",
"recordTitle": "50 Cafe A-100 Automatic Renewal Contract",
"recordTypePluralDisplayName": "Documents",
"recordType": "contract",
"url": "https://contosohub.com/contract/id1",
"additionalProperties": {
"Status": "Signed",
"Date": "9/7/23",
"Signed by": "Alberto Burgos, Tony [last name]"
}
},
{
"recordId": "ID2",
"recordTypeDisplayName": "Contract",
"recordTitle": "ABC Company 2023 Renewal Contract",
"recordTypePluralDisplayName": "Documents",
"recordType": "contract",
"url": "https://contosohub.com/contract/id2",
"additionalProperties": {
"Status": "Delivered",
"Date": "9/3/23",
"Signed by": "Alberto Burgos"
}
}
],
"hasMoreResults": false
}
次の画像の例は、API の出力がどのように関連レコードにマッピングされるかを示しています。
凡例:
- パートナー アプリケーションの関連レコードを表示するカード。
- カードのアイコンとタイトル。 アイコンは Microsoft Power Platform コネクタのメタデータから取得されます。 タイトルは Microsoft Power Platform コネクタの名前です。
- API 応答の関連レコードのタイトルです。 API 応答からの 2 つの追加プロパティは、各関連レコードのキー フィールドとしてレンダリングされます。
- レコードへのリンクをコピーするか、パートナーアプリケーションでレコードの詳細を表示するために使用できる「その他のアクション」ボタン。 リンクは、API 応答の関連レコードの URL に基づいています。
- API 応答からの関連レコードの追加プロパティです。
関連情報
レコードの詳細の表示
アプリケーションからの分析情報でメールの概要を充実させる
アプリケーションからのファイル リンクを使用してメールの下書きを充実させる
アプリケーションからの分析情報で重要な営業情報を充実させる
アプリケーションからの分析情報を活用して CRM レコードの概要を充実させる
Microsoft 365 Copilot for Sales をパートナー アプリケーションで拡張する
Copilot for Sales 拡張子のビルド