目前该API接口已标记为弃用,推荐使用替代API:Qualitycheck(2019-01-15) - GetResult。
获取热线实时质检结果。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
当前API暂无授权信息透出。
请求参数
名称 | 类型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
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 内部配置变更,不影响调用 | 看变更集 | ||
|