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

2025-06-26

重要

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

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

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 要求の要求本文になります。

件名	データ型	必須	詳細	アクションに追加する説明
リソースデータ	オブジェクト	はい	推奨されたコンテンツをフェッチするために使用されるリソースデータ。データ構造については、拡張性メールデータモデルを参照してください。	この入力は、電子メールスレッド、件名、およびその他の詳細のコレクションである電子メールコンテンツを識別します。
リソースタイプ	糸	はい	コンテンツの提案を取得するリソースの種類。たとえば、「email-thread」や「teams-chat」などです。	この入力は、提案されたファイルリンクを取得するために共有されるリソースの種類 (この場合は 'email-thread') を識別します。
レコードタイプ	糸	いいえ	取引先企業や営業案件などの CRM レコードの種類。	この入力により、電子メールスレッドに関連する CRM のレコードの種類が識別されます。
recordId	糸	いいえ	推奨コンテンツに使用する CRM レコードの一意識別子。	この入力は、電子メールスレッドに関連する 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 を提供します。

出力パラメーター

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

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

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

contentType の定義済みの値

文字列値	コンテンツのタイプ
content-file	外部ファイル (汎用)
コンテンツウェブ	外部 Web ページ
content-doc	Microsoft Word ドキュメント
content-pdf	Microsoft PDF ドキュメント
内容-PPTX	Microsoft PowerPoint プレゼンテーション
コンテンツ（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 の出力がメールの下書きにどのようにマッピングされるかを示しています。

メールの下書きにあるパートナーアプリからのファイルリンクを示すスクリーンショット。

凡例:

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

参照

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

次の方法で共有

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

API の説明

API 操作

入力ペイロード

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

出力パラメーター

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

contentType の定義済みの値

例

参照

フィードバック

その他のリソース

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

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

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