更新时间:2024-09-24 GMT+08:00
分享

获取通话的状态及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
    	}
    }

相关文档