华为云用户手册

样例报文 请求头： Content-Type: application/json;charset=UTF-8Authorization: ****************** 请求参数： { "ccId":1} 响应参数： { "result": "0", "resultCode": "0100000", "resultDatas": { "licenseMaxAgentNum": 4, "licenseMaxVideoAgentNum": 4294967295, "licenseMaxVdnNum": 10, "licenseMaxIvrCallNum": 4, "licenseMaxVoiceCallNum": 6, "licenseMaxWebCallNum": 4294967295, "loginAgentNum": 1, "loginVideoAgentNum": 4294967295, "vdnNum": 1, "ivrCallNum": 0, "voiceCallNum": 1, "webCallNum": 4294967295, "historyMaxAgentNum": 4294967295, "historyMaxVideoAgentNum": 4294967295, "historyMaxIvrCallNum": 4294967295, "historyMaxVoiceCallNum": 4294967295, "historyMaxWebCallNum": 4294967295, "licenseStartDate": 0, "licenseEndDate": 0 }, "resultDesc": { "licenseMaxAgentNum": 4, "licenseMaxVideoAgentNum": 4294967295, "licenseMaxVdnNum": 10, "licenseMaxIvrCallNum": 4, "licenseMaxVoiceCallNum": 6, "licenseMaxWebCallNum": 4294967295, "loginAgentNum": 1, "loginVideoAgentNum": 4294967295, "vdnNum": 1, "ivrCallNum": 0, "voiceCallNum": 1, "webCallNum": 4294967295, "historyMaxAgentNum": 4294967295, "historyMaxVideoAgentNum": 4294967295, "historyMaxIvrCallNum": 4294967295, "historyMaxVoiceCallNum": 4294967295, "historyMaxWebCallNum": 4294967295, "licenseStartDate": 0, "licenseEndDate": 0 }}

请求说明 表1 请求头参数 序号 名称 参数类型 是否必选 说明 1 Content-Type String True 固定填 application/json; charset=UTF-8。 2 Authorization String True 生成方式参见C2 监控/系统外呼/话单/知识库类接口鉴权方式。 表2 请求消息体参数说明 序号 名称 参数类型 是否必选 说明 1 ccId int True 呼叫中心编号。 取值范围：1～65535。

响应消息 表3 响应消息体参数说明 序号 名称 参数类型 说明 1 result String 查询结果。取值如下： 0：成功 其他：失败 失败的原因说明请参见错误码参考。 说明： 当前字段为兼容8.13及其之前版本接口响应参数使用。 2 resultCode string 查询结果。取值如下： "0100000"：成功 其他：失败 失败的原因说明请参见错误码参考。 3 resultDatas object 查询成功后，返回结果信息的对象。 该数组中对象的参数说明请参见表4。 说明： 当前字段为兼容8.13及其之前版本接口响应参数使用。 4 resultDesc object 查询成功后，返回结果信息的对象。 该数组中对象的参数说明请参见表4。 表4 resultDesc/resultDatas对象参数说明 序号 名称 参数类型 说明 2.1 licenseMaxAgentNum long License支持的最大签入座席数 2.2 licenseMaxVideoAgentNum long License支持的最大签入视频座席数 2.3 licenseMaxVdnNum long License支持的最大VDN个数 2.4 licenseMaxIvrCallNum long License支持的最大自动业务呼叫数 2.5 licenseMaxVoiceCallNum long License支持的最大语音呼叫数 2.6 licenseMaxWebCallNum long License支持的最大Web呼叫数 2.7 loginAgentNum long 当前签入座席数 2.8 loginVideoAgentNum long 当前签入视频座席数 2.9 vdnNum long 当前配置的VDN个数 2.10 ivrCallNum long 当前自动业务呼叫数 2.11 voiceCallNum long 当前语音呼叫数 2.12 webCallNum long 当前Web呼叫数 2.13 historyMaxAgentNum long 历史最大签入座席数 2.14 historyMaxVideoAgentNum long 历史最大签入视频座席数 2.15 historyMaxIvrCallNum long 历史最大自动业务呼叫数 2.16 historyMaxVoiceCallNum long 历史最大语音呼叫数 2.17 historyMaxWebCallNum long 历史最大Web呼叫数 2.18 licenseStartDate long License开始时间 2.19 licenseEndDate long License结束时间

