华为云用户手册

响应说明 响应状态码: 200 表3 响应体参数 序号 名称 参数类型 是否必选 说明 1.1 returnCode string False 返回码，0成功，非0失败 1.2 description string False 返回描述 1.3 data object False 手机号码归属地信息 1.3.1 areaCode string False 地区码 1.3.2 province string False 省 1.3.3 city string False 城市 1.3.4 cityCode string False 城市编码，可能多个，"/"分隔，如果查询的是固话，城市编码可能为空 1.3.5 isp string False 运营商：电信、移动、联通。 如果是固话查询则返回未知 1.3.6 postCode string False 邮政编码，可能多个，"/"分隔，如果查询的是固话，邮政编码可能为空 1.3.7 phoneNo string False 手机号码前7位，或者固话区号 响应状态码: 401 授权失败：1. 参数是否正确有效。 2. 请确认是否购买了相关服务。 3. 请联系客服人员检查您账号的当前状态。 响应状态码: 404 请求路径可能不对。 响应状态码: 500 参数不对导致业务失败或者服务端内部异常。

请求说明 表1 请求头参数 序号 名称 参数类型 是否必选 说明 1 X-APP-KEY string False appKey字段，用户标识，请联系运营人员获取appKey 2 Authorization string True 鉴权字段，内容格式为: Bearer +tokenByAKSK接口的返回值中AccessToken（Bearer后有空格） 表2 请求体参数 序号 名称 参数类型 是否必选 说明 1.1 phoneNo string True 查询的11位手机号码，或者带区号固话。

报文样例 请求头: Content-Type: application/jsonX-APP-KEY: **************************************Authorization: Bearer ************************************** 请求参数: {"phoneNo":"13020017****"} 响应参数: { "returnCode": "0"， "data": { "areaCode": "110100"， "province": "北京"， "city": "北京"， "cityCode": "010"， "isp": "联通"， "postCode": "100000"， "phoneNo": "1302001" }， "description": "success"}

报文样例 请求头: Content-Type:application/jsonAuthorization:Bearer XXXXXXXXXXXXXXXXXXXXXXXX-APP-Key:XXXXXXXXXXXXXXXXXXXXXXX 响应参数: { "result": [ { "isLoad": 1， "accessCode": "90500"， "maxCallNum": null， "description": "异常处理"， "id": 1， "flowFileName": "defaultIVR.GSL"， "flowType": 1 }， { "isLoad": 1， "accessCode": "90501"， "maxCallNum": null， "description": "1015"， "id": 2， "flowFileName": "defaultIVR.GSL"， "flowType": 1 } ]， "retCode": "0"， "message": "success"}

响应说明 响应状态码: 200 表2 响应体参数 序号 名称 参数类型 是否必选 说明 1 schema object True - 1.1 result array[object] False IVR信息 1.1.1 isLoad number False 流程是否加载 0：否 1：是 1.1.2 accessCode string False 流程接入码 1.1.3 maxCallNum integer False 流程最大并发呼叫数 1.1.4 description string False 流程描述 1.1.5 id number False 流程编号 1.1.6 flowFileName string False 流程文件名 1.1.7 flowType number False 流程类型 0：未明确的业务类型 1：GSL业务文件类型 2：VoiceXML业务文件类型 3：第三方IVR的业务类型 4：CCIVR支持的VXML流程 5：CCXMLL流程 6：WaitScript流程 1.2 retCode string False 返回码 0：成功 其他：失败 1.3 message string False 返回信息 响应状态码: 400 错误的请求：请检查请求路径及参数 响应状态码: 401 未授权：1. 请确认是否购买了相关服务。 2. 请联系客服人员检查您账号的当前状态。 响应状态码: 403 鉴权失败 响应状态码: 404 请求的内容未找到：请检查请求的路径。 响应状态码: 500 业务失败：请依次确认您请求中各参数的取值。

