从外部应用程序访问录制
您可以从外部应用程序（例如 CRM 系统）播放和下载 CXone Recording。
从 CXone 外部访问录制有 2 种主要方法：
-
使用 Media Playback API 获取媒体文件的基本元数据和临时 URL
-
启动 CXone Player 或使用 URL 直接从 CRM 系统下载媒体文件：从 CRM 系统访问媒体文件
Media Playback API
您可以使用此 API 访问 CXone Recording 媒体和元数据。
使用 Media Playback API 可能需要支付额外费用。有关更多信息，请查阅您的合同或联系您的 CXone 客户代表。
-
播放交互时：
-
对于纯语音和语音和屏幕媒体类型，API 会传输交互元数据和指向媒体文件的链接。
-
对于聊天和电子邮件媒体类型，API 会传输交互元数据和转录。如果媒体类型设置为全部（而不是具体设置为聊天或电子邮件），那么如果存在屏幕录制，您还将获得指向用于数字交互
任何非语音渠道，例如聊天、电子邮件、SMS、工作项和消息渠道的媒体文件的链接。
-
-
下载时，API 会传输指向媒体文件的链接。
DEVone 开发人员社区门户上提供了 Media Playback API。
在您开始之前
在开始使用 Media Playback API 之前，您必须设置用户权限，生成访问密钥，并遵循开发者门户上说明的注册和身份验证流程。所需权限：
-
如果您正在搜索不在您帐户下的录制，则您需要搜索和回放 > 播放器 > 播放/下载录制：播放任何权限。
-
如果您想要请求返回情绪和类别，则您还需要搜索和回放 > 播放器 > 查看情绪和类别权限。
获取 通话
根据 ACD 呼叫 ID 访问完整的联系（具有所有段的整个交互）。ACD 呼叫 ID 取决于 ACD 解决方案，例如，这与 CXone 主联系人 ID 相同。请记住，如果使用“ACD 呼叫 ID 获取”方法，您可以播放或下载自 2018 年 12 月 13 日起记录的交互。如果访问 2018 年 12 月 13 日之前记录的交互，则会出现“找不到交互”的错误消息。
示例请求和响应
回放
播放请求示例
https://na1.nice-incontact.com/media-playback/v1/contacts?acd-call-id=123456&media-type=all&exclude-waveforms=true200 OK
{
"value": {
"contactId": "11e766de-4ace-33d0-9ff6-0242ac110004",
"Interactions": [
{
"Interaction": {
"mediaType": "voice-and-screen",
"startTime": "2018-11-20T08:20:31.941Z",
"endTime": "2018-11-20T08:25:56.957Z",
"data": {
"startTime": "2018-11-20T08:20:31.941Z",
"endTime": "2018-11-20T08:25:56.957Z",
"acwEndTime": "2018-11-20T08:27:09.643Z",
"fileToPlayUrl": "https://test-mcrplaybackmanager-4b5e-9234-54cbe7855ca1.mp4",
"videoImageUrl": null,
"waveformDataList": [
{
"channel": 0,
"normalizedPcmData": [
0.001,
0.001,
0.001
]
}
],
"participantDataList": [
{
"participantType": "AGENT",
"agentName": "Mary Walker",
"participantId": "271863",
"userId": "11e846d2-dd9f-6f10-9aef-0242ac110002",
"voiceStages": [
{
"stageType": "ACTIVE",
"startTime": "2018-11-20T08:20:31.941Z",
"endTime": "2018-11-20T08:25:56.957Z",
"segmentID": "e079511b-c077-489e-85a3-24b1b147d3c7",
"displays": null
}
],
"screenStages": [
{
"stageType": "ACTIVE",
"startTime": "2018-11-20T08:20:31.941Z",
"endTime": "2018-11-20T08:25:56.957Z",
"segmentID": "e7621f2c-32e4-47cd-bfc5-29a48343f7e0",
"displays": [
{
"width": 1680,
"height": 1050,
"topLeftX": -1680,
"topLeftY": 0
},
{
"width": 1680,
"height": 1050,
"topLeftX": 0,
"topLeftY": 0
},
{
"width": 1366,
"height": 768,
"topLeftX": 1680,
"topLeftY": 0
}
]
}
],
"channel": 0
},
{
"participantType": "CUSTOMER",
"agentName": null,
"participantId": "68367118",
"userId": null,
"voiceStages": [
{
"stageType": "ACTIVE",
"startTime": "2018-11-20T08:20:31.941Z",
"endTime": "2018-11-20T08:25:56.957Z",
"segmentID": "e079511b-c077-489e-85a3-24b1b147d3c7",
"displays": null
}
],
"screenStages": [],
"channel": 0
}
],
"segmentsDataList": [
{
"startTime": "2018-11-20T08:20:31.941Z",
"endTime": "2018-11-20T08:25:56.957Z",
"acwEndTime": "2018-11-20T08:27:09.643Z",
"openReasonType": "SEGMENT",
"closeReasonType": "SEGMENT",
"directionType": "OUTBOUND",
"source": null
}
],
"categoryMatchesList": [
{
"categoryHierarchy": [
"Account Inquiries",
"Account Problems"
],
"secondsOffsets": [
24
],
"confidence": 95
}
],
"sentiments": [
{
"overallSentiment": "POSITIVE",
"segmentStartTime": "2018-11-20T08:20:31.941Z",
"channel": 1
},
{
"overallSentiment": "POSITIVE",
"segmentStartTime": "2018-11-20T08:20:31.941Z",
"channel": 0
}
]
}
}
},
{
"Interaction": {
"mediaType": "chat",
"startTime": "2018-11-21T08:27:09.643Z",
"endTime": "2018-11-21T18:20:31.941Z",
"data": {
"startTime": "2018-11-21T08:27:09.643Z",
"endTime": "2018-11-21T18:20:31.941Z",
"transferPoints": [
"2018-11-21T10:34:23.433Z"
],
"participants": [
{
"participantType": "AGENT",
"participantName": "Kevin Allen"
},
{
"participantType": "CUSTOMER",
"participantName": ""
}
],
"messages": [
{
"participantType": "AGENT",
"participantName": "Kevin Allen",
"text": "agent 1",
"timeStamp": "2018-11-21T10:35:23.643Z"
},
{
"participantType": "CUSTOMER",
"participantName": "",
"text": "Betty Alexander"
}
]
}
}
},
{
"Interaction": {
"mediaType": "email",
"startTime": "2018-11-21T18:30:09.643Z",
"endTime": "2018-11-21T18:36:36.347Z",
"data": {
"startTime": "2018-11-21T18:30:09.643Z",
"endTime": "2018-11-21T18:34:56.957Z",
"acwEndTime": "2018-11-21T18:36:36.347Z",
"participants": [
{
"participantType": "AGENT",
"participantName": "Angela Bryant",
"actions": [
{
"timeStamp": "2018-11-21T18:30:09.643Z",
"action": "NewOutbound"
},
{
"timeStamp": "2018-11-21T18:34:56.957Z",
"action": "Send"
}
]
}
],
"content": {
"sentTime": "2018-11-21T18:34:56.957Z",
"from": "doNotAnswer@ourcompany.com",
"to": [
"angelab@yourcompany.com"
],
"cc": [],
"bcc": [],
"subject": "Hello",
"body": "Hi"
}
}
}
}
]
}
}下载
下载请求示例
https://na1.nice-incontact.com/media-playback/v1/contacts?acd-call-id=123456&media-type=all&exclude-waveforms=true&isDownload=true{
"redirectUrl" : "https://na1-mcrplaybackmanager-12345ABCDEF.s3.us-west-2.amazonaws.com/tenant/output_12345ABCDEF.mp4?X-Amz-Security-Token=12345ABCDEF12345X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20200820T114056Z&X-Amz-SignedHeaders=host&X-Amz-Expires=1800&X-Amz-Credential=12345ABCDEFus-west-2%2Fs3%2Faws4_request&X-Amz-Signature=12345ABCDEF"
}响应
-
200 成功
-
400 请求无效
-
401 未授权播放
-
403 需要授权
-
404 找不到交互
-
500 内部服务器错误
获取 声明
根据 ACD 联系人 ID 和声明 ID 访问录制声明。ACD 联系人 ID 取决于 ACD 解决方案，例如，此处 acdContactId 为主联系人 ID 一个或多个相关联系人的主或父 ID。如果一个联系人已被转移 3 次或更多次，将分配一个新的主联系人 ID。。
API 返回的 URL 有效期为 30 分钟或调用的持续时间（以较长者为准）。
示例请求和响应
响应
-
200 成功
-
400 请求无效
-
401 未授权播放
-
403 需要授权
-
404 找不到交互
-
500 内部服务器错误
从 CRM 系统访问媒体文件
您可以使用 URL 直接从 CRM 系统播放或下载媒体文件。
在 Studio 中生成 URL，然后将其集成到 CRM 系统中。“专业服务”可以为您提供帮助，但该服务可能需要收取费用。请联系您的 CXone 客户代表 以了解更多信息。
例如：
-
播放文件：
-
语音或数字录制：https://na1.nice-incontact.com/player/#/cxone-player/acd-contacts/acdContactId
-
录制的声明：https://na1.nice-incontact.com/player/#/cxone-player/acd-contacts/acdContactId/statements/statementId
默认情况下，用于播放的 URL 会启动 CXone Player。您可以将其配置为在其他播放器中打开。
-
-
下载文件：
-
语音和屏幕录制：https://na1.nice-incontact.com/media-download/#/acd-contacts?acdContactId=acdContactId&isDownload=true
-
纯语音录制：https://na1.nice-incontact.com/media-download/#/acd-contacts?acdContactId=acdContactId&isDownload=true&mediaType=voice-only
-
录制的声明：https://na1.nice-incontact.com/media-download/#/acd-contacts/acdContactId/statements/statementId?isDownload=true&mediaType=voice-only
文件名的格式为 CXone recording_{agent name}_{call start time}[UTC]_{id}.mp4。请注意，与播放器不同，文件名中的日期按照 UTC 显示，而前者则以您的本地时区显示。
-
acdContactId 是 CXone 主联系人 ID 一个或多个相关联系人的主或父 ID。如果一个联系人已被转移 3 次或更多次，将分配一个新的主联系人 ID。。