使用应用程序中的见解扩充关键销售信息（预览）
重要提示
- 这是生产就绪预览功能。
- 生产就绪预览需要满足补充使用条款。
[本文为预发布文档，可能会发生变化。]
在 Outlook 中阅读和撰写电子邮件时，销售人员可以使用销售用 Copilot 查看与电子邮件相关的联系人、客户和商机的关键销售信息。 关键销售信息基于以下来源之一：
- 与电子邮件关联的商机
- 最相关的商机，基于电子邮件中的联系人和客户
您可以使用来自您自己的应用程序的见解扩展销售用 Copilot 提供的关键销售信息功能。
API 描述
您必须将以下 API 说明添加到操作中。 这样，销售用 Copilot 可以识别必须调用来扩充功能的正确 API。
此操作将获取其他销售见解，这些见解将显示在 Outlook 挎斗的 C4S 关键销售信息卡中。 操作增强了销售用 Copilot 的现有技能。
API 运算
此 API 使用运算类型：GET
输入参数
销售用 Copilot 设计为向您的 API 提供以下输入参数。
| 客户 | 数据类型/格式 | 必需 | 详情 | 要在操作中添加的说明 |
|---|---|---|---|---|
| recordType | String | 可以 | 客户关系管理 (CRM) 中的记录类型。 记录可以指定与电子邮件相关的客户、商机、潜在顾客或联系人。 | 此输入标识 CRM 中为其请求关键销售信息的记录类型。 |
| recordId | String | 可以 | CRM 中的记录 ID。 | 此输入提供为其请求关键销售信息的 CRM 记录的唯一标识符。 |
| crmType | String | 不可以 | CRM 系统的类型。 有效值为 Salesforce 和 Dynamics 365。 | 此输入指示为其请求关键销售信息的 CRM 记录所在的 CRM 类型。 |
| crmOrgUrl | String | 不可以 | CRM 组织 URL。 | 此输入指示为其请求关键销售信息的 CRM 记录所在的 CRM 环境的 URL。 |
| 主要 | 整型 | 不可以 | 要提取的见解数。 | 此输入指示要提取的销售亮点数量。 |
| skip | 整型 | 不可以 | 要跳过的见解数。 | 此输入指示提取销售亮点时要跳过的项目数。 |
输出参数
销售用 Copilot 预期会从您的 API 收到见解（对象）列表，并预期每个见解都有特定的参数。 为确保销售用 Copilot 能够正确分析输出，响应结构必须符合下表中的准则。
| 参数 | 数据类型 | 必需 | 详情 |
|---|---|---|---|
| value | 数组 | 可以 | 见解（对象）列表，按见解架构一节描述的方法定义。 |
| hasMoreResults | 布尔型 | 不可以 | 指示是否有更多可用结果的值。 |
见解架构
| 客户 | 数据类型/格式 | 必需 | 详情 | 要在操作中添加的说明 |
|---|---|---|---|---|
| 职务 | String | 可以 | 销售见解引文卡的标题。 应仅包含合作伙伴的名称，最多可以包含 20 个字符。 | 此输出指示见解的引文卡标题。 |
| description | String | 可以 | 销售见解的说明。 在关键销售信息窗格中显示为要点，最多可以包含 130 个字符。 这里是一个示例：验证：后续步骤：与时间线和成功标准保持一致。 | 此输出指示要包含在关键销售信息中的见解的文本。 |
| url | String | No | 用于在合作伙伴应用程序中打开见解的有效 URL。 | 此输出指示用于了解有关见解的更多信息的 URL。 |
| dateTime | 日期/时间 | 不可以 | UTC 格式的活动日期和时间。 如果活动同时具有开始时间和结束时间，应用程序必须确定要显示哪个时间。 格式遵从 OpenAPI 规范。 这里是一个示例：2017-07-21T17:32:28Z。 | 此输出指示与见解关联的时间。 |
| additionalProperties | 具有字符串类型的属性名称和属性值值的对象 | 不可以 | 一组名称-值对，指示操作返回的相关见解的其他属性。 当用户在关键销售信息窗格中选择见解时，此信息将显示在弹出卡中。 | 此输出将其他属性指示为操作返回的每个相关见解的名称-值对。 |
示例
{
"value": [
{
"title": "Contract signed",
"description": "Kenny Smith sent Renewal Contract on 04/23/2023 related to 50 Cafe A-100 Automatic",
"dateTime": "2023-09-07T03:42:35.4662309Z",
"url": https://contosohub.com,
"additionalProperties": {
"Contract name": "Renewal contract for Fourth Coffee",
"Signed by": "Alberto Burgos, Tony Benis",
"Signed": "9/7/23",
"Related Opportunity": "50 CafeA-100 Automatic"
}
}
],
"hasMoreResults": false
}
下图中的示例显示 API 的输出如何映射到关键销售信息。
图例：
- 显示合作伙伴应用程序的见解的部分。 部分标题派生自 Microsoft Power Platform 连接器的名称。
- 来自 API 响应的见解的说明。
- 可以选择来查看有关见解的详细信息的引文编号。
- 显示有关见解的详细信息的引文卡。
- 见解的图标和标题。 此图标从 Microsoft Power Platform 连接器元数据检索。 标题是来自 API 响应的见解的标题。
- 来自 API 响应的见解的其他属性。
- 合作伙伴应用程序的名称。 显示的名称是 Microsoft Power Platform 连接器的名称。
- 可以选择来查看合作伙伴应用程序中的见解详细信息的链接。 基于 API 响应中见解的 URL。
相关信息
查看销售用 Copilot 中的关键销售信息
使用应用程序中的见解扩充电子邮件摘要
使用应用程序中的文件链接扩充电子邮件草稿
使用应用程序中的见解扩充 CRM 记录详细信息
使用应用程序中的见解扩充 CRM 记录摘要
使用合作伙伴应用程序扩展销售用 Microsoft 365 销售用 Copilot
构建销售用 Copilot 扩展