报文样例 请求头: x-app-key:9******************************3 Authorization:Bearer e******************************e Content-Type:application/json 请求参数: {"caller": "88889050","called": "88889060", "agentWorkNo": "", "callData": "333333","callerPresent": "640003","agentPresent": "640060","callBackUrl": ""} 响应头: {"connection": "keep-alive","content-type": "application/json;charset=UTF-8"} 响应参数: {"retMsg": "Add CallOutInfo in DB successfully","retCode": "0"}

请求说明 表1 请求头参数 序号 名称 参数类型 是否必选 说明 1 X-APP-Key string False appKey字段，用户标识 2 Authorization string False 鉴权字段，内容格式为: Bearer +tokenByAKSK接口的返回值中AccessToken（Bearer后有空格） 表2 请求体参数 序号 名称 参数类型 是否必选 说明 1 caller string True 主叫号码，客户经理手机号码，或是软电话号码 长度限制：string（32） 2 called string True 被叫号码 长度限制：string（32） 3 agentWorkNo decimal False 发起双呼的座席的工号。 长度限制：decimal（5） 4 callData string False 呼叫数据 长度限制：string（1024） 说明： ITA双呼不支持callData字段。 5 callerPresent string False 用户侧主叫显示号码，用户看到的主叫号码，不携带的情况下默认采用租间的接入码，携带的情况下该号码必须传接入码。如果需要传非接入码号码，请联系运维人员开通主叫透显特性，该特性开通后号码校验规则为：接入码或者11-14位的数字。 说明： ITA双呼不支持callerPresent字段。 6 agentPresent string False 座席侧主叫显示号码，客户经理看到的主叫号码，不携带的情况下默认采用租间的接入码，携带的情况下该号码必须传接入码。如果需要传非接入码号码，请联系运维人员开通主叫透显特性，该特性开通后号码校验规则为：接入码或者11-14位的数字。 说明： ITA双呼不支持agentPresent字段。 7 callBackUrl string False 此参数请采用BASE64编码进行加密。 此字段用于设置客户接收状态上报的挂机回调URL。 云客服CEC平台将业务触发过程中通话的状态信息推送至此服务器，客户服务器根据通话状态信息确定用户状态。 URL可填写为https://IP:Port或域名，推荐使用域名，支持http和https。http为不安全协议，请谨慎使用。且该域名对应多个服务器，避免单点故障无法接收通知。 URL只能由大小写字母（a-z、A-Z），数字（0-9）， - : . / _ # ? &组成，不支持其它字符。

响应说明 响应状态码: 200 表3 响应体参数 序号 名称 参数类型 是否必选 说明 1.1 retCode string True 0：成功，其他为失败 1 ：添加外呼任务失败，外呼数据库中可能已存在相同外呼任务 2 ：呼叫数据信息 3 ：未查询出呼叫流水号字段 5 ：主被叫或外显号码格式不符 6 ：VDN不可用 8 ：主叫号码不在租户所分配的移动座席使用的软电话号码范围内 16 ：试用租户的座席侧号码未在白名单内 21 ：试用租户一键双呼超过每天10次限制 针对ITA双呼还有一些retCode，请参见表4 1.2 retMsg string True 失败原因的描述 1.3 result object False 返回结果 1.3.1 callSerialNo number False 呼叫流水号 表4 针对ITA双呼的retcode说明 retcode retMsg 说明 90100100 Invalid Input Parameter 请求报文不正确。如缺少参数或者不支持的参数 90100200 Auth Failed 请求的来源或者请求的签名未通过校验 90100300 Bad Request 错误请求 90100400 Not found 请求资源不存在 90100600 Internal Server Error 系统内部错误 90102001 Insufficient Balance 额度不足 90102002 Request Restriction 请求限制 90104001 Insufficient Permission 权限不足 90104003 Request Forbidden 请求被禁止 90104004 Service Unavailable 不支持的业务功能或者未实现 90104008 Service Process Failure 业务处理超时或者处理失败 90104029 Too Many Requests 请求过多 90106001 Binding relationship already exists 小号绑定关系已存在 90106002 Binding relationship not exists 小号绑定关系不存在 90106003 Insufficient Number resources 小号号码池资源不足 90106004 No corresponding number found 未找到可用小号 90106005 Inconsistent binding data 小号绑定数据不一致 90106006 Other Error 小号其他原因导致错误 90106010 Policy Forbid 策略禁止 90106011 Caller Forbid 主叫限制 90106012 Callee forbid 被叫限制 响应状态码: 400 错误的请求：请检查请求路径及参数。 响应状态码: 401 未授权：1.请确认是否购买了相关服务。2.请联系客服人员检查您账号的当前状态。 响应状态码: 404 请求的内容未找到：请检查请求的路径。 响应状态码: 500 业务失败：请依次确认您请求中各参数的取值。