响应消息 表3 响应消息体参数说明 参数名 数据类型 说明 resultCode string 查询结果。取值如下： "0100000"：成功 其他：失败 失败的原因说明请参见错误码参考。 resultDesc List 查询成功后，返回结果信息的对象列表。 该数组中对象的参数说明请参见表4。 表4 resultDesc对象参数说明 参数名 数据类型 说明 beginTime String 统计开始时间，毫秒级时间戳(五分钟统计区间开始时间) ccId int 呼叫中心编号 vdn int 虚拟呼叫中心编号 onlineAgentNums int 在线座席数（包含不接来话的座席数量） talkingNums int 通话座席数（不包含不接来话的座席数量） ideaAgentNum int 空闲坐席数（不包含不接来话的座席数量） busyNums int 示忙座席数（不包含不接来话的座席数量） restNums int 休息座席数（不包含不接来话的座席数量） incallNums int 五分钟内呼入呼叫数 rateNum int 五分钟内人工呼入接通数 callRate int 五分钟内人工呼入接通率 callOutNums int 五分钟内呼出呼叫数

样例报文 请求头： Content-Type: application/json;charset=UTF-8Authorization: ****************** 请求参数： { "ccId":1, "vdn":[1,2,3], "beginDate":"2021-09-09 00:00:00", "endDate":"2021-09-11 23:00:00", "limit":"100", "offset":"0"} 响应参数： { "resultCode": 0, "resultDesc": { "data": [ { "beginTime": "1631594100000", "ccId": 1, "vdn": 1, "onlineAgentNums": 1, "talkingNums": 1, "ideaAgentNum": 1, "busyNums": 1, "restNums": 1, "inCallNums": 1, "rateNum": 1, "callRate": 1, "callOutNums": 1 } ], "count": 6 }}

响应消息 表3 响应消息体参数说明 序号 名称 参数类型 说明 1 result String 查询结果。取值如下： 0：成功 其他：失败 失败的原因说明请参见错误码参考。 说明： 当前字段为兼容8.13及其之前版本接口响应参数使用。 2 resultCode string 查询结果。取值如下： "0100000"：成功 其他：失败 失败的原因说明请参见错误码参考。 3 resultDatas long CTI平台所在服务器UTC的时间戳。 说明： 当前字段为兼容8.13及其之前版本接口响应参数使用。 4 resultDesc long CTI平台所在服务器UTC的时间戳。

请求说明 表1 请求头参数 序号 名称 参数类型 是否必选 说明 1 Content-Type String True 固定填 application/json; charset=UTF-8。 2 Authorization String True 生成方式参见C2 监控/系统外呼/话单/知识库类接口鉴权方式。 表2 请求消息体参数说明 序号 名称 参数类型 是否必选 说明 1 ccId int True 呼叫中心编号。 取值范围：1～65535。

样例报文 请求头： Content-Type: application/json;charset=UTF-8Authorization: ****************** 请求参数： { "ccId":1} 响应参数： { "result": "0", "resultCode": "0100000", "resultDatas": 1605057110000, "resultDesc": 1605057110000}

请求说明 表1 请求头参数 序号 名称 参数类型 是否必选 说明 1 Content-Type string True 固定填 application/json; charset=UTF-8。 2 x-app-key string True appKey标识 3 Authorization string True 鉴权字段，内容格式为: Bearer +tokenByAKSK接口的返回值中AccessToken（Bearer后有空格） 4 x-UserId string True 操作员标识 表2 请求体参数 序号 名称 参数类型 是否必选 说明 1.1 id string True 设置档唯一标识

响应说明 响应状态码: 200 表3 响应体参数 序号 名称 参数类型 是否必选 说明 1.1 resultCode string False 返回码 0412000 表示成功 其他表示失败 1.2 resultDesc string False 返回描述 响应状态码: 400 错误的请求：请检查请求路径及参数。 响应状态码: 401 未授权：1. 请确认是否购买了相关服务。 2. 请联系客服人员检查您账号的当前状态。 响应状态码: 404 请求的内容未找到：请检查请求的路径。 响应状态码: 500 业务失败：请依次确认您请求中各参数的取值。

报文样例 场景描述：套用质检评分设置档。 请求头: x-app-key:************************************ X-UserID:1611917095665261978 Authorization:Bearer ******************************** 请求参数: {"id": "1828287446"} 响应参数: {"resultCode": "0412000"，"resultDesc": "操作成功"}

请求说明 表1 请求头参数 序号 名称 参数类型 是否必选 说明 1 Content-Type string True 固定填 application/json; charset=UTF-8。 2 x-app-key string True appKey标识 3 Authorization string True 鉴权字段，内容格式为: Bearer +tokenByAKSK接口的返回值中AccessToken（Bearer后有空格） 4 x-UserId string True 操作员标识 表2 请求体参数 序号 名称 参数类型 是否必选 说明 1.1 name string True 设置档名称 1.2 lower_bound number True 下限分数 1.3 upper_bound number True 上限分数 1.4 base number True 起始分数

