アプリケーションからの分析情報で重要な営業情報を充実させる (プレビュー)
重要
- これは運用に対応したプレビュー機能です。
- 運用に対応したプレビューには 追加使用条件 が適用されます。
[この記事はプレリリース ドキュメントであり、変更されることがあります。]
営業担当者は、Outlookで メールを読んだり作成したりしながら、Copilot for Sales を使用して、メールに関連する取引先担当者、取引先企業、営業案件に関する主要な営業情報を表示できます。 主要な営業の情報は、以下のいずれかの情報源に基づいています:
- メールに関連する営業案件
- メールに含まれる取引先担当者や営業案件から、最も関連性の高い営業案件を抽出する
Copilot for Sales が提供する主要な営業情報機能を、独自のアプリケーションの分析情報で拡張できます。
API の説明
次の API の説明をアクションに追加する必要があります。 このようにして、Copilot for Sales は、機能を充実させるために呼び出す必要のある正しい API を特定できます。
このアクションは、Outlook サイドカーの C4S 主要営業情報カードに表示される追加の Sales Insights を取得します。 このアクションにより、Copilot for Sales の既存のスキルが強化されます。
入力パラメーター
Copilot for Sales は、API に次の入力パラメータを提供するように設計されています。
| 件名 | データ型 / 形式 | Required | Details | アクションに追加する説明 |
|---|---|---|---|---|
| レコード タイプ | String | 可 | 顧客リレーションシップ管理 (CRM) のレコードの種類。 レコードには、メールに関連する取引先企業、営業案件、リード、または担当者を指定できます。 | この入力は、重要な営業情報レコードが要求される CRM 内の レコードの種類を識別します。 |
| recordId | String | 可 | CRM のレコード ID です。 | この入力は、重要な営業情報が要求される CRM レコードの一意識別子を提供します。 |
| crmType | String | いいえ | CRM システムの種類です。 有効な値は Salesforce と Dynamics 365 です。 | この入力は、重要な営業情報が要求される既存の CRM レコードの CRM のタイプを示します。 |
| crmOrgUrl | String | いいえ | CRM 組織の URL です。 | この入力は、重要な営業情報が要求される既存の CRM レコードの CRM 環境の URL を示します。 |
| 上部 | 整数 | いいえ | 取得する分析情報の数です。 | この入力は、取得する営業ハイライトの数を示します。 |
| skip | 整数 | いいえ | スキップする分析情報の数です。 | この入力は、営業情報を取得する項目の数を示します。 |
出力パラメーター
Copilot for Sales は、API から分析情報 (オブジェクト) のリストを受け取ることを想定しており、各分析情報には特定のパラメーターがあることを想定しています。 Copilot for Sales が出力を正しく解析できるように、応答構造は次の表のガイドラインに従う必要があります。
| パラメーター | データ型 | Required | Details |
|---|---|---|---|
| 価値 | Array | 可 | 分析情報のスキーマ セクションの説明に従って定義された分析情報 (オブジェクト) のリスト。 |
| hasMoreResults | ブール値 | いいえ | より多くの結果が利用可能かどうかを示す値です。 |
分析情報のためのスキーマ
| 件名 | データ型 / 形式 | Required | Details | アクションに追加する説明 |
|---|---|---|---|---|
| 肩書き | String | 可 | 分析情報引用カードのタイトルです。 パートナーの名前のみを含め、20 文字以内にする必要があります。 | この出力は、分析情報の引用カードのタイトルを示します。 |
| プロパティ | String | 可 | 営業の分析情報の説明です。 主要な営業情報ペインに箇条書きで表示され、130 文字まで入力できます。 次に例を示します: 検証: 次のステップ: タイムラインと成功基準に合わせる。 | この出力は、主要な販売情報に含まれる分析情報のテキストを示します。 |
| url | String | いいえ | パートナー アプリケーションで分析情報を開くための有効な URL。 | この出力は、分析情報の詳細を確認するための URL を示します。 |
| dateTime | DateTime | いいえ | UTC 形式でのアクティビティの日付と時刻です。 アクティビティに開始時刻と終了時刻の両方がある場合、アプリケーションはどちらの時刻を表示するかを決定する必要があります。 形式は OpenAPI の仕様に従います。 例: 2017-07-21T17:32:28Z. | この出力は、分析情報に関連付けられた時間を示します。 |
| additionalProperties | String 型の プロパティ名 と プロパティ値 の値を持つオブジェクト | いいえ | アクションが返す関連する分析情報の追加プロパティを示す、名前と値のペアのセットです。 この情報は、ユーザーが主要な営業情報ペインで分析情報を選択すると、ポップアップ カードに表示されます。 | この出力は、アクションによって返された各関連する分析情報の名前‐値のペアとして追加のプロパティを示します。 |
例
{
"value": [
{
"title": "Contract signed",
"description": "Kenny Smith sent Renewal Contract on 04/23/2023 related to 50 Cafe A-100 Automatic",
"dateTime": "2023-09-07T03:42:35.4662309Z",
"url": https://contosohub.com,
"additionalProperties": {
"Contract name": "Renewal contract for Fourth Coffee",
"Signed by": "Alberto Burgos, Tony Benis",
"Signed": "9/7/23",
"Related Opportunity": "50 CafeA-100 Automatic"
}
}
],
"hasMoreResults": false
}
次の画像の例は、API の出力がどのように主要な営業情報にマッピングされるかを示しています。
凡例:
- パートナー アプリケーションからの分析情報を示すセクションです。 セクション タイトルは、Microsoft Power Platform コネクタの名前から派生します。
- API レスポンスからの分析情報の説明です。
- 分析情報の詳細を表示するために選択できる引用番号です。
- 分析情報の詳細を示す引用カードです。
- 分析情報のアイコンとタイトル。 アイコンは Microsoft Power Platform コネクタのメタデータから取得されます。 タイトルは、API 応答からの分析情報のタイトルです。
- API 応答からの分析情報の追加プロパティです。
- パートナーのアプリケーション名。 表示される名前は Microsoft Power Platform コネクターの名前です。
- パートナー アプリケーションで分析情報の詳細を表示するために選択できるリンクです。 これは、API 応答の分析情報の URL に基づいています。
関連情報
Copilot for Sales で重要な販売情報を表示する
アプリケーションからの分析情報でメールの概要を充実させる
アプリケーションからのファイル リンクを使用してメールの下書きを充実させる
アプリケーションからの分析情報を活用して CRM レコードの詳細を充実させる
アプリケーションからの分析情報を活用して CRM レコードの概要を充実させる
Microsoft 365 Copilot for Sales をパートナー アプリケーションで拡張する
Copilot for Sales 拡張子のビルド