响应说明 响应状态码: 200 表2 响应体参数 序号 名称 参数类型 是否必选 说明 1 schema object True - 1.1 returnCode string True 返回码，0成功，非0失败 1.2 description string False 返回描述 1.3 enabled boolean True 是否开启满意度调查。true：已开启，false：未开启。未开启时data为空。 1.4 data array[object] False 目前只返回一个数据。 1.4.1 ivrId string False IVR流程ID 1.4.2 feedbackType string False IVR：表示是IVR类型的流程，目前只有一个值。 1.4.3 channelType string False audio：音频 media：多媒体 目前取值只有audio 1.4.4 accessCode string False 流程接入码 响应状态码: 401 授权失败：1. 参数是否正确有效。 2. 请确认是否购买了相关服务。 3. 请联系客服人员检查您账号的当前状态。 响应状态码: 404 请求路径可能不对。 响应状态码: 500 参数不对导致业务失败或者服务端内部异常。

报文样例 请求头: X-APP-KEY: ****************************Authorization: Bearer ******************************* 响应参数: { "returnCode": "0"， "data": [ { "accessCode": "6001"， "channelType": "audio"， "feedbackType": "IVR"， "ivrId": "1239554736420597767" } ]， "description": "success"， "enabled": true}

报文样例 请求头: x-app-key:9******************************3Authorization:Bearer e******************************eContent-Type:application/json 请求参数: {"startTime": "1562786332000","endTime": "1563391072000","taskType": "0","offset": 0,"limit": 10} 响应头: {"connection": "keep-alive","content-type": "application/json;charset=UTF-8"} 响应参数: {"result": {"total": 11,"callInfo": [{"releaseTime": 1621577022000,"called": "88889060","callerPresent": "640003","agentAlertingTime": 1621576992000,"agentPresent": "640060","talkingTime": 1621576995000,"alertingTime": 1621576994000,"caller": "88889050","agentTalkingTime": 1621576994000,"agentReleaseTime": 1621577022000,"agentTalkDuration": 27,"callSerialNo": "1037058396471308289","startTime": 1621576992000,"endTime": 1621577022000,"talkDuration": 26,"state": 3,"reasonCode": 1}]},"retCode": "0","retMsg": "Query call detail record successfully"}

请求说明 表1 请求头参数 序号 名称 参数类型 是否必选 说明 1 X-APP-Key string False appKey字段，用户标识 2 Authorization string True 鉴权字段，内容格式为: Bearer +tokenByAKSK接口的返回值中AccessToken（Bearer后有空格） 表2 请求体参数 序号 名称 参数类型 是否必选 说明 1 body body False 请求体参数 表3 body参数结构 序号 名称 参数类型 是否必选 说明 1.1 endTime string True 结束时间，开始时间到结束时间不超过7天，时间戳，如1572794607000 1.2 offset string False 分页查询偏移量，默认值0，即不需要偏移 ,非必选 1.3 limit string False 分页查询时单页最多的记录条数，默认值100，即每页显示100条，非必选 1.4 startTime string True 起始时间，时间戳，如1572794607000 1.5 caller string False 主叫号码，可选，不填写默认查询所有 长度限制：string (32) 1.6 taskType string False 0：全部类型任务(除ITA双呼) 1：云客服双呼任务 2：查询匿名外呼任务 3：语音通知 4：ITA双呼

