使用应用程序中的文件链接扩充电子邮件草稿（预览版）

项目
12/27/2024

重要提示

这是生产就绪预览功能。
生产就绪预览需要满足补充使用条款。

[本文是预发行文档，可能会有所更改。]

当您使用销售用 Copilot 起草电子邮件时，它会考虑电子邮件的意图，并使用来自 Salesforce 或 Dynamics 365 的 CRM 信息来创建草稿。您可以扩展销售用 Copilot 提供的电子邮件起草功能，其中包含您自己的应用程序中的推荐文件。

备注

只有使用 Outlook 中的销售用 Copilot 侧窗格创建的电子邮件草稿才支持此功能。

API 描述

您必须将以下 API 说明添加到操作中。这样，销售用 Copilot 可以识别必须调用来扩充功能的正确 API。

此操作将获取与电子邮件对话相关的文件，这些文件将显示在 Outlook 的 C4S 电子邮件草稿中。操作增强了销售用 Copilot 的现有技能。

输入有效负载

客户	数据类型	必需	详情	要在操作中添加的说明
resourceData	Object	可以	用于获取建议内容的资源数据。对于数据结构，请转到可扩展性电子邮件数据模型。	此输入标识电子邮件内容，该内容是电子邮件线程、主题和其他详细信息的集合。
resourceType	String	可以	要获取其内容建议的资源类型。例如，“电子邮件线程”或“团队聊天”。	此输入标识用于获取建议文件链接的共享资源类型，在本例中为“电子邮件线程”。
recordType	String	不可以	CRM 记录的类型，如客户或商机。	此输入标识 CRM 中的记录类型，该类型与电子邮件线程相关。
recordId	String	不可以	用于建议内容的 CRM 记录的唯一标识符。	此输入提供与电子邮件线程相关的 CRM 记录的唯一标识符。
crmType	String	不可以	CRM 系统的类型（如果已连接）。有效值为 Salesforce 和 Dynamics 365。	此输入指示与电子邮件线程相关的记录所在的 CRM 类型。
crmOrgUrl	String	不可以	CRM 组织 URL。	此输入指示与电子邮件线程相关的记录所在的 CRM 环境的 URL。
输入提示	String	不可以	用户为生成电子邮件草稿而给出的当前使用的建议提示。例如，“回复疑虑”或“提出建议”。	此输入指示用户在起草电子邮件时提供的提示。
主要	整型	不可以	要提取的项目数。	此输入指示要提取的文件链接数。
skip	整型	不可以	要跳过的项目数。	此输入指示获取建议的文件链接时要跳过的项目数。

扩展性电子邮件数据模型

属性	类型	详情	要在操作中添加的说明
明文正文	String	完整的电子邮件正文包括电子邮件线程的所有先前消息。	此输入以文本格式提供电子邮件线程中的所有内容。
fullHtmlBody	String	电子邮件正文的完整 HTML 版本，其中包含电子邮件线程的所有先前消息。	此输入以 HTML 格式提供电子邮件线程中的所有内容。
subject	String	电子邮件的主题。	此输入提供电子邮件的主题。
发件人	String	发件人的电子邮件地址。	此输入提供发件人的电子邮件地址。
接收方	String[]	收件人的电子邮件地址。	此输入提供收件人的电子邮件地址。
抄送	String[]	在电子邮件的“抄送”字段中添加的收件人的电子邮件地址。	此输入提供电子邮件的“抄送”字段中包含的所有收件人的电子邮件地址。
bcc	String[]	在电子邮件的“密件抄送”字段中添加的收件人的电子邮件地址。	此输入提供在电子邮件的“密件抄送”字段中添加的所有收件人的电子邮件地址。
sentDateTime	DateTimeOffset	UTC 格式的电子邮件的日期和时间以及 Offset 属性。有关详细信息，请转到 DateTimeOffset 结构（System）	此输入提供电子邮件的时间戳。
messageId	String	电子邮件的 Graph 消息 ID。	此输入提供电子邮件的邮件 ID。
conversationId	String	电子邮件线程的 Graph 对话 ID。	此输入提供电子邮件线程的对话 ID。

输出参数

属性	数据类型	必需	详情
value	数组	可以	如“文件或链接内容建议响应的架构”中所述的文件链接（对象）列表。
hasMoreResults	布尔型	不可以	指示是否有更多可用结果的值。

文件或链接内容建议响应的架构

客户	数据类型格式	必需	详情	要在操作中添加的说明
contentType	string	可以	要显示的内容类型。有关更多信息，请转到 contentType 的预定义值	此输出指示电子邮件草稿中包含的内容类型。
内容	string	可以	包括实际内容。它可以是网页或文件的 URL。	此输出指示电子邮件草稿中包含的实际内容。它可以是网页或 URL。
内容标题	string	可以	向用户显示的建议内容的标题。	此输出指示内容的标题。
contentDescription	string	可以	向用户显示的建议内容的说明。	此输出指示描述文件时要包含的文本。
内容图标 Url	string	不可以	向用户显示的建议内容的图标。如果未提供，则使用通用图标。	此输出指示内容要包含的图标。
additionalProperties	Object	不可以	一组名称/值对，指示操作返回的相关文件链接的其他属性。	此输出将其他属性指示为操作返回的每个相关链接的名称/值对。

contentType 的预定义值

字符串值	内容类型
content-file	外部文件（通用）
content-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 的输出映射到电子邮件草稿。

电子邮件草稿中显示来自合作伙伴应用的文件链接的屏幕截图。

图例：

来自合作伙伴应用的文件链接。

另请参见

利用 Outlook 中的 Copilot 使用销售信息汇总电子邮件线程
 使用应用程序中的见解扩充电子邮件摘要
 使用应用程序中的见解扩充关键销售信息
 使用应用程序中的见解扩充 CRM 记录详细信息
 使用应用程序中的见解扩充 CRM 记录摘要
 使用合作伙伴应用程序扩展销售用 Microsoft 365 销售用 Copilot
构建销售用 Copilot 扩展

通过