华为云用户手册

响应消息 表3 响应消息体参数说明 参数名 数据类型 说明 resultCode String 查询结果。取值如下： "0100000"：成功 其他：失败 失败的原因说明请参见错误码参考。 resultDesc List 查询成功后，返回结果信息的对象列表。 该数组中对象的参数说明请参见表4。 10.xx.xx.xx#0 String 10.xx.xx.xx：UAP IP “#”：固定分隔符 “0”：UAP编号 表4 resultDesc对象参数说明 参数名 数据类型 说明 RET String 采集该数据结束时间 RNAT12 String 久叫不应次数 busy circuits (TIMES) String 忙电路数 ASD32 String 平均占用时长（秒） ITAR19 String 入中继可用率 CLBT40 String 被叫忙（市话或称本地通话） MEID String 设备ID UBC43 String 电路闭塞个数 CCT34 String 对端拥塞造成呼叫失败数 LCOICT7 String 本局内部拥塞呼损 IO CS 44 String 入局CAPS统计值 MOIID String 测量对象类ID CCT3 String 接通次数 CDA9 String 拥塞时长辅助量 AART11 String 振铃早释次数，即主叫用户在呼叫接通或结束前挂机的次数。 TAT6 String 转接应答次数。 转接应答，指接听应答的用户非本局用户。 Period String 周期 TCAT5 String 落地应答次数 落地应答，指接听应答的用户为本局用户。 AR21 String 应答率 TCAT2 String 转接试占次数 TCAT1 String 落地试占次数 ICN13 String 安装电路数 ECT35 String 拨打空号的次数 incoming direction String 0(anonymous)：0表示入局ID，anonymous表示名称 IBCN16 String 安装双向电路数 ACN14 String 可用电路数 TCT42 String 转接占用次数 IAT36 String 无效的地址的次数 Credible String 是否可信 CFORT39 String 被叫没有权限 RT String 采集改数据时间 ST26 String 占用话务量 Time String 次数 average answer duration (SECOND) String 平均接通响应时长 AT30 String 应答话务量 TUT37 String 终端不兼容的次数 BCN15 String 闭塞电路数 BBCR23 String 双向电路闭塞率 CTBT41 String 被叫长忙次数 BTST24 String 双向中继占用话务量 BTSTA25 String 双向中继占用话务量辅助量 ABCN17 String 可用双向电路数 CTA29 String 接通话务量辅助量 AT4 String 应答次数 EROC46 String 电路占用率 TET38 String 终端错误的次数 CT28 String 接通话务量 SOIC45 String 空闲电路数 ST0 String 占用次数 BCR22 String 闭塞率 ABRT33 String 呼叫早释次数 CR20 String 接通率 BBCN18 String 闭塞双向电路数 CD8 String 拥塞时长 ATA31 String 应答话务量辅助量 CBT10 String 被叫忙 STA27 String 占用话务量辅助量 average connection duration (MILLISECOND) String 平均连接时长 answer duration aux (TIMES) String 应答响应总时长辅助量

响应消息 表3 响应消息体参数说明 参数名 数据类型 说明 resultCode string 查询结果。取值如下： "0100000"：成功 其他：失败 失败的原因说明请参见错误码参考。 resultDesc List 查询成功后，返回结果信息的对象列表。 该数组中对象的参数说明请参见表4。 10.xx.xx.xx#1 String 10.xx.xx.xx：UAP IP “#”：固定分隔符 “1”：UAP编号 表4 resultDesc对象参数说明 参数名 数据类型 说明 data list 数据结果集，参数说明请参考表5。 count int 总记录数 表5 data对象参数说明 参数名 数据类型 说明 ccuModuleNumber string CCU模块号 terminationType string 终端类型 equipmentId string 设备标识 registerStatus string 注册状态：registered 已注册 not register 未注册 socketStatus string SOCKET状态： fault 故障 normal 正常 connecting 连接中 uninstall 未配置 ipAndPort string ip和Port monitorFlag string 座席状态监控标志： unstarted 未启动 started已启动 protocolType string 协议类型 roamIpAndPort string 漫游ip地址和端口 tlsStatus string TSL状态：unconnect 未连接 connect 连接 uninstall 未配置 ipType string ip类型