响应说明 响应状态码: 200 表4 响应体参数 序号 名称 参数类型 是否必选 说明 1.1 retCode string True 0 ：成功，其他为失败 1 ：未查询到数据 2 ：起止时间格式不符 4： limit或offset分页数据格式不符 12： 主叫号码不可用 1.2 retMsg string True 失败原因的描述 1.3 result object False 返回结果 1.3.1 total number False 总记录数 1.3.2 callInfo array[object] False 记录列表 1.3.2.1 callSerialNo string False 呼叫序列号，唯一标识一次外呼呼叫 长度限制：string (50) 1.3.2.2 caller string False 主叫号码 长度限制：string (32) 1.3.2.3 called string False 被叫号码 长度限制：string (32) 1.3.2.4 startTime string False 外呼开始时间，时间戳，如1572794607000 1.3.2.5 endTime string False 通话结束时间，时间戳，如1572794607000 1.3.2.6 state number False 呼叫状态： 0：待呼叫 1：正在呼叫 2：通话中 3：通话结束 长度限制：number（1） 1.3.2.7 reasonCode number False 通话结束原因码： 0~65535， 0: 被叫挂机，通话结束 1：主叫挂机，通话结束 2：外呼主叫失败 3：外呼被叫失败 4：外呼主叫无应答 5：外呼被叫无应答 6：启动呼叫失败 xxx：其他异常 长度限制：number（5） 针对ITA双呼还有一些reasonCode，请参见表5 1.3.2.8 callData string False 第三方自定义的呼叫数据信息 长度限制：string（1024） 1.3.2.9 callerPresent string False 外显号码，来电显示的号码 长度限制：string（32） 1.3.2.10 alertingTime string False 客户振铃时间，时间戳，如1572794607000 1.3.2.11 talkingTime string False 客户通话时间，时间戳，如1572794607000 1.3.2.12 releaseTime string False 客户释放时间，时间戳，如1572794607000 1.3.2.13 talkDuration string False 用户通话时长（秒） 1.3.2.14 agentAlertingTime string False 座席振铃时间，时间戳，如1572794607000 1.3.2.15 agentTalkingTime string False 座席通话时间，时间戳，如1572794607000 1.3.2.16 agentReleaseTime string False 座席释放时间，时间戳，如1572794607000 1.3.2.17 agentTalkDuration string False 座席通话时长（秒） 1.3.2.18 taskType string False 0：全部类型任务(除ITA双呼) 1：云客服双呼任务 2：查询匿名外呼任务 3：语音通知 4：ITA双呼 1.3.2.19 agentPresent string False 外显号码，客户经理来电显示的号码 长度限制：string（32） 表5 针对ITA双呼的reasonCode说明 retCode 原因值描述 0 不涉及 1 无法找到号码 2 无法路由到网络 3 无法路由到目的地 4 发送特殊消息 5 中继前缀出错 6 通道无法接入 7 已经建立频道 8 抢先占有 9 抢先占有保留 16 正常呼叫清除 17 用户忙 18 无应答 19 无用户应答 20 用户不可及 21 拒绝呼叫 22 号码已改变 23 重定向 25 交换路由错误 26 无用户准许 27 目标无序 28 非法号码格式 29 设备拒绝 30 状态查询 31 正常 34 路由不可达 38 网络状态不好 39 服务链接不上 40 链接进行中 41 暂时失败 42 设备拥塞 43 信息丢弃 44 通道无法接入 46 呼叫阻塞 47 无可用资源 49 品质无效 50 设备没预订 53 闭合群OCB呼出受限 55 闭合群ICB呼入受限 57 无权限发送 58 发送无效 62 等级不一致 63 服务无效 65 发送无法执行 66 通道无法执行 69 设备无效 70 发送有效 79 CV服务没设置 81 引用非法值 82 通道不存在 83 ID不存在 84 呼叫ID不存在 85 无呼叫等待 86 隐藏号码呼叫 87 CUG无成员 88 目标冲突 90 CUG不存在 91 无效网络 95 无效信息 96 非托管元素 97 类型不存在 98 信息没执行 99 信息单元不存在 100 无效的信息单元 101 呼叫状态不一致 102 定时器超时 103 参数不存在 110 消息中带有未识别的参数 111 协议错误 127 未指定的交互 响应状态码: 400 错误的请求：请检查请求路径及参数。 响应状态码: 401 未授权：1. 请确认是否购买了相关服务。 2. 请联系客服人员检查您账号的当前状态。 响应状态码: 404 请求的内容未找到：请检查请求的路径。 响应状态码: 500 业务失败：请依次确认您请求中各参数的取值。

