重要
- これは運用に対応したプレビュー機能です。
- 運用に対応したプレビューには 追加使用条件 が適用されます。
[この記事はプレリリース ドキュメントであり、変更されることがあります。]
Outlook の Copilot と Sales アプリを一緒に使用すると、Outlook に表示される電子メールの概要には、Dynamics 365 や Salesforce CRM などの顧客関係管理 (CRM) システムから提供される販売情報が含まれます。 Sales アプリが独自のアプリケーションからの分析情報を提供する電子メールの概要機能を拡張できます。
注意
この API は、既存の メール要約スキル API (操作 ID: scp-get-email-insights) を新しいバージョンに置き換えます。
API の説明
次の API の説明をアクションに追加する必要があります。 これにより、Sales アプリは、機能を強化するために呼び出す適切な API を識別できます。
このアクションは、C4S メール サマリー エクスペリエンス内の Outlook のサマリーに表示される追加の Sales Insights を取得します。 このアクションにより、Copilot for Sales の既存のスキルが強化されます。
API の詳細
- API 名: メール要約スキル バージョン 2
- Swagger 操作 ID: scp-get-email-insights-v2
- Swagger 操作方法: 投稿
-
パス:
<PowerAppsConnectorHostName>/api/enhanceskills/email-insights-v2
入力ペイロード
このペイロードは、API 要求の要求本文になります。
| 件名 | データ型 | 必須 | 詳細 | アクションに追加する説明 |
|---|---|---|---|---|
| リソースデータ | オブジェクト | はい | 推奨されたコンテンツをフェッチするために使用されるリソース データ。 データ構造については、拡張性メール データ モデルを参照してください。 | この入力は、電子メール スレッド、件名、およびその他の詳細のコレクションである電子メール コンテンツを識別します。 |
| 関連エンティティ | Array | いいえ | 関連エンティティの配列。 データ構造については、関連エンティティ データ モデルを参照してください。 | この入力は、メールスレッドに関連する CRM レコードの配列を識別します。 |
| crmType | 糸 | いいえ | CRM システムの種類 (接続されている場合)。 有効な値は Salesforce と Dynamics 365 です。 | この入力は、電子メール スレッドに関連するレコードが存在する CRM の種類を示します。 |
| crmOrgUrl | 糸 | いいえ | CRM 組織の URL です。 | この入力は、電子メール スレッドに関連するレコードが存在する CRM 環境の URL を示します。 |
| 上部 | 整数 | いいえ | フェッチする品目の数。 | この入力は、フェッチするファイル リンクの数を示します。 |
| スキップ | 整数 | いいえ | スキップする項目の数。 | この入力は、提案されたファイル リンクをフェッチするときにスキップする項目の数を示します。 |
拡張性メール データ モデル
| プロパティ | タイプ | 詳細 | アクションに追加する説明 |
|---|---|---|---|
| plaintextBody | 糸 | 完全なメール本文には、その中のメールスレッドの以前のすべてのメッセージが含まれます。 | この入力は、電子メール スレッドのすべてのコンテンツをテキスト形式で提供します。 |
| fullHtmlBody | 糸 | メール スレッドの以前のすべてのメッセージを含むメール本文の完全な HTML バージョン。 | この入力は、電子メール スレッドのすべてのコンテンツを HTML 形式で提供します。 |
| subject | 糸 | メールの件名。 | この入力により、電子メールの件名が提供されます。 |
| 送信元 | 糸 | 送信者のメール アドレス。 | この入力は、送信者の電子メール アドレスを提供します。 |
| 送信先 | 文字列[] | 受信者のメール アドレス。 | この入力は、受信者のメールアドレスを提供します。 |
| cc | 文字列[] | メールの Cc フィールドに追加された受信者のメールアドレスです。 | この入力は、電子メールの [Cc] フィールドに含まれるすべての受信者の電子メール アドレスを提供します。 |
| bcc | 文字列[] | メールの Bcc フィールドに追加された受信者のメールアドレスです。 | この入力は、電子メールの [BCC] フィールドに追加されるすべての受信者の電子メール アドレスを提供します。 |
| 送信日時 | DateTimeOffset | 電子メールの日時 (UTC 形式) と Offset プロパティ。 詳細については、DateTimeOffset Struct (システム) にアクセスしてください | この入力は、電子メールのタイムスタンプを提供します。 |
| メッセージID | 糸 | メールの Graph メッセージ Id。 | この入力は、電子メールのメッセージ ID を提供します。 |
| conversationId | 糸 | メール スレッドの Graph 会話 Id。 | この入力は、電子メール スレッドの会話 ID を提供します。 |
関連するエンティティ データ モデル
| プロパティ | タイプ | 必須 | 詳細 | アクションに追加する説明 |
|---|---|---|---|---|
| entityId | 糸 | はい | 取引先企業や営業案件などの CRM レコードの種類。 | この入力は、電子メール スレッドに関連する CRM レコードの一意の識別子を提供します。 |
| entityType | 糸 | はい | 推奨コンテンツに使用する CRM レコードの一意識別子。 | この入力により、電子メール スレッドに関連する CRM のレコードの種類が識別されます。 |
| entitySource | 糸 | いいえ | この入力は、エンティティのソースを示し、現在は 「接続済み」 または空の値を含みます。 | この入力は、エンティティのソース タイプを示します。 |
出力パラメーター
Sales アプリは API から分析情報 (オブジェクト) の一覧を受け取ると想定しており、各分析情報には特定のパラメーターがあることを想定しています。 Sales アプリが出力を正しく解析できるようにするには、応答構造が次の表のガイドラインに従っている必要があります。
| パラメーター | データ型 | 必須 | 詳細 |
|---|---|---|---|
| 価値 | Array | はい | 分析情報のスキーマ セクションの説明に従って定義された分析情報 (オブジェクト) のリスト。 注: このパラメーターには分析情報の一覧が含まれていますが、Outlook キャンバス エクスペリエンスの電子メール強化の概要で使用されるのは最初の分析情報のみです。 |
| hasMoreResults | ブール値 | いいえ | より多くの結果が利用可能かどうかを示す値です。 |
分析情報のためのスキーマ
| 件名 | データ型 / 形式 | 必須 | 詳細 | アクションに追加する説明 |
|---|---|---|---|---|
| 分析情報 | 糸 | はい | ユーザーに届けられる分析情報は、同僚である Mona Kane、Ray Tanaka、Daniela Smith が以前彼らと仕事をしたときのものです。 | この出力は、メールの概要に含めるテキストを示します。 |
例
{
"value": [
{
"insight": "Your colleagues Mona Kane, Ray Tanaka and Daniela Smith have worked with them before."
},
{
"insight": "The email was opened three times in the last month."
}
],
"hasMoreResults": false
}
次の画像の例は、API の出力がサイド ペインの電子メール要約にどのようにマッピングされるかを示しています。
凡例:
- 分析情報のタイトル。 同じタイトルの分析情報はグループ化されます。
- 分析情報の説明。 各分析情報には説明がひとつ付いています。
次の画像の例では、API の出力がメール本文のメール要約にどのようにマッピングされるかを示しています。
凡例:
- 分析情報のタイトル。 同じタイトルの分析情報はグループ化されます。
- 分析情報の説明。 各分析情報には説明がひとつ付いています。
関連情報
Outlook の Copilot を使用して販売情報を使用して電子メール スレッドを要約する
アプリケーションからのデータを使用して営業案件の分析情報を強化する
アプリケーションからの分析情報を活用して CRM レコードの詳細を充実させる
アプリケーションからの分析情報を活用して CRM レコードの概要を充実させる
パートナー アプリケーションを使用して Microsoft 365 Copilot の売上を拡張する
アプリケーションからのファイル リンクを使用してメールの下書きを強化する
Microsoft 365 Copilot で Sales の拡張機能をビルドする