重要
- これは運用に対応したプレビュー機能です。
- 運用に対応したプレビューには 追加使用条件 が適用されます。
[この記事はプレリリース ドキュメントであり、変更されることがあります。]
Outlook の Copilot と Copilot for Sales を併用すると、Outlook に表示されるメールサマリーには、Dynamics 365 や Salesforce CRM などの顧客関係管理 (CRM) システムから取得した営業情報が含まれます。 Copilot for Sales が提供するメール要約機能を、独自のアプリケーションの分析情報で拡張できます。
注意
この API は、既存の メール要約スキル API (操作 ID: scp-get-email-insights) を新しいバージョンに置き換えます。
API の説明
次の API の説明をアクションに追加する必要があります。 これは、Copilot for 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 要求の要求本文になります。
件名 | データ型 | 必須 | 詳細 | アクションに追加する説明 |
---|---|---|---|---|
リソースデータ | オブジェクト | はい | 推奨されたコンテンツをフェッチするために使用されるリソース データ。 データ構造については、拡張性メール データ モデルを参照してください。 | この入力は、電子メール スレッド、件名、およびその他の詳細のコレクションである電子メール コンテンツを識別します。 |
関連エンティティ | 配列 | いいえ | 関連するエンティティの配列。 データ構造については、関連エンティティ データ モデルを参照してください。 | この入力は、電子メール スレッドに関連する CRM レコードの配列を識別します。 |
crmType | 糸 | いいえ | CRM システムの種類 (接続されている場合)。 有効な値は Salesforce と Dynamics 365 です。 | この入力は、電子メール スレッドに関連するレコードが存在する CRM の種類を示します。 |
crmOrgUrl | 糸 | いいえ | CRM 組織の URL です。 | この入力は、電子メール スレッドに関連するレコードが存在する CRM 環境の URL を示します。 |
上部 | 整数 | いいえ | フェッチする品目の数。 | この入力は、フェッチするファイル リンクの数を示します。 |
スキップ | 整数 | いいえ | スキップする項目の数。 | この入力は、提案されたファイル リンクをフェッチするときにスキップする項目の数を示します。 |
拡張性メール データ モデル
プロパティ | タイプ | 詳細 | アクションに追加する説明 |
---|---|---|---|
plaintextBody | 糸 | 完全なメール本文には、その中のメールスレッドの以前のすべてのメッセージが含まれます。 | この入力は、電子メール スレッドのすべてのコンテンツをテキスト形式で提供します。 |
fullHtmlBody | 糸 | メール スレッドの以前のすべてのメッセージを含むメール本文の完全な HTML バージョン。 | この入力は、電子メール スレッドのすべてのコンテンツを HTML 形式で提供します。 |
件名 | 糸 | メールの件名。 | この入力により、電子メールの件名が提供されます。 |
送信元 | 糸 | 送信者のメール アドレス。 | この入力は、送信者の電子メール アドレスを提供します。 |
送信先 | 文字列[] | 受信者のメール アドレス。 | この入力は、受信者のメールアドレスを提供します。 |
cc | 文字列[] | メールの [Cc] フィールドに追加された受信者のメールアドレス。 | この入力は、電子メールの [Cc] フィールドに含まれるすべての受信者の電子メール アドレスを提供します。 |
bcc | 文字列[] | メールの [BCC] フィールドに追加された受信者のメール アドレス。 | この入力は、電子メールの [BCC] フィールドに追加されるすべての受信者の電子メール アドレスを提供します。 |
送信日時 | DateTimeOffset (日付と時刻のオフセット) | 電子メールの日時 (UTC 形式) と Offset プロパティ。 詳細については、DateTimeOffset Struct (システム) にアクセスしてください | この入力は、電子メールのタイムスタンプを提供します。 |
メッセージID | 糸 | メールの Graph メッセージ Id。 | この入力は、電子メールのメッセージ ID を提供します。 |
conversationId | 糸 | メール スレッドの Graph 会話 Id。 | この入力は、電子メール スレッドの会話 ID を提供します。 |
関連するエンティティ データ モデル
プロパティ | タイプ | 必須 | 詳細 | アクションに追加する説明 |
---|---|---|---|---|
entityId | 糸 | はい | 取引先企業や営業案件などの CRM レコードの種類。 | この入力は、電子メール スレッドに関連する CRM レコードの一意の識別子を提供します。 |
エンティティタイプ | 糸 | はい | 推奨コンテンツに使用する CRM レコードの一意識別子。 | この入力により、電子メール スレッドに関連する CRM のレコードの種類が識別されます。 |
entitySource | 糸 | いいえ | この入力はエンティティ ソースを示し、現在 "接続済み" または空の値が含まれています。 | この入力は、エンティティ ソースの種類を示します。 |
出力パラメーター
Copilot for Sales は、API から分析情報 (オブジェクト) のリストを受け取ることを想定しており、各分析情報には特定のパラメーターがあることを想定しています。 Copilot for Sales が出力を正しく解析できるように、応答構造は次の表のガイドラインに従う必要があります。
パラメーター | データ型 | 必須 | 詳細 |
---|---|---|---|
価値 | 配列 | はい | 分析情報のスキーマ セクションの説明に従って定義された分析情報 (オブジェクト) のリスト。 注: このパラメーターには分析情報の一覧が含まれていますが、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 for Sales をパートナー アプリケーションで拡張する
アプリケーションからのファイル リンクを使用してメールの下書きを充実させる
Copilot for Sales 拡張子のビルド