报文样例 请求头: x-app-key:9******************************3Authorization:Bearer 9******************************7Content-Type:application/json 请求参数: { "caller": 8888888,"softPhone": 66666666 "called": 6666614} 响应参数: {"retMsg": "Called is not configured","retCode": "5"}

请求说明 表1 请求头参数 序号 名称 参数类型 是否必选 说明 1 X-APP-Key string False appKey字段，用户标识 2 Authorization string False 鉴权字段，内容格式为: Bearer +tokenByAKSK接口的返回值中AccessToken（Bearer后有空格） 表2 请求体参数 序号 名称 参数类型 是否必选 说明 1.1 caller string False 主叫号码，客户经理手机号码，或是软电话号码 长度限制：string（32） 1.2 softPhone string True 软电话号码（座席对应） 长度限制：string（32） 1.3 called string True 被叫号码 长度限制：string（32） 1.4 callData string False 呼叫数据 长度限制：string（1024） 说明： ITA双呼不支持callData字段。 1.5 callerPresent string False 用户侧主叫显示号码，用户看到的主叫号码，不携带的情况下默认采用租间的接入码，携带的情况下该号码必须传接入码。如果需要传非接入码号码，请联系运维人员开通主叫透显特性，该特性开通后号码校验规则为：接入码或者11-14位的数字。 说明： ITA双呼不支持callerPresent字段。

响应说明 响应状态码: 200 表3 响应体参数 序号 名称 参数类型 是否必选 说明 1.1 retCode string False 0：成功，其他为失败 1 ：添加外呼任务失败，外呼数据库中可能已存在相同外呼任务 2 ：呼叫数据信息 3 ：未查询出呼叫流水号字段 5 ：主被叫或外显号码格式不符 6 ：VDN不可用 8 ：主叫号码不在租户所分配的移动座席使用的软电话号码范围内 16 ：试用租户的座席侧号码未在白名单内 21 ：试用租户一键双呼超过每天10次限制 针对ITA双呼还有一些retCode，请参见表4 1.2 retMsg string False 失败原因的描述 1.3 result object False 返回结果 1.3.1 callSerialNo string False 呼叫序列号，唯一标识一次外呼呼叫 长度限制：string（50） 表4 针对ITA双呼的retcode说明 retcode retMsg 说明 90100100 Invalid Input Parameter 请求报文不正确。如缺少参数或者不支持的参数 90100200 Auth Failed 请求的来源或者请求的签名未通过校验 90100300 Bad Request 错误请求 90100400 Not found 请求资源不存在 90100600 Internal Server Error 系统内部错误 90102001 Insufficient Balance 额度不足 90102002 Request Restriction 请求限制 90104001 Insufficient Permission 权限不足 90104003 Request Forbidden 请求被禁止 90104004 Service Unavailable 不支持的业务功能或者未实现 90104008 Service Process Failure 业务处理超时或者处理失败 90104029 Too Many Requests 请求过多 90106001 Binding relationship already exists 小号绑定关系已存在 90106002 Binding relationship not exists 小号绑定关系不存在 90106003 Insufficient Number resources 小号号码池资源不足 90106004 No corresponding number found 未找到可用小号 90106005 Inconsistent binding data 小号绑定数据不一致 90106006 Other Error 小号其他原因导致错误 90106010 Policy Forbid 策略禁止 90106011 Caller Forbid 主叫限制 90106012 Callee forbid 被叫限制 响应状态码: 400 错误的请求：请检查请求路径及参数。 响应状态码: 401 未授权：1.请确认是否购买了相关服务。2.请联系客服人员检查您账号的当前状态。 响应状态码: 404 请求的内容未找到：请检查请求的路径。 响应状态码: 500 业务失败：请依次确认您请求中各参数的取值。

