目前该API接口已标记为弃用，推荐使用替代API：Qualitycheck(2019-01-15) - GetResult。
获取热线实时质检结果。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：
- 操作：是指具体的权限点。
- 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
- 资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用背景高亮的方式表示。
- 对于不支持资源级授权的操作，用
全部资源表示。
- 条件关键字：是指云产品自身定义的条件关键字。
- 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。
| 操作 | 访问级别 | 资源类型 | 条件关键字 | 关联操作 |
|---|---|---|---|---|
| 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 | long | 否 | 业务空间 Id |
请求参数 JSON 字符串信息
| 属性 | 值类型 | 是否必须 | 说明 |
|---|---|---|---|
| isSchemeData | Integer | 否 | 是否查询新版智能对话分析中的数据，取值：0 否；1 是，默认值为 0。 |
| 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（升序）。 |
返回参数
示例
正常返回示例
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"
}
}
]
}错误码
访问错误中心查看更多错误码。
变更历史
| 变更时间 | 变更内容概要 | 操作 |
|---|---|---|
| 2024-04-19 | OpenAPI 变更为 deprecated，即将下线 | 查看变更详情 |
| 2023-08-01 | API 内部配置变更，不影响调用 | 查看变更详情 |