样例报文 请求头： Content-Type: application/json;charset=UTF-8Authorization: ****************** 请求参数： { "ccId":1, "EID": "8888*", "limit":"100", "offset":"0"} 响应参数： { "resultCode": "0100000", "resultDesc": { "data": { "10.xx.xx.xx#1": [ { "socketStatus": "uninstall", "terminationType": "sip", "ipAndPort": "0.0.0.0:0", "ccuModuleNumber": "56", "registerStatus": "not register", "monitorFlag": "unstarted", "protocolType": "invalid protocol", "equipmentId": "88881757", "roamIpAndPort": "0.0.0.0:0", "tlsStatus": "uninstall", "ipType": "IPv4" } ], "10.xx.xx.xx#2": [ { "socketStatus": "uninstall", "terminationType": "sip", "ipAndPort": "0.0.0.0:0", "ccuModuleNumber": "56", "registerStatus": "not register", "monitorFlag": "unstarted", "protocolType": "invalid protocol", "equipmentId": "88881757", "roamIpAndPort": "0.0.0.0:0", "tlsStatus": "uninstall", "ipType": "IPv4" } ] }, "count": 1 }}

样例报文 请求头： Content-Type: application/json;charset=UTF-8Authorization: ****************** 请求参数： { "ccId": "89", "vdn":92, "taskId":"1122104910" } 响应参数： { "resultCode": "0100000", "resultDesc": { "compCount": "4", "failCount": "2", "compRate": "50%", "execCount": "0", "succCount": "2", "succRate": "50%", "totalCount": "4", "waitCount": "0" }

响应消息 表3 消息体参数说明 参数名 数据类型 说明 resultCode string 查询结果。取值如下： "0100000"：成功 其他：失败 失败的原因说明请参见错误码参考。 resultDesc array 查询成功后，返回结果信息的对象数组。 该接口的响应消息体参数说明请参考表4 表4 响应消息体参数说明 参数名 数据类型 说明 totalCount int 日外呼量。 succCount int 成功呼叫数（接通量）。 failCount int 失败呼叫数。 succRate String 成功率（接通率）。 compCount int 完成呼叫数。 waitCount int 等待呼叫数。 execCount int 执行中呼叫数。 compRate String 完成率。

样例报文 请求头： Content-Type: application/json;charset=UTF-8Authorization: ****************** 请求参数： { "MODTYP":"CCU", "PID":"CCB", "MN":"56", "ccId":1} 响应参数： { "resultCode": "0100000", "resultDesc": { "10.xx.xx.xx#0": { "Alerting CB number": "0", "Null after combine CB number": "0", "IDC switch index": "1", "Wait tone CB number": "0", "Release guard CB number": "0", "Release waiting CB number": "0", "Booked CB number": "0", "Temply hold CB number": "0", "Active CB number": "0", "Info receiving status number": "3", "Call park CB number": "0", "Null CB number": "9997", "Overlap transmit number": "0", "Call proceeding number": "0", "Wait overlap CB number": "0", "Connection request CB number": "0" } }}

响应消息 表3 响应消息体参数说明 参数名 数据类型 说明 resultCode String 查询结果。取值如下： "0100000"：成功 其他：失败 失败的原因说明请参见错误码参考。 resultDesc List 查询成功后，返回结果信息的对象列表。 该数组中对象的参数说明请参见下表。 10.xx.xx.xx#0 String 10.xx.xx.xx：UAP IP “#”：固定分隔符 “0”：UAP编号 表4 resultDesc对象参数说明（设置“模块类型”为“CCU”，“CCU模块ID”为“CCB”，“CCU模块号”为“57”） 参数名 数据类型 说明 IDC switch index String 在线指示 Null CB number String 处于NULL状态的控制块个数 Booked CB number String 忙电路数 Info receiving status number String 处于信息接收的控制块个数 Wait overlap CB number String 处于WAITOVERLAP状态的个数 Overlap transmit number String 处于Overlap transmit的个数 Call proceeding number String 处于CALLPROCEEDIN的个数 Alerting CB number String 处于ALERTING状态的个数 Connection request CB number String 处于连接请求的个数 Active CB number String 处于激活状态的个数 Release guard CB number String 处于Release guard的个数 Release waiting CB number String 处于释放等待的个数 Temply hold CB number String 处于Temply hold状态的个数 Wait tone CB number String 处于等待tone音的个数 Null after combine CB number String 处于NULLAFTERCOMBINE的个数 Call park CB number String 处于Call park的控制块个数 表5 resultDesc对象参数说明（设置“模块类型”为“CCU”，“CCU模块ID”为“INTESS”，“CCU模块号”为“56”） 参数名 数据类型 说明 Last allocated INTESS number String 上次分配的INTESS控制块号 Error stat flag String 错误原因统计开关 Error stat interval String 错误原因统计周期 Message statistics flag String 消息统计开关 Message statistics interval String 消息统计周期 Message statistics mask String 消息统计掩码 Idle CB number String 处于IDLE状态的控制块个数 Overlap CB number String 处于OVERLAP状态的控制块个数 Call delivered CB number String 处于CALLDELIVERED状态的控制块个数 Call present CB number String 处于CALLPRESENT状态的控制块个数 Call received String 处于CALLRECEIVED状态的控制块个数 Connection request CB number String 处于连接请求状态的控制块个数 Active CB number String 处于ACTIVE状态的控制块个数 SPACTIVE CB number String 处于SPACTIVE状态的控制块个数 CB number in INTESS_spy state String 处于INTESS_SPY状态的控制块个数 Wait REL CB number String 处于WAITREL状态的控制块个数 表6 resultDesc对象参数说明（设置“模块类型”为“MSU”，“PIDMSU模块ID”为“BSI”，“MSUMN模块号”为“472”） 参数名 数据类型 说明 Total number of connections String 连接总数 Total no of connection in IDLE state String 空闲状态连接总数 Total no of connection in CREATE CONNECT state String 正在创建状态的连接总数 Total no of connection in CONNECT state String 已经连接状态连接总数 Total no of connection in DELETE CONNECT state String 删除状态连接总数 Total no of connection in MODIFY CONNECT state String 修改状态连接总数 Total no of connection having service type as IVR String IVR业务连接总数 Total no of connection having service type as CONF String 会场业务连接总数 Total no of connection having service type as CONF CHAN String 会场通道业务连接总数 Total no of conf connection in IDLE state String 空闲状态会场连接总数 Total number of Conf connections String 会场连接总数 Total no of conf connection in CREATE CONF state String 正在创建状态会场连接总数 Total no of conf connection in CONF USING state String 使用状态会场连接总数 Total no of conf connection in CONF DELETE state String 删除状态会场连接总数

样例报文 请求头： Content-Type: application/json;charset=UTF-8Authorization: ****************** 请求参数： { "ccId":1, "uapIP":"1.1.1.1", "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,"uapIp": "1.1.1.1","agentOnlineCount": 1 } ], "count": 1 }}

响应消息 表3 响应消息体参数说明 参数名 数据类型 说明 resultCode String 查询结果。取值如下： "0100000"：成功 其他：失败 失败的原因说明请参见错误码参考。 resultDesc List 查询成功后，返回结果信息的对象列表。 该数组中对象的参数说明请参见表4。 表4 resultDesc对象参数说明 参数名 数据类型 说明 beginTime String 统计开始时间，毫秒级时间戳(五分钟统计区间开始时间) ccId int 呼叫中心编号 uapIp String UAP的IP agentOnlineCount int 软终端注册数

样例报文 请求头： Content-Type: application/json;charset=UTF-8Authorization: ****************** 请求参数： { "ccId":1, "uapIP":"1.1.1.1", "ofcNo":[0, 1], "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, "uapIp": "1.1.1.1", "ofcNo": 1, "systemInBound": 1, "systemInSucc": 1, "systemCallRate": 1 } ], "count": 1 }}

响应消息 表3 响应消息体参数说明 参数名 数据类型 说明 resultCode string 查询结果。取值如下： "0100000"：成功 其他：失败 失败的原因说明请参见错误码参考。 resultDesc List 查询成功后，返回结果信息的对象列表。 该数组中对象的参数说明请参见表4。 表4 resultDesc对象参数说明 参数名 数据类型 说明 beginTime String 统计开始时间，毫秒级时间戳(五分钟统计区间开始时间) ccId int 呼叫中心编号 uapIp String UAP的IP ofcNo int 入局编号数组 systemInBound int 系统呼入量 systemInSucc int 系统接通量 systemCallRate int 系统接通率

样例报文 请求头： 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"}