响应说明 响应状态码: 200 表3 响应体参数 序号 名称 参数类型 是否必选 说明 1.1 retCode number True 返回码。0表示成功，其他为失败。 1：上传OBS失败 3：VDN不可用 5：无对应历史记录 6：虚拟呼叫中心不存在 7：sftp信息为空 8：sftp用户密码为空 9：sftp连接失败 10：获取临时路径失败 11：从UAP下载文件失败 12：呼叫流水号长度不可大于50 13：录音文件大小超过限制 1.2 retMsg string True 失败原因的描述 1.3 result object False 返回结果 1.3.1 url string False 录音地址url 长度限制：string（200） 响应状态码: 400 错误的请求：请检查请求路径及参数。 响应状态码: 401 未授权：1. 请确认是否购买了相关服务。 2. 请联系客服人员检查您账号的当前状态。 响应状态码: 404 请求的内容未找到：请检查请求的路径。 响应状态码: 500 业务失败：请依次确认您请求中各参数的取值。

报文样例 场景描述：样例报文 请求头: x-app-key:6******************************b Authorization:Bearer e******************************6 Content-Type:application/json 请求参数: {"callSerialNo": "679218118865715226"} 响应头: {"connection": "keep-alive"，"content-type": "application/json;charset=UTF-8"} 响应参数: {"retMsg": "success"，"result": {"url": "https://aicc-obs0.obs.cn-south-1.myhuaweicloud.com:443/644429155876552705?AWSAccessKeyId=ZGUZVMUDBS2DKAQ5X141&Expires=1565681851&Signature=sb3ZDPyzg%2FXZLMIPK0zBTRA6x5s%3D"}，"retCode": "0"}

请求说明 表1 请求头参数 序号 名称 参数类型 是否必选 说明 1 X-APP-Key string False 用户标识，与tokenByAkSk接口请求参数中的app_key一致 2 Authorization string True 鉴权字段，内容格式为: Bearer +tokenByAKSK接口的返回值中AccessToken（Bearer后有空格） 表2 请求体参数 序号 名称 参数类型 是否必选 说明 1 callSerialNo string True 呼叫流水号 长度限制：string（50）

报文样例 请求头: x-app-key:9******************************3 Authorization:Bearer e******************************e Content-Type:application/json 请求参数: {"callSerialNo": "645735364434067472"} 响应头: {"connection": "keep-alive","content-type": "application/json;charset=UTF-8"} 响应参数: {"retMsg": "Query call state successfully","retCode": "0","result": {"caller": "88889050","called": "88889060","callerPresent": "640003","startTime": 1621823865000,"state": 3,"reasonCode": 0,"agentPresent": "640060","endTime": 1621823872000}}