响应说明 响应状态码: 200 表3 响应体参数 序号 名称 参数类型 是否必选 说明 1.1 id number True 设置档唯一标识 1.2 resultCode string False 返回码 0412000 表示成功 其他表示失败 1.3 resultDesc string False 返回描述 响应状态码: 400 错误的请求：请检查请求路径及参数。 响应状态码: 401 未授权：1. 请确认是否购买了相关服务。 2. 请联系客服人员检查您账号的当前状态。 响应状态码: 404 请求的内容未找到：请检查请求的路径。 响应状态码: 500 业务失败：请依次确认您请求中各参数的取值。

报文样例 场景描述：创建质检评分设置档。 请求头: x-app-key:************************************ X-UserID:1611917095665261978 Authorization:Bearer ******************************** 请求参数: {"name": "test"，"lower_bound": 11，"upper_bound": 111，"base": 11} 响应参数: {"resultCode": "0412000"，"id": "1828287446"，"resultDesc": "操作成功"}

请求说明 表1 请求头参数 序号 名称 参数类型 是否必选 说明 1 Content-Type string True 固定填 application/json; charset=UTF-8。 2 x-app-key string True appKey标识 3 Authorization string True 鉴权字段，内容格式为: Bearer +tokenByAKSK接口的返回值中AccessToken（Bearer后有空格） 4 x-UserId string True 操作员标识 表2 请求体参数 序号 名称 参数类型 是否必选 说明 1.1 id string True 设置档唯一标识

报文样例 场景描述：删除质检评分设置档。 请求头: x-app-key:************************************ X-UserID:1611917095665261978 Authorization:Bearer ******************************** 请求参数: {"id": "1828287446"} 响应参数: {"resultCode": "0412000"，"resultDesc": "操作成功"}

响应说明 响应状态码: 200 表3 响应体参数 序号 名称 参数类型 是否必选 说明 1.1 resultCode string False 返回码 0412000 表示成功 其他表示失败 1.2 resultDesc string False 返回描述 响应状态码: 400 错误的请求：请检查请求路径及参数。 响应状态码: 401 未授权：1. 请确认是否购买了相关服务。 2. 请联系客服人员检查您账号的当前状态。 响应状态码: 404 请求的内容未找到：请检查请求的路径。 响应状态码: 500 业务失败：请依次确认您请求中各参数的取值。

请求说明 表1 请求头参数 序号 名称 参数类型 是否必选 说明 1 Content-Type String True 固定填 application/json; charset=UTF-8。 2 Authorization String True 生成方式参见C2 监控/系统外呼/话单/知识库类接口鉴权方式。 表2 消息体参数说明 参数名 数据类型 选取原则 说明 say(可以修改) object True 请求报文，代码中不会对这个报文做任何处理，会回写到响应消息体中。

报文样例 请求头： Content-Type: application/json;charset=UTF-8Authorization: ****************** 请求参数： { "say": "Hello world!"} 该接口的响应消息体举例如下： { "request": { "say": "Hello world!" }, "status": "UP"}

请求说明 表1 请求头参数 序号 名称 参数类型 是否必选 说明 1 Content-Type string True 固定填 application/json; charset=UTF-8。 2 x-app-key string True appKey标识 3 Authorization string True 鉴权字段，内容格式为: Bearer +tokenByAKSK接口的返回值中AccessToken（Bearer后有空格） 4 x-UserId string True 操作员标识 表2 请求体参数 序号 名称 参数类型 是否必选 说明 1.1 id string True 设置档唯一标识 1.2 name string True 设置档名称 1.3 lower_bound number True 下限分数 1.4 upper_bound number True 上限分数 1.5 base number True 起始分数

响应说明 响应状态码: 200 表3 响应体参数 序号 名称 参数类型 是否必选 说明 1.1 resultCode string False 返回码 0412000 表示成功 其他表示失败 1.2 resultDesc string False 返回描述 响应状态码: 400 错误的请求：请检查请求路径及参数。 响应状态码: 401 未授权：1. 请确认是否购买了相关服务。 2. 请联系客服人员检查您账号的当前状态。 响应状态码: 404 请求的内容未找到：请检查请求的路径。 响应状态码: 500 业务失败：请依次确认您请求中各参数的取值。

