获取热线实时质检结果。
目前该API接口已标记为弃用，推荐使用替代API：Qualitycheck(2019-01-15) - GetResult。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
sca:GetSyncResult |
get |
*全部资源
|
无 | 无 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| JsonStr |
string |
是 |
完整 JSON 字符串信息，具体内容参见以下详细信息。 |
{"pageNumber":1,"pageSize":10,"requiredFields":"asrResult,agent,status,errorMessage,reviewStatus,reviewResult,score,taskId,reviewer,resolver,recording.name,recording.duration,recording.url,hitResult,business","startTime":"2020-12-25 00:00:00","endTime":"2020-12-31 23:59:59"} |
| BaseMeAgentId |
integer |
否 |
业务空间 Id |
123456 |
请求参数 JSON 字符串信息
| 属性 | 值类型 | 是否必须 | 说明 |
| taskId | String | 否 | 使用上传质检数据后返回的任务 ID来查询，一般来说，要么根据 taskId 或者 tid 查询，要么根据时间范围进行查询，所以 taskId、tid、startTime/endTime、二者必选其一。 |
| tid | String | 否 | 对话唯一标识，比如一个录音的唯一标识，一般来说，要么根据 tid 查询，要么根据时间范围进行查询，所以 taskId 与 tid 与 startTime/endTime 三者必选其一 |
| startTime | String | 否 | 按任务上传时间（API 调用时间）区间查询，区间的开始时间，格式'yyyy-MM-dd HH:mm:ss'。 |
| endTime | String | 否 | 按任务上传时间（API 调用时间）区间查询，区间的结束时间，格式'yyyy-MM-dd HH:mm:ss'。 |
| pageSize | Integer | 否 | 每页返回的数据数，要求大于 0，小于 100，默认 10。 |
| pageNumber | Integer | 否 | 要求返回的第几页的数据，默认 1。 |
| countTotal | Boolean | 否 | 是否返回分页数据中的总条数，默认 true，数据量较大时，不返回总条数会提升接口返回结果的速度。 |
| requiredFields | String | 否 | 返回结果需要包括哪些字段，多个字段用逗号分隔，请按需选择；可选字段：taskId（任务 ID），score（得分），status（状态），recording（文件信息），recording.dataSet（数据集名称），asrResult（转写结果），hitResult（质检结果），comments（复核意见），agent（坐席信息）；默认值：score,status,taskId,hitResult,reviewHistory |
| excludeFields | String | 否 | 返回结果中不需要包括哪些字段，通常是子字段,多个字段用逗号分隔，取值举例：hitResult.hits。 |
| ruleIds | List | 否 | 命中的规则 ID 列表，筛选出命中指定规则的数据。 |
| customerServiceName | String | 否 | 客服姓名。 |
| customerServiceId | String | 否 | 客服 ID。 |
| caller | String | 否 | 主叫号码。 |
| callee | String | 否 | 被叫号码。 |
| callId | String | 否 | 通话 ID。 |
| skillGroupName | String | 否 | 技能组名称。 |
| hitStatus | Integer | 否 | 命中状态，取值：0（无规则命中）；1（有规则命中）。 |
| reviewStatus | Integer | 否 | 复核状态，取值：0（未复核）；1（已复核）。 |
| assignStatus | Integer | 否 | 文件分配状态，0：未分配；1：已分配 |
| scoreType | Integer | 否 | 根据质检得分筛选时的筛选类型，**必须与 totalScore 一起使用，**取值：1（返回质检得分等于 totalScore 的数据）；2（返回质检得分小于 totalScore 的数据）；3（返回质检得分大于 totalScore 的数据）。 |
| reviewer | Long | 否 | 质检员 id，只返回分配给该质检员的文件。 |
| totalScore | Integer | 否 | 质检得分分值，根据质检得分筛选，必须与 scoreType 一起使用。 |
| durationType | Integer | 否 | 根据录音时长筛选时的筛选类型，**必须与 duration 一起使用，**取值：1（返回录音时长等于 duration 的数据）；2（返回录音时长小于 duration 的数据）；3（返回录音时长大于 duration 的数据）。 |
| duration | Integer | 否 | 录音时长，根据录音时长筛选，必须与 durationType 一起使用，单位：秒。 |
| fileName | String | 否 | 文件名称，需要提供完整的文件名称，不支持模糊搜索。 |
| remark1 | String | 否 | 自定义数据 1，调用SyncQualityCheck.json接口上传质检数据时所提供。 |
| remark2 | String | 否 | 自定义数据 2，调用SyncQualityCheck.json接口上传质检数据时所提供。 |
| remark3 | String | 否 | 自定义数据 3，调用SyncQualityCheck.json接口上传质检数据时所提供。 |
| sortField | String | 否 | 按指定参数进行排序，目前仅质检得分和自定义数据 1/2/3 支持排序，所以可输入的值为：score/remark1/remark2/remark3。 |
| sortType | String | 否 | 排序规则，取值：desc（降序）；asc（升序）。 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
|||
| RequestId |
string |
请求 id |
76DB5D8C-5BD9-42A7-B527-5AF3A5F**** |
| Success |
boolean |
请求是否成功，调用方可根据此字段来判断请求是否成功：true 表示成功；false/null 表示失败 |
true |
| ResultCountId |
string |
内部字段，请忽略。 |
xxx |
| Code |
string |
结果代码，200 表示成功，若为别的值则表示失败，调用方可根据此字段判断失败原因。 |
200 |
| Message |
string |
出错时表示出错详情，成功时为 successful。 |
successful |
| PageNumber |
integer |
页码 |
1 |
| PageSize |
integer |
每页条数。 |
10 |
| Count |
integer |
总条数。 |
1 |
| Data |
array<object> |
查询结果。 |
|
|
array<object> |
查询结果。 |
||
| Status |
integer |
任务当前状态，可能值：0（未完成）；1（已完成），调用方可根据此字段判断任务是否完成；非 0、1 表示出错，错误详情可查看 errorMessage 字段。 |
1 |
| ErrorMessage |
string |
当 status 是非 0、1 时表示错误详情。 |
xxxx |
| Reviewer |
string |
分配的质检员的用户名。 |
张三 |
| CreateTime |
string |
任务创建时间。 |
2019-07-24T19:31Z |
| ReviewStatus |
integer |
复核状态；可能值：0（未复核）；1（已复核）。 |
1 |
| TaskName |
string |
内部字段，请忽略。 |
xxx |
| Comments |
string |
复核意见。 |
xxx |
| ReviewResult |
integer |
复核准确性，可能值：0（错误）；1（正确）；2（部分正确）；3（待复核）。 |
3 |
| Score |
integer |
质检得分，满分 100。 |
100 |
| TaskId |
string |
任务 ID。 |
20201231de3d34ec-40fa-4a55-8d27-76ea***** |
| Resolver |
string |
实际复核的质检员。 |
张三 |
| AsrResult |
array<object> |
转写结果（对话文本） |
|
|
object |
文件转写结果。 |
||
| Words |
string |
对话内容。 |
您好，很高兴为您服务 |
| Begin |
integer |
本句话的开始时间，是相对起始点的开始时间偏移，单位 ms。 |
340 |
| EmotionValue |
integer |
情绪能量值 1-10，值越高情绪越强烈。 |
6 |
| End |
integer |
本句话的结束时间，是相对起始点的结束时间偏移，单位 ms。 |
3000 |
| SpeechRate |
integer |
本句平均语速，单位：字/分钟。 |
221 |
| Role |
string |
对话内容角色，可能值：客服、客户。 |
客服 |
| SilenceDuration |
integer |
内部字段，请忽略。 |
11 |
| HitResult |
array<object> |
规则命中结果 |
|
|
array<object> |
规则命中结果 |
||
| Type |
string |
命中规则所关联的规则类型。 |
2 |
| ReviewResult |
integer |
复核准确性；可能值：0（错误）；1（正确）。 |
1 |
| Name |
string |
命中的规则名称。 |
测试规则 |
| Rid |
string |
命中的规则 ID。 |
1211 |
| Hits |
array<object> |
具体命中位置信息，以句子维度，返回命中句子中具体命中了规则中哪个条件，是哪几个字命中的 |
|
|
array<object> |
规则命中结果 |
||
| KeyWords |
array<object> |
返回当前句中是哪几个字命中了规则，也就是需要高亮展示的关键字 |
|
|
object |
命中的位置列表。 |
||
| From |
integer |
需要高亮展示的关键字从第几个字符开始，取值范围从 0 开始，最大值为当句话字符总数减 1。高亮的字包含 from。 |
2 |
| To |
integer |
需要高亮展示的关键字到第几个字符结束，最大值为当句话字符总数减 1。高亮的字不包含 to，例如一句话为“不可能给你退货的”，from=0，to=3，那么需要高亮的关键字就是“不可能”三个字。 |
5 |
| Val |
string |
具体的关键字内容。 |
投诉 |
| Cid |
string |
命中的条件 ID。 |
66666 |
| Cid |
array |
命中的条件 ID 列表。 |
|
|
string |
命中的条件 ID 列表。 |
["1","3"] |
|
| Phrase |
object |
当前命中规则的句子详情 |
|
| Words |
string |
这个角色说的一句话。 |
我要投诉 |
| Begin |
integer |
本句话的开始时间，是相对起始点的开始时间偏移，单位 ms。 |
440 |
| EmotionValue |
integer |
情绪能量值 1-10，值越高情绪越强烈。 |
6 |
| End |
integer |
本句话的结束时间，是相对起始点的结束时间偏移，单位 ms。 |
4000 |
| SpeechRate |
integer |
当句话的语速 |
234 |
| Role |
string |
对话内容角色，可能值：客服、客户、系统。 |
客服 |
| SilenceDuration |
integer |
内部字段，请忽略。 |
1 |
| Recording |
object |
录音文件信息 |
|
| Callee |
string |
被叫号码。 |
1888888*** |
| Remark3 |
string |
自定义数据 3。 |
xxx |
| Business |
string |
业务线名称。 |
客服部 |
| Url |
string |
录音文件地址，用于录音播放。 |
http://aliyun.com/xxx.wav |
| PrimaryId |
string |
内部字段，请忽略 |
xxxx |
| Remark1 |
string |
自定义数据 1。 |
xxx |
| Remark2 |
string |
自定义数据 2。 |
xxx |
| CallType |
integer |
呼叫类型：
|
1 |
| Caller |
string |
主叫号码 |
0108888**** |
| CallId |
string |
通话 ID。 |
xxx |
| DataSetName |
string |
内部字段，请忽略。 |
xxx |
| Duration |
integer |
对话总字数 |
232 |
| DurationAudio |
integer |
通话时长。 |
120 |
| Name |
string |
录音文件名称。 |
123123.wav |
| Id |
string |
文件 ID，即请求参数中的 callId，若未指定则会随机生成一个。 |
xxxx |
| CallTime |
string |
录音生成时间戳，精确到毫秒。 |
1563967699000 |
| Agent |
object |
客服信息 |
|
| Name |
string |
客服姓名 |
李四 |
| SkillGroup |
string |
技能组名称 |
客服组 |
| Id |
string |
客服 ID。 |
12221 |
示例
正常返回示例
JSON格式
{
"RequestId": "76DB5D8C-5BD9-42A7-B527-5AF3A5F****",
"Success": true,
"ResultCountId": "xxx",
"Code": "200",
"Message": "successful",
"PageNumber": 1,
"PageSize": 10,
"Count": 1,
"Data": [
{
"Status": 1,
"ErrorMessage": "xxxx",
"Reviewer": "张三",
"CreateTime": "2019-07-24T19:31Z\t",
"ReviewStatus": 1,
"TaskName": "xxx",
"Comments": "xxx",
"ReviewResult": 3,
"Score": 100,
"TaskId": "20201231de3d34ec-40fa-4a55-8d27-76ea*****",
"Resolver": "张三",
"AsrResult": [
{
"Words": "您好，很高兴为您服务",
"Begin": 340,
"EmotionValue": 6,
"End": 3000,
"SpeechRate": 221,
"Role": "客服",
"SilenceDuration": 11
}
],
"HitResult": [
{
"Type": "2",
"ReviewResult": 1,
"Name": "测试规则",
"Rid": "1211",
"Hits": [
{
"KeyWords": [
{
"From": 2,
"To": 5,
"Val": "投诉",
"Cid": "66666"
}
],
"Cid": [
"[\"1\",\"3\"]"
],
"Phrase": {
"Words": "我要投诉",
"Begin": 440,
"EmotionValue": 6,
"End": 4000,
"SpeechRate": 234,
"Role": "客服",
"SilenceDuration": 1
}
}
]
}
],
"Recording": {
"Callee": "1888888***",
"Remark3": "xxx",
"Business": "客服部",
"Url": "http://aliyun.com/xxx.wav\t",
"PrimaryId": "xxxx",
"Remark1": "xxx",
"Remark2": "xxx",
"CallType": 1,
"Caller": "0108888****\t",
"CallId": "xxx",
"DataSetName": "xxx",
"Duration": 232,
"DurationAudio": 120,
"Name": "123123.wav",
"Id": "xxxx",
"CallTime": "1563967699000"
},
"Agent": {
"Name": "李四",
"SkillGroup": "客服组",
"Id": "12221"
}
}
]
}错误码
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。