通过

使用应用程序中的内容建议扩充电子邮件摘要（预览版）

重要提示

[本文为预发布文档，可能会发生变化。]

当 Outlook 和 Sales 应用中的 Copilot 一起使用时，Outlook 中显示的电子邮件摘要包括从客户关系管理（CRM）系统（如 Dynamics 365 或 Salesforce CRM）中获取的销售信息。 你可以利用自己应用程序中的见解来扩展 Sales 应用程序提供的电子邮件摘要功能。

备注

此 API 将现有的电子邮件摘要技能 API（操作 ID：scp-get-email-insights）替换为新版本。

API 描述

您必须将以下 API 说明添加到操作中。 这有助于销售应用识别用于扩充功能的正确 API。

此操作将获得额外的销售见解，这些见解将在 Outlook 摘要中的 C4S 电子邮件摘要体验中显示。 操作增强了销售用 Copilot 的现有技能。

API 详细信息

  • API 名称：电子邮件摘要技能版本 2
  • Swagger 操作 ID：scp-get-email-insights-v2
  • Swagger 操作方法：post
  • 路径：<PowerAppsConnectorHostName>/api/enhanceskills/email-insights-v2

输入有效负载

此有效负载用作 API 请求的请求正文。

客户 数据类型 必需 详情 要在操作中添加的说明
resourceData 物体 可以 用于获取建议内容的资源数据。 对于数据结构，请访问可扩展性电子邮件数据模型。 此输入标识电子邮件内容，该内容是电子邮件线程、主题和其他详细信息的集合。
relatedEntities 数组 否 相关实体的数组。 对于数据结构，请转到相关实体数据模型。 此输入标识与电子邮件线程相关的 CRM 记录数组。
crmType 字符串 否 CRM 系统的类型（如果已连接）。 有效值为 Salesforce 和 Dynamics 365。 此输入指示与电子邮件线程相关的记录所在的 CRM 类型。
crmOrgUrl 字符串 否 CRM 组织 URL。 此输入指示与电子邮件线程相关的记录所在的 CRM 环境的 URL。
主要 整型 否 要提取的项目数。 此输入指示要提取的文件链接数。
跳过 整型 否 要跳过的项目数。 此输入指示获取建议的文件链接时要跳过的项目数。

扩展性电子邮件数据模型

属性 类型 详情 要在操作中添加的说明
plaintextBody 字符串 完整的电子邮件正文包括电子邮件线程的所有先前消息。 此输入以文本格式提供电子邮件线程中的所有内容。
fullHtmlBody 字符串 电子邮件正文的完整 HTML 版本，其中包含电子邮件线程的所有先前消息。 此输入以 HTML 格式提供电子邮件线程中的所有内容。
subject 字符串 电子邮件的主题。 此输入提供电子邮件的主题。
发件人 字符串 发件人的电子邮件地址。 此输入提供发件人的电子邮件地址。
接收方 String[] 收件人的电子邮件地址。 此输入提供收件人的电子邮件地址。
抄送 String[] 在电子邮件的“抄送”字段中添加的收件人的电子邮件地址。 此输入提供电子邮件的“抄送”字段中包含的所有收件人的电子邮件地址。
bcc String[] 在电子邮件的“密件抄送”字段中添加的收件人的电子邮件地址。 此输入提供在电子邮件的“密件抄送”字段中添加的所有收件人的电子邮件地址。
sentDateTime DateTimeOffset UTC 格式的电子邮件的日期和时间以及 Offset 属性。 有关详细信息，请转到 DateTimeOffset 结构（系统） 此输入提供电子邮件的时间戳。
消息ID 字符串 电子邮件的 Graph 消息 ID。 此输入提供电子邮件的邮件 ID。
conversationId 字符串 电子邮件线程的 Graph 对话 ID。 此输入提供电子邮件线程的对话 ID。
属性 类型 必需 详情 要在操作中添加的说明
entityId 字符串 可以 CRM 记录的类型，如客户或商机。 此输入提供与电子邮件线程相关的 CRM 记录的唯一标识符。
entityType 字符串 可以 用于建议内容的 CRM 记录的唯一标识符。 此输入标识 CRM 中的记录类型，该类型与电子邮件线程相关。
entitySource 字符串 否 此输入指示实体源，当前包含“connected”或空值。 此输入指示实体源类型。

输出参数

Sales 应用需要从 API 接收见解（对象）列表，并且预期每个见解都具有特定的参数。 为了确保 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 的输出映射到电子邮件摘要。

显示电子邮件摘要中合作伙伴应用的见解的屏幕截图。

图例：

  1. 见解的标题。 具有相同标题的见解会被分到一组。
  2. 见解的描述。 每个见解有一个描述。

下图中的示例显示如何在电子邮件正文中将 API 的输出映射到电子邮件摘要。

显示电子邮件正文中来自合作伙伴应用的见解的屏幕截图。

图例：

  1. 见解的标题。 具有相同标题的见解会被分到一组。
  2. 见解的说明。 每个见解有一个描述。

利用 Outlook 中的 Copilot 使用销售信息汇总电子邮件线程
使用应用程序中的数据丰富机会见解
使用应用程序中的见解扩充 CRM 记录详细信息
使用应用程序中的见解扩充 CRM 记录摘要
使用合作伙伴应用程序扩展 Microsoft 365 Copilot 中的销售额
使用应用程序中的文件链接扩充电子邮件草稿
为 Microsoft 365 Copilot 构建 Sales 扩展

  • Last updated on