按需录制 API
此 API 仅适用于 Multi-ACD (Open) 用户。
这些 API 可按需启动、停止和禁用呼叫记录,从而可通过 API 进行录制控制。
开发者社区门户中提供了记录点播 API。
在您开始之前
在开始使用屏蔽和解除屏蔽 API 之前,设置用户权限、生成访问密钥,并遵循开发者门户上说明的注册和验证流程。
此 API 需要交互中心 >API > 多 ACD 记录点播 API 权限。
POST 按需开始录制
此 API 可使坐席或应用程序开始录制特定用户正在进行的呼叫。 它可用于捕获与合规性目的、质量保证或培训相关的特定交互或对话。
您可以指定仅开始录制语音,或同时开始录制语音和屏幕。 此 API 方法优先于录制策略。
mediaType 标志是可选的,其允许控制录制哪些媒体类型。 支持的值为 voice 和 voiceAndScreen,因此允许仅开始录制语音或同时录制语音和屏幕。 如果未传递该标志,则默认值将为 voice。
用户 ID*: |
字符串 要录制的媒体类型。 |

POST /interaction-recording-management-service/interactions/start-recording-on-demand?user-id=1234567
应答
-
状态 200 — 操作成功。 按需开始录制请求开始。
-
状态 202 — 操作进行中。 按需开始请求已被接受并正在处理。
-
状态 400 - 错误请求
-
状态 401 — 发起请求的用户身份验证失败。
-
状态 403 — 发起请求的用户无权执行该操作。
-
状态 404 — 未找到。 未发现活动交互。
-
状态 409 — 由于服务状态,该请求无法执行。
-
状态 425 — 处理先前的按需录制/按需停止请求时交互被锁定
-
状态 500 — 内部服务器错误。
-
状态 504 — 请求超时。
POST 停止按需录制
该 API 允许停止录制特定用户正在进行的呼叫的语音和屏幕。 它可用于保护客户隐私或遵守限制录制某些类型对话的法规。
此 API 方法的优先级高于 Recording 策略。 停止按需录制后,只能通过调用开始按需录制来恢复录制。
用户 ID*: |
字符串 要录制的坐席的坐席用户 ID。 |

POST /interaction-recording-management-service/interactions/stop-recording-on-demand?user-id=1234567
应答
-
状态 200 — 操作成功。 按需停止录制请求开始。
-
状态 202 — 操作进行中。 按需停止请求已被接受并正在处理。
-
状态 400 - 错误请求。
-
状态 401 — 发起请求的用户身份验证失败。
-
状态 403 — 发起请求的用户无权执行该操作。
-
状态 404 — 未找到。 未发现活动交互。
-
状态 409 — 由于服务状态,该请求无法执行。
-
状态 425 — 处理先前的按需录制/按需停止请求时交互被锁定。
-
状态 500 — 内部服务器错误。
-
状态 504 — 请求超时。
POST 禁用录制呼叫的选项
如果客户拒绝同意且不同意录制,则该 API 允许禁用录制呼叫语音和屏幕的选项。 这一点与欧盟一般数据保护条例 (GDPR) 尤其相关。 如果客户拒绝同意,则CXone Mpower Recording 不会录制呼叫,即使设置了录制呼叫的录制策略,或者坐席按需或使用 API 录制呼叫。
之后无法对整个客户联系(包括转移、咨询和会议)启动 API 呼叫记录。 如果在通话录音正在进行时调用 API,则 Recording 将停止录制,但通话的录制部分将可用于搜索和回放。
录制同意仅适用于当前呼叫。 它不会为客户保存用于未来的交互。
用户 ID*: |
字符串 要录制的坐席的坐席用户 ID。 |

POST /interaction-recording-management-service/interactions/do-not-record?user-id=1234567
应答
-
状态 200 — 操作成功。 不记录请求已启动。
-
状态 202 — 操作进行中。 不记录请求已被接受并正在处理。
-
状态 400 - 错误请求。
-
状态 401 — 发起请求的用户身份验证失败。
-
状态 403 — 发起请求的用户无权执行该操作。
-
状态 404 — 未找到。 未发现活动交互。
-
状态 409 — 由于服务状态,该请求无法执行。
-
状态 425 — 在处理先前请求时交互被锁定。
-
状态 500 — 内部服务器错误。
-
状态 504 — 请求超时。