更新时间:2023-09-27 GMT+08:00

POST /CCSQM/rest/ccisqm/v1/appraisecall/detail

场景描述

获取指定通话的质检结果接口

接口方法

POST

接口URI

https://域名/apiaccess/CCSQM/rest/ccisqm/v1/appraisecall/detail,例如域名是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_uuid

string

True

通话标识

可从details接口返回的结果获取call_uuid

响应说明

  • 响应状态码: 200
表3 响应体参数

序号

名称

参数类型

是否必选

说明

1.1

deal

number

False

交易是否达成

1.2

left_speed

number

False

左声道发话语速,发话方取决于left_channel字段

1.3

left_speech_ratio

number

False

左声道通话比例,发话方取决于left_channel字段

1.4

file_name

string

False

质检文件名称

1.5

left_channel

string

False

左声道发话方:客户,座席

1.6

right_speech_ratio

number

False

右声道通话比例,发话方取决于right_channel字段

1.7

call_time

number

False

通话开始时间

1.8

right_channel

string

False

右声道发话方:客户,座席

1.9

call_id

number

False

通话标识

1.10

left_silence_time

number

False

发话静音时间

1.11

segments

array[object]

False

ASR转写文本语段结果

1.11.1

asr_text

string

False

转写文本

1.11.2

speaker

string

False

发话方

1.11.3

start_time

number

False

发话开始时间

1.11.4

end_time

number

False

发话结束时间

1.11.5

segment_id

number

False

语段标识

1.11.6

status

number

False

通话状态

1.12

duration

number

False

通话时间

1.13

right_silence_time

number

False

发话静音时间,发话方取决于right_channel字段

1.14

upload_time

number

False

通话上传时间

1.15

rule_severity_violation_count

number

False

质检规则违反总数

1.16

left_emotions

array[object]

False

通话语气,只针对座席,取决于left_channel是否为座席

1.16.1

type

string

False

语气类型:积极,消极

1.16.2

score

number

False

语气评分

1.17

right_speed

number

False

右声道发话语速,发话方取决于right_channel字段

1.18

staff_id

string

False

座席人员的userId

可在登陆后,进入座席管理页面,查看接口返回的accountId

1.19

call_uuid

string

False

通话标识

1.20

call_type

number

False

质检通话类型:文本,音频

1.21

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.22

right_emotions

array[object]

False

通话语气,只针对座席,取决于right_channel是否为座席

1.22.1

type

string

False

语气类型:积极,消极

1.22.2

score

number

False

语气评分

  • 响应状态码: 400

    错误的请求:请检查请求路径及参数。

  • 响应状态码: 401

    未授权:1. 请确认是否购买了相关服务。 2. 请联系客服人员检查您账号的当前状态。

  • 响应状态码: 404

    请求的内容未找到:请检查请求的路径。

  • 响应状态码: 500

    业务失败:请依次确认您请求中各参数的取值。

错误码

无。

报文样例

  • 场景描述:获取指定通话的质检结果接口。

    请求头:

    x-app-key:************************************  
    X-UserID:1611917095665261978  
    Authorization:Bearer ********************************
    请求参数:
    {		
    	"call_uuid": "434l2j4242424jjl242"
    }

    响应参数:

    {
    	"staff_name": "xieyiling",
    	"left_speed": 324.068,
    	"create_time": 1635318854,
    	"left_speech_ratio": 0.6081,
    	"file_name": "1111",
    	"right_speech_ratio": 0.185,
    	"left_channel": "customer",
    	"call_time": 1635318854,
    	"right_channel": "staff",
    	"call_id": "17af55af-e51d-4cc0-8a62-84222e1d1eea",
    	"segments": [{
    		"start_time": 0.0,
    		"asr_text": "请问是您想询价吗",
    		"speaker": "customer",
    		"end_time": 11.32,
    		"segment_id": 1
    	}, {
    		"start_time": 13.36,
    		"asr_text": "对",
    		"speaker": "staff",
    		"end_time": 13.88,
    		"segment_id": 2
    	}, {
    		"start_time": 14.56,
    		"asr_text": "那您是打算在北京这边买车是吗",
    		"speaker": "customer",
    		"end_time": 16.74,
    		"segment_id": 3
    	}, {
    		"start_time": 18.74,
    		"asr_text": "是的",
    		"speaker": "staff",
    		"end_time": 19.68,
    		"segment_id": 4
    	}],
    	"left_silence_time": 40.8,
    	"duration": 104.12,
    	"right_emotions": [{
    		"score": 32.0,
    		"type": "negative"
    	}, {
    		"score": 69.0,
    		"type": "positive"
    	}],
    	"right_silence_time": 84.86,
    	"upload_time": 1635318854,
    	"left_emotions": [{
    		"score": 65.0,
    		"type": "negative"
    	}, {
    		"score": 80.0,
    		"type": "positive"
    	}],
    	"right_speed": 230.53,
    	"staff_id": "1679888582905592626",
    	"call_type": 0,
    	"status": 2
    }