报文样例 场景描述：修改质检评分设置档。 请求头: x-app-key:************************************ X-UserID:1611917095665261978 Authorization:Bearer ******************************** 请求参数: {"id": "1980058583"，"name": "1"，"lower_bound": 10，"upper_bound": 100，"base": 10，} 响应参数: {"resultCode": "0412000"，"resultDesc": "操作成功"}

报文样例 场景描述：质检评分设置档查询。 请求头: x-app-key:************************************ X-UserID:1611917095665261978 Authorization:Bearer ******************************** 请求参数: {"page": 1，"limit": 10000} 响应参数: {"fundamental_score": [{"lower_bound": 1，"name": "default"，"upper_bound": 100，"id": "0"，"base": 60}， {"lower_bound": 10，"name": "1"，"upper_bound": 100，"id": "1980058583"，"base": 10}， {"lower_bound": 11，"name": "test"，"upper_bound": 111，"id": "1828287446"，"base": 11}]，"using": "1828287446"，"resultCode": "0412000"，"resultDesc": "操作成功"}

响应说明 响应状态码: 200 表3 响应体参数 序号 名称 参数类型 是否必选 说明 1.1 using string True 正在套用的设置档id 1.2 fundamental_score array[object] True 设置档数据列表 1.2.1 id number False 设置档唯一标识 1.2.2 lower_bound number False 下限分数 1.2.3 upper_bound number False 上限分数 1.2.4 base number False 起始分数 1.2.5 name string False 设置档名称 1.3 resultCode string False 返回码 0412000 表示成功 其他表示失败 1.4 resultDesc string False 返回描述 响应状态码: 400 错误的请求：请检查请求路径及参数。 响应状态码: 401 未授权：1. 请确认是否购买了相关服务。 2. 请联系客服人员检查您账号的当前状态。 响应状态码: 404 请求的内容未找到：请检查请求的路径。 响应状态码: 500 业务失败：请依次确认您请求中各参数的取值。

报文样例 场景描述：移动句子到指定分类 请求头: x-app-key:************************************ X-UserID:1611917095665261978 Authorization:Bearer ******************************** 请求参数: {"sentenceIds": "14161，14171"，"category_id": "894378237264662528"} 响应参数: {"resultCode": "0403000"，"resultDesc": "操作成功"}

请求说明 表1 请求头参数 序号 名称 参数类型 是否必选 说明 1 Content-Type string True 固定填 application/json; charset=UTF-8。 2 x-app-key string True appKey标识 3 Authorization string True 鉴权字段，内容格式为: Bearer +tokenByAKSK接口的返回值中AccessToken（Bearer后有空格） 4 x-UserId string True 操作员标识 表2 请求体参数 序号 名称 参数类型 是否必选 说明 1.1 page number True 偏移量 1.2 limit number True 每页数据量限制

请求说明 表1 请求头参数 序号 名称 参数类型 是否必选 说明 1 Content-Type string True 固定填 application/json; charset=UTF-8。 2 x-app-key string True appKey标识 3 Authorization string True 鉴权字段，内容格式为: Bearer +tokenByAKSK接口的返回值中AccessToken（Bearer后有空格） 4 x-UserId string True 操作员标识 表2 请求体参数 序号 名称 参数类型 是否必选 说明 1.1 sentenceIds string True 句子的唯一标识 1.2 category_id string True 分类的唯一标识

报文样例 场景描述：删除句子 请求头: x-app-key:************************************ X-UserID:1611917095665261978 Authorization:Bearer ******************************** 请求参数: {"sentence_id": "14412"} 响应参数: {"resultCode": "0403000"，"resultDesc": "操作成功"}

响应说明 响应状态码: 200 表3 响应体参数 序号 名称 参数类型 是否必选 说明 1 resultCode string False 返回码 0403000 表示成功 其他表示失败 2 resultDesc string False 返回描述 响应状态码: 400 错误的请求：请检查请求路径及参数。 响应状态码: 401 未授权：1. 请确认是否购买了相关服务。 2. 请联系客服人员检查您账号的当前状态。 响应状态码: 404 请求的内容未找到：请检查请求的路径。 响应状态码: 500 业务失败：请依次确认您请求中各参数的取值。

请求说明 表1 请求头参数 序号 名称 参数类型 是否必选 说明 1 Content-Type string True 固定填 application/json; charset=UTF-8。 2 x-app-key string True appKey标识 3 Authorization string True 鉴权字段，内容格式为: Bearer +tokenByAKSK接口的返回值中AccessToken（Bearer后有空格） 4 x-UserId string True 操作员标识 表2 请求体参数 序号 名称 参数类型 是否必选 说明 1.1 sentence_id string True 句子的唯一标识