响应说明 响应状态码: 200 表3 响应体参数 序号 名称 参数类型 是否必选 说明 1.1 retCode string True 0 ：成功，其他为失败 1 ：查询状态失败 3 ：呼叫流水号格式不符 1.2 retMsg string True 失败原因的描述 1.3 result object False 返回结果 1.3.1 state number False 呼叫状态： 0：待呼叫 1：正在呼叫 2：通话中 3：通话结束 长度限制：number（1） 1.3.2 reasonCode number False 通话结束原因码： 0~65535， 0: 通话结束，被叫挂机 1：通话结束，主叫关机 2：外呼主叫失败 3：外部被叫失败 4：外呼主叫无应答 5：外呼被叫无应答 6：启动呼叫失败 xxx：其他异常 长度限制：number（5） 针对ITA双呼还有一些reasonCode，请参见表4 1.3.3 callData string False 第三方自定义的呼叫数据信息 长度限制：string（1024） 1.3.4 caller string False 主叫号码 长度限制：string（32） 1.3.5 called string False 被叫号码 长度限制：string（32） 1.3.6 startTime string False 外呼开始时间，时间戳，如1572794607000 1.3.7 endTime string False 通话结束时间，时间戳，如1572794607000 1.3.8 callerPresent string False 外显号码，来电显示的号码 长度限制：string（32） 1.3.9 agentPresent string False 外显号码，客户经理来电显示的号码 表4 针对ITA双呼的reasonCode说明 retCode 原因值描述 0 不涉及 1 无法找到号码 2 无法路由到网络 3 无法路由到目的地 4 发送特殊消息 5 中继前缀出错 6 通道无法接入 7 已经建立频道 8 抢先占有 9 抢先占有保留 16 正常呼叫清除 17 用户忙 18 无应答 19 无用户应答 20 用户不可及 21 拒绝呼叫 22 号码已改变 23 重定向 25 交换路由错误 26 无用户准许 27 目标无序 28 非法号码格式 29 设备拒绝 30 状态查询 31 正常 34 路由不可达 38 网络状态不好 39 服务链接不上 40 链接进行中 41 暂时失败 42 设备拥塞 43 信息丢弃 44 通道无法接入 46 呼叫阻塞 47 无可用资源 49 品质无效 50 设备没预订 53 闭合群OCB呼出受限 55 闭合群ICB呼入受限 57 无权限发送 58 发送无效 62 等级不一致 63 服务无效 65 发送无法执行 66 通道无法执行 69 设备无效 70 发送有效 79 CV服务没设置 81 引用非法值 82 通道不存在 83 ID不存在 84 呼叫ID不存在 85 无呼叫等待 86 隐藏号码呼叫 87 CUG无成员 88 目标冲突 90 CUG不存在 91 无效网络 95 无效信息 96 非托管元素 97 类型不存在 98 信息没执行 99 信息单元不存在 100 无效的信息单元 101 呼叫状态不一致 102 定时器超时 103 参数不存在 110 消息中带有未识别的参数 111 协议错误 127 未指定的交互 响应状态码: 400 错误的请求：请检查请求路径及参数。 响应状态码: 401 未授权：1. 请确认是否购买了相关服务。 2. 请联系客服人员检查您账号的当前状态。 响应状态码: 404 请求的内容未找到：请检查请求的路径。 响应状态码: 500 业务失败：请依次确认您请求中各参数的取值。

请求说明 表1 请求头参数 序号 名称 参数类型 是否必选 说明 1 X-APP-Key string False appKey字段，用户标识 2 Authorization string True 鉴权字段，内容格式为: Bearer +tokenByAKSK接口的返回值中AccessToken（Bearer后有空格） 表2 请求体参数 序号 名称 参数类型 是否必选 说明 1 callSerialNo string True 呼叫流水号 长度限制：string（50）

响应说明 响应状态码: 200 表3 响应体参数 序号 名称 参数类型 是否必选 说明 1.1 retCode string True 返回码。0表示成功，其他为失败。 4：获取不到被叫标示 5：被叫未配置标示 1.2 retMsg string True 失败原因的描述 1.3 result object False 返回结果 1.3.1 devType number False 设备类型: 0：技能队列； 1：号码 长度限制：number (4) 1.3.2 called string False 被叫号码 长度限制:string(32) 1.3.3 skillId number False 技能队列 长度限制：number (16) 1.3.4 skillName string False 技能队列名称 长度限制：string(64) 响应状态码: 400 错误的请求：请检查请求路径及参数。 响应状态码: 401 未授权：1.请确认是否购买了相关服务。2.请联系客服人员检查您账号的当前状态。 响应状态码: 404 请求的内容未找到：请检查请求的路径。 响应状态码: 500 业务失败：请依次确认您请求中各参数的取值。

报文样例 场景描述：样例报文 请求头： x-app-key:9******************************3 Authorization:Bearer 9******************************7 Content-Type:application/json 请求参数: {"caller": 8888888，"called": 6666614} 响应参数: {"retMsg": "Called is not configured"，"retCode": "5"}

