屏幕交互录制 API

API可用于启动桌面活动的屏幕录制。 这能够实现无联系时记录坐席的屏幕以及后台屏幕的录制。

此API适用于具有语音或屏幕录制功能的 Engagement Hub 用户以及 CXone MpowerACD 用户。

在您开始之前

可以在CXone Mpower开发人员门户 上测试 API。 使用CXone Mpower帐户登录，然后您可以使用帐户的租户关闭 高层级组织分组，用于管理 CXone Mpower 系统的技术支持、计费和全局设置。发出请求。

要开始使用 API，您必须向 NiCE 注册以接收用于身份验证的有效凭据。 有关说明，请查看开发人员门户上的入门页面 。

此外，使用这些 API 需要Interactions Hub 录制屏幕交互权限。

开始屏幕交互录制

该 API 可为未处于活动呼叫中的特定用户启动屏幕录制。 您必须通过将录制持续时间作为参数在启动命令中提供来指定。 持续时间应在 5 秒到 3:30 小时（允许的最长时间）之间。 当达到持续时间时，录制将自动停止。 此外，您可以通过调用 stop-screen-interaction-recording 命令停止屏幕录制。

  • 当启动录制（由响应代码 202 指示）或成功（由响应代码 200 指示）时，将提供与所录制的屏幕相关联的联系人 ID。 发出停止命令时应使用此通话 ID。

  • 该 API 可以在坐席与客户之间的实时呼叫期间使用，这可能会被录制。 在这种情况下，将有两个不同的录音 - 一个捕获语音对话，另一个基于 API 交互 - 每个录音都与不同的联系人 ID 相关联。

  • 如果将屏蔽应用于实时呼叫，它还会影响可能并行录制的 API 屏幕录制交互。

  • 使用 API 时，每个用户最多可以有 10 个屏幕交互录制实例，每个实例都有不同的联系人 ID。 对同一用户的任何后续 API 调用都会导致错误 (429)。

方法：POST

端点：/interaction-recording-management-service/v1/interactions/start-screen-interaction-recording

参数：

用户 ID*：

（查询）

字符串

被记录的用户ID。

录制持续时间*：

（查询）

号码

指定所需的录制持续时间，范围为 5-13200 秒

发布 /interaction-recording-management-service/interactions/start-screen-interaction-recording？user-id=1234567&recordingDuration=3000

响应

  • 状态 200 -作成功。

    description（字符串）：响应的描述。

    contactId（号码）：ACD 联系人 ID。

    interactionId（字符串）：全局交互 ID。

    httpStatus（字符串）：HTTP 状态描述。

  • 状态 202 -作正在进行中。

    contactId（号码）：ACD 联系人 ID。

    interactionId（字符串）：全局交互 ID。

    httpStatus（字符串）：HTTP 状态描述。

  • 状态 400 - 错误请求。

  • 状态 401 - 发起请求的用户身份验证失败。

  • 状态 403 - 请求用户无权执行该作。

  • 状态 404 - 未找到。 未发现活动交互。

  • 状态 425 - 在处理先前的请求时交互被锁定。

  • 状态 429 - 已达到最大并发请求容量

  • 状态 500 - 内部服务器错误。

  • 状态 504 - 请求超时。

停止屏幕交互录制

该 API 能够停止使用 start-screen-interaction-recording 命令启动的特定用户的联系人 ID 的屏幕录制。 您应使用 start-screen-interaction-recording 命令的响应中提供的联系人 ID。 如果未调用此方法，则屏幕录制将在 start-screen-interaction-recording 命令中提供的持续时间后自动停止。

方法：POST

端点：/interaction-recording-management-service/v1/interactions/stop-screen-interaction-recording

参数：

用户 ID*：

字符串

要停止的录制用户的 ID。
contactId*：

号码

“开始屏幕录制”命令中返回的联系人 ID。

发布 /interaction-recording-management-service/interactions/stop-screen-interaction-recording？user-id=1234567&contactId=1122334455

响应

  • 状态 200 -作成功。

  • 状态 202 -作正在进行中。

  • 状态 400 - 错误请求。

  • 状态 401 - 发起请求的用户身份验证失败。

  • 状态 403 - 请求用户无权执行该作。

  • 状态 404 - 未找到。 未发现活动交互。

  • 状态 425 - 在处理先前的请求时交互被锁定。

  • 状态 500 - 内部服务器错误。

  • 状态 504 - 请求超时。