POST /CCSQM/rest/ccisqm/v1/appraisecall/details

场景描述

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

父主题： 通话质检接口 (qualitycheckmanage)

上一篇：通话质检接口 (qualitycheckmanage)

下一篇：POST /CCSQM/rest/ccisqm/v1/appraisecall/detail