请求说明 表1 请求头参数 序号 名称 参数类型 是否必选 说明 1 X-APP-Key string False appKey字段，用户标识 2 Authorization string True 鉴权字段，内容格式为：Bearer +tokenByAKSK接口的返回值中AccessToken（Bearer后有空格） 表2 请求体参数 序号 名称 参数类型 是否必选 说明 1 called string True 被叫号码 长度限制:string(32) 1 caller string True 主叫号码 长度限制:string(32)

响应说明 响应状态码: 200 表3 响应体参数 序号 名称 参数类型 是否必选 说明 1.1 retCode string True 返回码。0表示成功，其他为失败。 1：查询失败 2：移动座席信息为空 3：注册服务地址或端口为空 4：limit或offset分页数据为空 5：虚拟呼叫中心信息为空 1.2 retMsg string False 失败原因的描述 1.3 result object False 返回结果 1.3.1 total number False 总记录数 1.3.2 singleRegServ array[object] False single模式 1.3.2.1 regIPAddress string False 注册地址 长度限制：string（50） 1.3.2.2 regPort string False 注册端口 长度限制：number（5） 1.3.3 poolRegServ object False pool模式 1.3.3.1 node1 array[object] False 节点1 1.3.3.1.1 regIPAddress string False 注册地址 长度限制：string（50） 1.3.3.1.2 regPort string False 注册端口 长度限制：number（5） 1.3.3.2 node2 array[object] False 节点2 1.3.3.2.1 regIPAddress string False 注册地址 长度限制：string（50） 1.3.3.2.2 regPort string False 注册端口 长度限制：number（5） 1.3.4 phone array[object] False 软电话信息列表 1.3.4.1 phoneNum string False 软电话号码 长度限制：string（32） 1.3.4.2 password string False 软电话密码 长度限制：string（50） 响应状态码: 400 错误的请求：请检查请求路径及参数。 响应状态码: 401 未授权：1.请确认是否购买了相关服务。2.请联系客服人员检查您账号的当前状态。 响应状态码: 404 请求的内容未找到：请检查请求的路径。 响应状态码: 500 业务失败：请依次确认您请求中各参数的取值。

报文样例 场景描述：样例报文 请求头: x-app-key:2******************************8 Authorization:Bearer e******************************5 Content-Type:application/json 请求参数: {"offset": 0，"limit": 3} 响应参数: {"retMsg": "successfully"，"retCode": "0"，"result": {"total": 2，"regPort": "5060"，"phone": [{"phoneNum": "88881196"，"password": "****"}， {"phoneNum": "88881197"，"password": "****"}]，"regIPAddress": "10.162.98.43"}}

请求说明 表1 请求头参数 序号 名称 参数类型 是否必选 说明 1 X-APP-Key string False appKey字段，用户标识 2 Authorization string True 鉴权字段，内容格式为: Bearer +tokenByAKSK接口的返回值中AccessToken（Bearer后有空格） 表2 请求体参数 序号 名称 参数类型 是否必选 说明 1 limit string False 分页查询时单页最多的记录条数，默认值100，即每页显示100条，非必选 1 offset string False 分页查询偏移量，默认值0，即不需要偏移，非必选

请求说明 表1 请求头参数 序号 名称 参数类型 是否必选 说明 1 X-APP-KEY string False appKey字段，用户标识，请联系运营人员获取appKey 2 Authorization string True 鉴权信息，值为Bearer + tokenByAKSK接口的返回值中的AccessToken（Bearer后有空格） 表2 请求体参数 序号 名称 参数类型 是否必选 说明 1.1 workNo number True 座席工号

请求说明 表1 请求头参数 序号 名称 参数类型 是否必选 说明 1 X-APP-KEY string False appKey字段，用户标识，请联系运营人员获取appKey 2 Authorization string True 鉴权信息，值为Bearer + tokenByAKSK接口的返回值中的AccessToken（Bearer后有空格） 表2 请求体参数 序号 名称 参数类型 是否必选 说明 1.1 phone string True 进行接听的号码（真实可用的号码，比如手机号、座机号） 1.2 workNo number True 座席工号