# 获取通话的状态及ASR结果 #### 场景描述 获取通话的状态及ASR结果接口 #### 接口方法 POST #### 接口URI https://域名/apiaccess/CCSQM/rest/ccisqm/v1/appraisecall/details,例如域名是service.besclouds.com #### 请求说明 表1请求头参数 | 序号 | 名称 | 参数类型 | 是否必选 | 说明 | |:---|:---|:---|:---|:---| | 1 | Content-Type | string | False | 固定填 application/json;charset=UTF-8。 | | 2 | x-app-key | string | False | appKey标识 | | 3 | Authorization | string | True | 鉴权字段，内容格式为: Bearer +tokenByAKSK接口的返回值中AccessToken（Bearer后有空格） | | 4 | x-UserId | string | True | 操作员标识 可在登录后，进入员工管理页面，查看接口返回的userId | 表2请求体参数 | 序号 | 名称 | 参数类型 | 是否必选 | 说明 | |:---|:---|:---|:---|:---| | 1.1 | call_from | number | False | 通话起始时间 ：时间戳，单位秒 | | 1.2 | call_to | number | False | 通话结束时间 ：时间戳，单位秒 | | 1.3 | call_types | array\[integer\] | True | 通话文件类型 - 0表示语音类型 - 2表示文本类型 | | 1.4 | limit | integer | True | 每页查询总数 | | 1.5 | page | integer | True | 查询页数 | | 1.6 | status | array\[integer\] | True | 质检状态: - 0：表示等待质检。 - 1：表示质检处理中。 - 2：表示处理成功。 - 3：表示ASR转写中。 - 9：表示质检失败，发生错误，质检音频总流量达到每日上限，质检文件数量达到每日上限。 - 31：表示ASR转写结果语音内容为空。 - 32：表示语音转文本失败。 - 33：表示上传语音文件至ASR失败。 - 34：表示科大ASR传输任务提交失败。 - 35：表示执行多媒体质检任务失败。 - 36：表示TUC质检失败。 - 37：表示ASR将语音文件转换为文本失败。 - 38：表示更新质检结果失败。 - 39：表示执行质检任务失败。 - 40：表示语音文件无效。 | | 1.7 | keyword | string | False | 对话关键词 | | 1.8 | staff_id | string | False | 座席人员的userId 可在登录后，进入座席管理页面，查看接口返回的accountId | | 1.9 | staff_name | string | False | 座席姓名 | | 1.10 | upload_from | number | True | 通话上传起始时间 | | 1.11 | upload_to | number | True | 通话上传结束时间 | | 1.12 | duration_min | integer | False | 通话时长范围最小值 | | 1.13 | duration_max | integer | False | 通话时长范围最大值 | #### 响应说明 - **响应状态码: 200** 表3响应体参数 | 序号 | 名称 | 参数类型 | 是否必选 | 说明 | |:---|:---|:---|:---|:---| | 1.1 | paging | object | False | 页码信息 | | 1.1.1 | total | number | False | 通话总数量 | | 1.2 | data | array\[object\] | False | 通话信息列表 | | 1.2.1 | calls | array\[object\] | False | 多通通话信息 | | 1.2.1.1 | call_id | string | False | 会话标识 | | 1.2.1.2 | call_time | number | False | 通话时间 | | 1.2.1.3 | call_type | number | False | 文件类型 | | 1.2.1.4 | call_uuid | string | False | 会话uuid | | 1.2.1.5 | deal | number | False | 业务是否成交 | | 1.2.1.6 | duration | number | False | 通话时长 | | 1.2.1.7 | file_name | string | False | 文件名称 | | 1.2.1.8 | left_channel | string | False | 渠道信息，标识客户或者座席 | | 1.2.1.9 | left_silence_time | number | False | 静音时间 | | 1.2.1.10 | left_speech_ratio | number | False | 左声道通话比例，发话方取决于left_channel字段。 | | 1.2.1.11 | left_speed | number | False | 左声道语速 | | 1.2.1.12 | right_channel | string | False | 渠道信息，标识客户或者座席 | | 1.2.1.13 | right_silence_time | number | False | 静音时间 | | 1.2.1.14 | right_speech_ratio | number | False | 右声道通话比例 | | 1.2.1.15 | right_speed | number | False | 右声道语速 | | 1.2.1.16 | staff_id | string | False | 座席人员的userId 可在登录后，进入座席管理页面，查看接口返回的accountId | | 1.2.1.17 | status | number | False | 状态 - 0：表示等待质检。 - 1：表示质检处理中。 - 2：表示处理成功。 - 3：表示ASR转写中。 - 9：表示质检失败，发生错误，质检音频总流量达到每日上限，质检文件数量达到每日上限。 - 31：表示ASR转写结果语音内容为空。 - 32：表示语音转文本失败。 - 33：表示上传语音文件至ASR失败。 - 34：表示科大ASR传输任务提交失败。 - 35：表示执行多媒体质检任务失败。 - 36：表示TUC质检失败。 - 37：表示ASR将语音文件转换为文本失败。 - 38：表示更新质检结果失败。 - 39：表示执行质检任务失败。 - 40：表示语音文件无效。 | | 1.2.1.18 | upload_time | number | False | 通话上传时间 | | 1.2.1.19 | staff_name | string | False | 座席姓名 | | 1.2.2 | call_group_id | string | False | 呼叫组 ID | - **响应状态码: 400** 错误的请求：请检查请求路径及参数。 - **响应状态码: 401** 未授权：1. 请确认是否购买了相关服务。 2. 请联系客服人员检查您账号的当前状态。 - **响应状态码: 404** 请求的内容未找到：请检查请求的路径。 - **响应状态码: 500** 业务失败：请依次确认您请求中各参数的取值。 #### 错误码 无。 #### 报文样例 - 场景描述：获取通话的状态及ASR结果接口 请求头: ``` x-app-key:************************************ X-UserID:1611917095665261978 Authorization:Bearer ******************************** ``` 请求参数: ``` { "limit": 10, "page": 1, "call_types": [0, 2], "staff_id": null, "upload_from": 1621333149, "upload_to": 1623925149, "status": [2] } ``` 响应参数: ``` { "data": [{ "calls": [{ "staff_name": "*****", "create_time": 1622633782, "left_speed": 241.552, "left_speech_ratio": 0.4613, "file_name": "Consultant", "left_channel": "customer", "right_speech_ratio": 0.3252, "call_time": 1622633782, "inspect_status": 0, "right_channel": "staff", "complain_status": -1, "call_id": "3b9cd7a9-d38c-4aa0-a35d-77f6abb9f497", "left_silence_time": 88.46, "duration": 164.22, "upload_time": 1622633782, "right_silence_time": 110.82, "right_speed": 165.169, "staff_id": "1600226440112042215", "call_uuid": "3b9cd7a9-d38c-4aa0-a35d-77f6abb9f497", "review_status": -1, "call_type": 0, "status": 2 }], "call_group_id": "3b9cd7a9-d38c-4aa0-a35d-77f6abb9f497" }, { "calls": [{ "staff_name": "*****", "create_time": 1622554272, "left_speed": 307.127, "left_speech_ratio": 0.251, "file_name": "myvoice", "left_channel": "customer", "right_speech_ratio": 0.206, "call_time": 1622554272, "inspect_status": 0, "right_channel": "staff", "complain_status": -1, "call_id": "2ef38e9b-36dd-4c1f-97cb-a665a2d9de3a", "left_silence_time": 260.03, "duration": 347.16, "upload_time": 1622554272, "right_silence_time": 275.65, "right_speed": 318.837, "staff_id": "1600226440112042215", "call_uuid": "2ef38e9b-36dd-4c1f-97cb-a665a2d9de3a", "review_status": -1, "call_type": 0, "status": 2 }], "call_group_id": "2ef38e9b-36dd-4c1f-97cb-a665a2d9de3a" }, { "calls": [{ "staff_name": "*****", "create_time": 1622552201, "left_speed": 305.061, "left_speech_ratio": 0.251, "file_name": "myvoice", "left_channel": "customer", "right_speech_ratio": 0.206, "call_time": 1622552201, "inspect_status": 0, "right_channel": "staff", "complain_status": -1, "call_id": "4aca6bb8-13e6-4fd8-ac5b-0402fbb5bef4", "left_silence_time": 260.03, "duration": 347.16, "upload_time": 1622552201, "right_silence_time": 275.65, "right_speed": 319.676, "staff_id": "1600226440112042215", "call_uuid": "4aca6bb8-13e6-4fd8-ac5b-0402fbb5bef4", "review_status": -1, "call_type": 0, "status": 2 }], "call_group_id": "4aca6bb8-13e6-4fd8-ac5b-0402fbb5bef4" }, { "calls": [{ "staff_name": "*****", "create_time": 1622552093, "left_speed": 324.068, "left_speech_ratio": 0.6081, "file_name": "6335", "left_channel": "customer", "right_speech_ratio": 0.185, "call_time": 1622552093, "inspect_status": 0, "right_channel": "staff", "complain_status": -1, "call_id": "4a8507ec-8519-46ab-9ca7-241556a6eb6c", "left_silence_time": 40.8, "duration": 104.12, "upload_time": 1622552093, "right_silence_time": 84.86, "right_speed": 230.53, "staff_id": "1600226440112042215", "call_uuid": "4a8507ec-8519-46ab-9ca7-241556a6eb6c", "review_status": -1, "call_type": 0, "status": 2 }], "call_group_id": "4a8507ec-8519-46ab-9ca7-241556a6eb6c" }, { "calls": [{ "staff_name": "*****", "create_time": 1622528466, "left_speed": 307.127, "left_speech_ratio": 0.251, "file_name": "myvoice", "left_channel": "customer", "right_speech_ratio": 0.206, "call_time": 1622528466, "inspect_status": 0, "right_channel": "staff", "complain_status": -1, "call_id": "ead642de-fa23-4bc0-adf5-f2bac9614b01", "left_silence_time": 260.03, "duration": 347.16, "upload_time": 1622528466, "right_silence_time": 275.65, "right_speed": 321.354, "staff_id": "1600226440112042215", "call_uuid": "ead642de-fa23-4bc0-adf5-f2bac9614b01", "review_status": -1, "call_type": 0, "status": 2 }], "call_group_id": "ead642de-fa23-4bc0-adf5-f2bac9614b01" }, { "calls": [{ "staff_name": "*****", "create_time": 1622513361, "left_speed": 306.439, "left_speech_ratio": 0.251, "file_name": "20208650", "left_channel": "customer", "right_speech_ratio": 0.206, "call_time": 1622513361, "inspect_status": 0, "right_channel": "staff", "complain_status": -1, "call_id": "1e158a1a-2f6d-44f6-ba44-b15d52e21651", "left_silence_time": 260.03, "duration": 347.16, "upload_time": 1622513361, "right_silence_time": 275.65, "right_speed": 320.515, "staff_id": "1600226440112042215", "call_uuid": "1e158a1a-2f6d-44f6-ba44-b15d52e21651", "review_status": -1, "call_type": 0, "status": 2 }], "call_group_id": "1e158a1a-2f6d-44f6-ba44-b15d52e21651" }], "paging": { "total": 6 } } ```