アプリケーションからのファイル リンクを使用してメールの下書きを充実させる (プレビュー)

重要

• これは運用に対応したプレビュー機能です。
• 運用に対応したプレビューには 追加使用条件 が適用されます。

[この記事はプレリリース ドキュメントであり、変更されることがあります。]

Copilot for Sales を使用してメールの下書きを作成すると、メールの意図が考慮され、Salesforce または Dynamics 365 からの CRM 情報を使用して下書きが作成されます。 Copilot for Sales が提供する電子メールの下書き機能を、独自のアプリケーションからの推奨ファイルで拡張できます。

ヒント

この機能は、Outlook の Copilot for Sales サイド ウィンドウを使用して作成されたメールの下書きでのみサポートされます。

API の説明

次の API の説明をアクションに追加する必要があります。 このようにして、Copilot for Sales は、機能を充実させるために呼び出す必要のある正しい API を特定できます。

このアクションは、Outlook の C4S メール下書きに表示されるメールの会話に関連するファイルを取得します。 このアクションにより、Copilot for Sales の既存のスキルが強化されます。

API 操作

この API は、操作タイプ: POST を使用します

入力ペイロード

このペイロードは、API 要求の要求本文になります。

件名	データ型	Required	Details	アクションに追加する説明
resourceData	Object	可	推奨されたコンテンツをフェッチするために使用されるリソース データ。 データ構造については、拡張性メール データ モデルを参照してください。	この入力は、電子メール スレッド、件名、およびその他の詳細のコレクションである電子メール コンテンツを識別します。
resourceType	String	可	コンテンツの提案を取得するリソースの種類。 たとえば、「email-thread」や「teams-chat」などです。	この入力は、提案されたファイル リンクを取得するために共有されるリソースの種類 (この場合は 'email-thread') を識別します。
レコード タイプ	String	いいえ	取引先企業や営業案件などの CRM レコードの種類。	この入力により、電子メール スレッドに関連する CRM のレコードの種類が識別されます。
recordId	String	いいえ	推奨コンテンツに使用する CRM レコードの一意識別子。	この入力は、電子メール スレッドに関連する CRM レコードの一意の識別子を提供します。
crmType	String	いいえ	CRM システムの種類 (接続されている場合)。 有効な値は Salesforce と Dynamics 365 です。	この入力は、電子メール スレッドに関連するレコードが存在する CRM の種類を示します。
crmOrgUrl	String	いいえ	CRM 組織の URL です。	この入力は、電子メール スレッドに関連するレコードが存在する CRM 環境の URL を示します。
入力プロンプト	String	いいえ	メールの下書きを生成するためにユーザーが指定した、現在使用されている推奨プロンプト。 たとえば、「懸念事項への返信」や「提案の作成」などです。	この入力は、メールの下書き中にユーザーから提供されたプロンプトを示します。
上部	整数	いいえ	フェッチする品目の数。	この入力は、フェッチするファイル リンクの数を示します。
skip	整数	いいえ	スキップする項目の数。	この入力は、提案されたファイル リンクをフェッチするときにスキップする項目の数を示します。

拡張性メール データ モデル

Property	タイプ	Details	アクションに追加する説明
plaintextBody	String	完全なメール本文には、その中のメールスレッドの以前のすべてのメッセージが含まれます。	この入力は、電子メール スレッドのすべてのコンテンツをテキスト形式で提供します。
fullHtmlBody	String	メール スレッドの以前のすべてのメッセージを含むメール本文の完全な HTML バージョン。	この入力は、電子メール スレッドのすべてのコンテンツを HTML 形式で提供します。
subject	String	メールの件名。	この入力により、電子メールの件名が提供されます。
送信元	String	送信者のメール アドレス。	この入力は、送信者の電子メール アドレスを提供します。
送信先	String[]	受信者のメール アドレス。	この入力は、受信者のメールアドレスを提供します。
cc	String[]	メールの [Cc] フィールドに追加された受信者のメールアドレス。	この入力は、電子メールの [Cc] フィールドに含まれるすべての受信者の電子メール アドレスを提供します。
bcc	String[]	メールの [BCC] フィールドに追加された受信者のメールアドレス。	この入力は、電子メールの [BCC] フィールドに追加されるすべての受信者の電子メール アドレスを提供します。
sentDateTime	DateTimeOffset	電子メールの日時 (UTC 形式) と Offset プロパティ。 詳細については、DateTimeOffset Struct (システム) にアクセスしてください	この入力は、電子メールのタイムスタンプを提供します。
messageId	String	メールの Graph メッセージ Id。	この入力は、電子メールのメッセージ ID を提供します。
conversationId	String	メール スレッドの Graph 会話 Id。	この入力は、電子メール スレッドの会話 ID を提供します。

