アプリケーションからの分析情報でメールサマリーを強化する (プレビュー)
重要
- これは運用に対応したプレビュー機能です。
- 運用に対応したプレビューには 追加使用条件 が適用されます。
[この記事はプレリリース ドキュメントであり、変更されることがあります。]
Outlook の Copilot と Copilot for Sales を併用すると、Outlook に表示されるメールサマリーには、Dynamics 365 や Salesforce CRM などの顧客関係管理 (CRM) システムから取得した営業情報が含まれます。 Copilot for Sales が提供するメール要約機能を、独自のアプリケーションの分析情報で拡張できます。
API の説明
次の API の説明をアクションに追加する必要があります。 このようにして、Copilot for Sales は、機能を充実させるために呼び出す必要のある正しい API を特定できます。
このアクションは、C4S メール サマリー エクスペリエンス内の Outlook のサマリーに表示される追加の 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 の種類を示します。 |
| crmOrgUrl | String | いいえ | CRM 組織の URL です。 | この入力は、既存の要約されたメールに関連する CRM 環境の URL を示します。 |
| emailContacts | String | 可 | メールアドレスのカンマ区切りリスト (kenny@contoso.com,logan@contoso.com など) です。 |
この入力は、現在のメール スレッド内のすべての関連する参加者のメールのリストを示します。 |
| 上 | 整数 | いいえ | 取得する分析情報の数です。 | この入力は、取得する分析情報の数を示します。 |
| Skip | 整数 | いいえ | スキップする分析情報の数です。 | この入力は、分析情報を取得する項目の数を示します。 |
出力パラメーター
Copilot for Sales は、API から分析情報 (オブジェクト) のリストを受け取ることを想定しており、各分析情報には特定のパラメーターがあることを想定しています。 Copilot for Sales が出力を正しく解析できるように、応答構造は次の表のガイドラインに従う必要があります。
| パラメーター | データ型 | Required | Details |
|---|---|---|---|
| 価値 | Array | 可 | 分析情報のスキーマ セクションの説明に従って定義された分析情報 (オブジェクト) のリスト。 注: このパラメーターには分析情報のリストが含まれますが、メールのエンリッチメント サマリーには最初の分析情報のみが使用されます。 |
| hasMoreResults | ブール値 | いいえ | より多くの結果が利用可能かどうかを示す値です。 |
分析情報のためのスキーマ
| 件名 | データ型 / 形式 | Required | Details | アクションに追加する説明 |
|---|---|---|---|---|
| 肩書き | 最大 20 文字の文字列 | 可 | 分析情報のタイトルです。 | この出力はパートナー セクションのタイトルを示し、パートナーの名前のみを含める必要があります。 |
| プロパティ | String | 可 | ユーザーに届けられる分析情報は、同僚である Mona Kane、Ray Tanaka、Daniela Smith が以前彼らと仕事をしたときのものです。 | この出力は、メールの概要に含めるテキストを示します。 |
ヒント
電子メールの要約機能とレコードの要約機能を拡張するための API 要件は似ているように見えますが、コネクター内の別のアクションとして追加する必要があります。
例
{
"value": [
{
"title": "From Contoso Customer Insights",
"description": "Your colleagues Mona Kane, Ray Tanaka, and Daniela Smith have worked with them before."
}
],
"hasMoreResults": false
}
次の画像の例は、API の出力が電子メールの要約にどのようにマッピングされるかを示しています。
凡例:
- 分析情報のタイトル。 同じタイトルの分析情報はグループ化されます。
- 分析情報の説明。 各分析情報には説明がひとつ付いています。
関連情報
Outlook の Copilot を使用して販売情報を使用して電子メール スレッドを要約する
アプリケーションからの分析情報で重要な営業情報を充実させる
アプリケーションからの分析情報を活用して CRM レコードの詳細を充実させる
アプリケーションからの分析情報を活用して CRM レコードの概要を充実させる
Microsoft 365 Copilot for Sales をパートナー アプリケーションで拡張する
アプリケーションからのファイル リンクを使用してメールの下書きを充実させる
Copilot for Sales 拡張子のビルド