调用GetSyncResult获取实时质检结果(已弃用)-智能对话分析-阿里云

目前该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	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>	查询结果。
ResultInfo	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>	转写结果（对话文本）
AsrResult	object	文件转写结果。
Words	string	对话内容。	您好，很高兴为您服务
Begin	long	本句话的开始时间，是相对起始点的开始时间偏移，单位 ms。	340
EmotionValue	integer	情绪能量值 1-10，值越高情绪越强烈。	6
End	long	本句话的结束时间，是相对起始点的结束时间偏移，单位 ms。	3000
SpeechRate	integer	本句平均语速，单位：字/分钟。	221
Role	string	对话内容角色，可能值：客服、客户。	客服
SilenceDuration	integer	内部字段，请忽略。	11
HitResult	array<object>	规则命中结果
HitResult	object	规则命中结果
Type	string	命中规则所关联的规则类型。	2
ReviewResult	integer	复核准确性；可能值：0（错误）；1（正确）。	1
Name	string	命中的规则名称。	测试规则
Rid	string	命中的规则 ID。	1211
Hits	array<object>	具体命中位置信息，以句子维度，返回命中句子中具体命中了规则中哪个条件，是哪几个字命中的
Hit	object	规则命中结果
KeyWords	array<object>	返回当前句中是哪几个字命中了规则，也就是需要高亮展示的关键字
KeyWord	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 列表。
Cid	string	命中的条件 ID 列表。	["1","3"]
Phrase	object	当前命中规则的句子详情
Words	string	这个角色说的一句话。	我要投诉
Begin	long	本句话的开始时间，是相对起始点的开始时间偏移，单位 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：呼出 3：呼入	1
Caller	string	主叫号码	0108888****
CallId	string	通话 ID。	xxx
DataSetName	string	内部字段，请忽略。	xxx
Duration	long	对话总字数	232
DurationAudio	long	通话时长。	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
      }
    }
  ]
}

错误码

访问错误中心查看更多错误码。

变更历史

变更时间	变更内容概要	操作
2024-04-19	OpenAPI 变更为 deprecated，即将下线	查看变更详情
2023-08-01	API 内部配置变更，不影响调用	查看变更详情