使用 CCaaS_CreateProactiveVoiceDelivery API（预览版）

2025-06-03

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

您可以使用 CCaaS_CreateProactiveVoiceDelivery API 向客户发起主动出站语音呼叫，或允许客户通过 Proactive Engagement 服务安排回拨。

重要

如果组织使用 CCaaS_CreateProactiveVoiceDelivery API 发起出站语音呼叫，则组织负责同意管理，包括手动更新“请勿呼叫列表”以设置客户联系的免打扰时间。请确保满足以下条件：

在联系客户之前获得适当的同意
我们只在允许的时间联系客户。

重要

这是一项预览功能。
预览功能不适用于生产环境，并且可能具有受限的功能。这些功能受补充使用条款约束，在正式发布之前已经可用，以便客户可以及早使用并提供反馈。

先决条件

您必须具有全渠道代理或全渠道主管角色才能调用此 API。
主动参与已配置。有关详细信息，请参阅配置主动参与（预览版）。

发起主动出站呼叫

主动参与使组织能够通过语音渠道发起出站通信来增强客户交互。您可以使用 Customer Insights 旅程或 CCaaS_CreateProactiveVoiceDelivery.

该 CCaaS_CreateProactiveVoiceDelivery API 使组织能够通过 Proactive Engagement 服务向客户发起主动出站语音呼叫。 API 通过 Voice Runtime 系统触发出站语音调用。根据配置的拨号模式立即（如果未指定时间窗口）或在提供的指定时间窗口内拨打电话。

此 API 允许联络中心在正确的时间向客户提供相关信息、提醒或通知，从而增强客户体验，同时优化运营效率。

请求详细信息

URL：https://<orgurl>/api/data/v9.2/CCaaS_CreateProactiveVoiceDelivery
方法：POST
版本：1.0
OData作：作
OData 类型：无界
请求授权：必需。必须包含进行 API 调用的用户的有效 Azure AD 持有者令牌。此令牌必须从与 Customer Service 实例相同的 Azure AD 租户颁发。

请求标头

密钥	类型	DESCRIPTION
ApiVersion （api版本）	字符串	CCaaS API 版本。
ProactiveEngagementConfigId	字符串	要使用的 Proactive Engagement Configuration 的 ID。这将指定要使用的拨号模式类型、工作流和出站配置文件。要获取此 ID，请执行以下作：转到 Power Apps 并选择所需的环境。 Select Tables>主动参与配置选择所需记录的 ID。
目标电话号码	字符串	要呼叫的客户电话号码。
联系人 ID	字符串	Dynamics CRM 中客户联系人的 ID。
Windows操作系统	Window 对象的 JSON 数组	指定可以拨打出站电话的有效时间段。如果未提供，则系统默认为 24 小时窗口，从当前时间到 24 小时后立即开始。
InputAttributes （输入属性）	键值字符串的 JSON 对象	可选。可以在 Copilot 代理流中引用的变量，以自定义行为、驱动条件逻辑或从 Dataverse 记录中检索个性化信息。

Windows 对象

密钥	类型	DESCRIPTION
开始	字符串	此窗口的开始时间戳。必须在格式中 `yyyy-MM-ddTHH:mm:ss.fffZ` 以 UTC 指定。
结束	字符串	此窗口的结束时间戳。必须在格式中 `yyyy-MM-ddTHH:mm:ss.fffZ` 以 UTC 指定。

示例请求


{
  "ApiVersion": "1.0",
  "ProactiveEngagementConfigId": "cbbac510-3e66-ef11-a671-6045bd03d9d8",
  "DestinationPhoneNumber": "+123456798",
  "ContactId": "761e062f-c734-ef11-8e4f-00224808a166",
  "Windows": [
    {
      "Start": "2024-09-10T13:00:00.000Z",
      "End": "2024-09-10T15:59:59.999Z"
    },
    {
      "Start": "2024-09-11T13:00:00.000Z",
      "End": "2024-09-11T15:59:59.999Z"
    }
  ],
  "InputAttributes": {
    "orderNumber": "ORD123456789",
    "type": "callback",
    "isFinalAttempt": "false"
  }
}

响应详细信息

如果成功，此方法返回 DeliveryId。 Delivery ID 是分配给通过 API 接受并存储在 msdyn_proactive_delivery 表中的每个主动参与请求的唯一标识符。

示例响应如下所示：


{
	"@odata.context": "[Organization URI]api/data/v9.2/$metadata#Microsoft.Dynamics.CRM.CCaaS_CreateProactiveVoiceDeliveryResponse",
	"DeliveryId": "9838deee-0b4e-4116-bf73-ecb80474568d"
}

安排来自任何平台的回传

您可以使用 Proactive Engagement 解决方案来安排来自各种平台（包括 Web、移动应用程序、语音和聊天代理）的回拨。可以通过以下方式执行此操作：

从 Copilot Studio 代理创建 Power Automate 流。
将计划回调 API 与您的网站集成。

从 Copilot 代理创建 Power Automate 流

您可以从 Copilot 代理创建 Power Automate 流来安排回调。执行以下步骤：

使用以下参数执行创建可与代理一起使用的流程中的步骤：

指定 Perform an unbound action 作为作。
选择 CCaaS_CreateProactiveVoiceDelivery 作为 作名称。
在 Advanced parameters （高级参数）中，指定以下必填字段：
- Item/DestinationPhoneNumber：要呼叫的客户的电话号码。
- Item/ProactiveEngagementConfigId：要使用的主动参与配置的 ID。这指示联系客户时要使用的拨号模式类型、工作流和出站配置文件。您可以从 Power Apps >表>主动参与配置 表中复制此 ID。
- item/ApiVersion：1.0
- Item/ContactId：Dynamics CRM 中客户联系人的 ID。
- （可选）您可以指定 Item/InputAttributes。此字段应包含 Copilot 代理使用的 JSON 对象。例如，{ "msdyn_CaseTitle" : "Vitre cassée", "msdyn_CustomerName" : "Sarah", "msdyn_CustomerPhone" : "+1234567890", "msdyn_CustomerId" : "cfaa617b-2fc1-ef11-b8e8-000d3a5bcd16" }。

使用 API 安排回传

将 CCaaS_CreateProactiveVoiceDelivery API 与您的网站集成，以允许客户在最方便的时候请求帮助。

示例请求

{
  "ApiVersion": "1.0",
  "ProactiveEngagementConfigId": "cbbac510-3e66-ef11-a671-6045bd03d9d8",
  "DestinationPhoneNumber": "+123456798",
  "ContactId": "761e062f-c734-ef11-8e4f-00224808a166",
  "Windows": [
    {
      "Start": "2024-09-10T13:00:00.000Z",
      "End": "2024-09-10T15:59:59.999Z"
    },
    {
      "Start": "2024-09-11T13:00:00.000Z",
      "End": "2024-09-11T15:59:59.999Z"
    }
  ],
  "InputAttributes": {
     "type": "callback"
    "isLastAttempt": "false"
  }
}

使用主动互动表进行报告