出力パラメーター

Property	データ型	Required	Details
価値	Array	可	ファイルまたはリンクのコンテンツ提案応答に対するスキーマに記述されているように定義されたファイル リンク (オブジェクト) のリスト。
hasMoreResults	ブール値	いいえ	より多くの結果が利用可能かどうかを示す値です。

ファイルまたはリンク コンテンツの提案応答のスキーマ

件名	データ型の形式	Required	Details	アクションに追加する説明
contentType	string	可	表示するコンテンツの種類。 詳細については、contentType の定義済みの値を参照してください	この出力は、電子メールの下書きに含まれるコンテンツの種類を示します。
コンテント	string	可	実際のコンテンツが含まれています。 これは、Web ページまたはファイルの URL のいずれかです。	この出力は、電子メールの下書きに含まれる実際のコンテンツを示します。 Web ページまたは URL のいずれかです。
コンテンツタイトル	string	可	ユーザーに表示される推奨コンテンツのタイトル。	この出力は、コンテンツのタイトルを示します。
contentDescription	string	可	ユーザーに表示される推奨コンテンツの説明。	この出力は、ファイルを記述するときに含めるテキストを示します。
contentIconUrl	string	いいえ	ユーザーに表示される推奨コンテンツのアイコン。 指定しない場合は、汎用アイコンが使用されます。	この出力は、コンテンツに含めるアイコンを示します。
additionalProperties	Object	いいえ	アクションが返す関連ファイル リンクの追加プロパティを示す名前と値のペアのセット。	この出力は、アクションによって返される各関連リンクの名前と値のペアとして、追加のプロパティを示します。

contentType の定義済みの値

文字列値	コンテンツのタイプ
content-file	外部ファイル (汎用)
content-web	外部 Web ページ
content-doc	Microsoft Word ドキュメント
content-pdf	Microsoft PDF ドキュメント
content-pptx	Microsoft PowerPoint プレゼンテーション
content-xlsx	Microsoft Excel スプレッドシート

例

{
  "value": [
    {
      "contentType": 0,
      "content": "https://www.bing.com",
      "contentTitle": "Purchase Contract",
      "contentDescription": "Purchase Contract Description",
      "contentIconUrl": null,
      "additionalProperties": {
        "Recipients": "Logan Edwards",
        "Sender Name": "Kenny Smith"
      }
    },
    {
      "contentType": 3,
      "content": "https://www.microsoft.com",
      "contentTitle": "Strategy Planning",
      "contentDescription": "Strategy Planning Description",
      "contentIconUrl": null,
      "additionalProperties": {
        "Recipients": "Gabriela Edwards",
        "Sender Name": "Maria Smith"
      }
    },
    {
      "contentType": 1,
      "content": "https://www.bing.com",
      "contentTitle": "Contoso Website",
      "contentDescription": "Contoso Website Description",
      "contentIconUrl": null,
      "additionalProperties": {
        "Total Views": "100",
        "Domain": "Contoso.com"
      }
    }
  ],
  "hasMoreResults": false
}

次の画像の例は、API の出力がメールの下書きにどのようにマッピングされるかを示しています。

凡例:

1. パートナー アプリからのファイル リンク。

参照

Outlook の Copilot を使用して販売情報を使用して電子メール スレッドを要約する
アプリケーションからの分析情報でメールの概要を充実させる
アプリケーションからの分析情報で重要な営業情報を充実させる
アプリケーションからの分析情報を活用して CRM レコードの詳細を充実させる
アプリケーションからの分析情報を活用して CRM レコードの概要を充実させる
Microsoft 365 Copilot for Sales をパートナー アプリケーションで拡張する
Copilot for Sales 拡張子のビルド