华为云用户手册

响应说明 响应状态码: 200 表3 响应体参数 序号 名称 参数类型 是否必选 说明 1.1 returnCode string False 返回码 0：成功 其他：失败 1.2 description string False 描述 1.3 data object False - 1.3.1 total integer False 总数 1.3.2 calledRouteList array[object] False 被叫列表 1.3.2.1 extCode string False 扩展码 1.3.2.2 editable string False 0或null：可编辑和删除 1：不可编辑，可删除 2：不可删除 3：不可编辑和删除 1.3.2.3 accessCode string False 接入码 1.3.2.4 dnid number False 配置编号 1.3.2.5 id string False 被叫ID（表主键id） 1.3.2.6 deviceId number False 目前设备id 1.3.2.7 devicetype number False 设备类型 1：技能队列 3：IVR 1.3.2.8 deviceDesc string False 目的设备描述 1.3.2.9 mediatypeId number False 媒体类型 2：语音点击通话 5：音视频 18：视频点击通话 19：视频 53：多媒体 1.3.2.10 flowAccessCode string False 流程接入码 1.3.2.11 subMediaTypeId number False 多媒体技能队列子类型 空值或者null：技能队列无子类型 1：WEB类型 2：Whatsapp类型 3：Line类型 4：Wechat类型 5：Facebook Messenger类型 6： Twitter类型 7：5G消息类型 8：EMAIL类型 1.3.2.12 partdbId string False 分区id 1.3.2.13 tenantId string False 租户id 响应状态码: 400 错误的请求：请检查请求路径及参数 响应状态码: 401 未授权：1. 请确认是否购买了相关服务。 2. 请联系客服人员检查您账号的当前状态。 响应状态码: 403 鉴权失败 响应状态码: 404 请求的内容未找到：请检查请求的路径。 响应状态码: 500 业务失败：请依次确认您请求中各参数的取值。

报文样例 请求头: Content-Type:application/json Authorization:Bearer XXXXXXXXXXXXXXXXXXXXXXX X-APP-Key:XXXXXXXXXXXXXXXXXXXXXXX 请求参数: { "accessCode": "9911411", "extCode": "11", "devicetype": 1, "deviceDesc": "defaultVideoSkill", "mediatypeId": 19, "limit":10, "offset":0 } 响应参数: { "returnCode": "0", "data": { "total": 3, "calledRouteList": [ { "id": "1125397061153369092", "dnid": 3, "accessCode": "9911411", "mediatypeId": 19, "extCode": "11", "devicetype": 1, "deviceId": 1, "deviceDesc": "defaultVideoSkill", "editable": "0" }, { "id": "1127983948544239618", "dnid": 1, "accessCode": "9911411", "mediatypeId": null, "extCode": "", "devicetype": 1, "deviceId": 1, "deviceDesc": "defaultVideoSkill", "editable": "0" }, { "id": "1127986019188238339", "dnid": 2, "accessCode": "9911411", "mediatypeId": 19, "extCode": "1", "devicetype": 1, "deviceId": 1, "deviceDesc": "defaultVideoSkill", "editable": "0" } ] }, "description": "success" }

请求说明 表1 请求头参数 序号 名称 参数类型 是否必选 说明 1 X-APP-Key string False appKey字段，用户标识，请联系运营人员获取appKey 2 Authorization string True 鉴权字段，内容格式为: Bearer +tokenByAKSK接口的返回值中AccessToken（Bearer后有空格） 表2 请求体参数 序号 名称 参数类型 是否必选 说明 1.1 accessCode string False 接入码 1.2 extCode string False 扩展码 1.3 devicetype integer False 设备类型 1：技能队列 3：IVR 1.4 deviceDesc string False 设备名称（技能队列/IVR名称）支持模糊匹配 1.5 mediaTypeId integer False 媒体类型 2：语音点击通话 5：音视频 18：视频点击通话 19：视频 53：多媒体 1.6 limit integer False 表示每页的查询数量，0-100，默认100，如果输入超过100，将默认查询100条 1.7 offset integer False offset用于确定查询的起始页。offset取值范围为：offset=limit*(page-1)，page为需要查询的起始页。offset默认值为0，如果输入负数，将按照0查询

样例报文 请求头： Content-Type: application/json;charset=UTF-8 Authorization: ****************** 请求参数： { "ccId":1, "vdn":170, "skillIds":[1,2] } 响应参数： { "result": "0", "resultCode": "0100000", "resultDatas": [ { "id": 1, "startTime": 1607390702000, "allCallCount": 0, "cnnedCallCount": 0, "abanCallCount": 0, "callEndCount": 0, "talkTimeOnIvr": 0, "cnnedIn20sCallCount": 0, "clearUpCallCount": 0, "clearUpTime": 0 }, { "id": 2, "startTime": 1607390702000, "allCallCount": 0, "cnnedCallCount": 0, "abanCallCount": 0, "callEndCount": 0, "talkTimeOnIvr": 0, "cnnedIn20sCallCount": 0, "clearUpCallCount": 0, "clearUpTime": 0 } ], "resultDesc": [ { "id": 1, "startTime": 1607390702000, "allCallCount": 0, "cnnedCallCount": 0, "abanCallCount": 0, "callEndCount": 0, "talkTimeOnIvr": 0, "cnnedIn20sCallCount": 0, "clearUpCallCount": 0, "clearUpTime": 0 }, { "id": 2, "startTime": 1607390702000, "allCallCount": 0, "cnnedCallCount": 0, "abanCallCount": 0, "callEndCount": 0, "talkTimeOnIvr": 0, "cnnedIn20sCallCount": 0, "clearUpCallCount": 0, "clearUpTime": 0 } ] }

请求说明 表1 请求头参数 序号 名称 参数类型 是否必选 说明 1 Content-Type String True 固定填 application/json; charset=UTF-8。 2 Authorization String True 生成方式参见C2 监控/系统外呼/话单/知识库类接口鉴权方式。 表2 请求消息体参数说明 序号 名称 参数类型 是否必选 说明 1 ccId int True 呼叫中心编号。 取值范围：1～65535。 2 vdn int True 虚拟呼叫中心编号。 取值范围：1～5000。 3 skillIds array True 技能队列ID信息的对象数组。 数组长度不大于1000。 取值范围：1～2000。

响应消息 表3 响应消息体参数说明 序号 名称 参数类型 说明 1 result String 查询结果。取值如下： 0：成功 其他：失败 失败的原因说明请参见错误码参考。 说明： 当前字段为兼容8.13及其之前版本接口响应参数使用。 2 resultCode string 查询结果。取值如下： "0100000"：成功 其他：失败 失败的原因说明请参见错误码参考。 3 resultDatas array 查询成功后，返回结果信息的对象数组。 该数组中对象的参数说明请参见表4。 说明： 当前字段为兼容8.13及其之前版本接口响应参数使用。 4 resultDesc array 查询成功后，返回结果信息的对象数组。 该数组中对象的参数说明请参见表4。 表4 resultDesc/resultDatas对象参数说明 序号 名称 参数类型 说明 2.1 id int 技能队列编号 2.2 startTime long 统计的开始时刻（毫秒级时间戳） 2.3 allCallCount long 当前5分钟呼入呼叫总和 2.4 cnnedCallCount long 当前5分钟接通呼叫总和 2.5 abanCallCount long 当前5分钟呼损呼叫总和 2.6 callEndCount long 当前5分钟通话完毕呼叫数 2.7 talkTimeOnIvr long ivr上通话时长（挂起转人工时，挂起时间计入通话时间）单位：秒 2.8 cnnedIn20sCallCount long 当前5分钟内在20S内接通呼叫总和 2.9 clearUpCallCount long 当前5分钟内整理完毕的呼叫总数 2.10 clearUpTime long 当前5分钟内整理的总时长 （单位：秒）

座席操作详单索引文件(yyyymmddhhmmssSSS+3位随机数_agentOprInfo_文件序号.csv)定义 导出的csv文件中每一行表示一条数据，在该条数据下每行数据按列排序，每行数据描述说明请参考下表。 顺序 参数名称 数据类型 参数说明 1 id String（1-32） 唯一标识。 2 developer_id String（1-64） 开发者ID。 3 account_id String（1-64） 企业帐号。 4 agent_id String（1-32） 座席ID。 5 service_no String（1-25） 业务类型ID。 6 skill_id String（1-25） 技能队列ID。 7 call_id String（1-25） 呼叫标识。 8 begin_time DATE 统计操作开始时间。 时间格式为：YYYY-MM-DD hh:mm:ss，例如：2015-02-08 20:23:30 9 end_time DATE 统计操作结束时间。 时间格式为：YYYY-MM-DD hh:mm:ss，例如：2015-02-08 20:23:30 10 op_type String（1-20） 操作类型，请参考表1。 11 op_object String（1-20） 操作对象 12 op_cause String（1-20） 操作原因。 13 media_type String（1-20） 媒体类型 14 vdn_id String（1-20） VDN ID 15 cc_id String（1-20） 呼叫中心编码 16 agent_type String（1-20） 座席类型/客户级别 17 phone_no String（1-32） 座席IP/座席电话号码/被叫号码/会议的ID 18 callIn_out String（1-20） 呼入呼出标志，包括： 呼入 呼出 IVR呼出 outbound呼出 19 location_id String（1-20） 分布式节点编号 20 logon_sn String（1-25） 签入序列号 21 skillInfo_sn String（1-25） 执行当前操作时座席拥有技能列表的索引。 当取值为空时，表示座席不拥有任务技能。例如：座席签入时，此字段则为空。

报文样例 请求头: Content-Type:application/json Authorization:Bearer XXXXXXXXXXXXXXXXXXXXXXX X-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 业务失败：请依次确认您请求中各参数的取值。

消息样例 场景描述：修改工单状态 URL：https:// 域名 /service/AICC__Case/1.0.0/openapi/status/update 请求头: { "Content-Type": "application/json", "access-token": "0000000000************7bm63KsRmEztTvyA=" } 请求体： { "id": "c6m80000013uPdSDTGbY","status": "Completed","creatorId":"10gg000000sLj1ytR70C" } 响应头： { "connection": "keep-alive", "Content-Length": "16", "Content-Type": "application/json%3Bcharset=UTF-8"} 响应参数： {"resCode": "0","resMsg": "成功"}

请求说明 表1 请求头参数 序号 名称 参数类型 是否必选 说明 1 Content-Type string True 消息正文的类型为JSON 2 access-token string True 用户访问租间token，参见调用鉴权接口 表2 请求体参数 序号 名称 参数类型 长度（字节） 是否必选 说明 1 id string 20 True 工单id，长度为20 2 creatorId string 20 True 操作处理人id 3 status string - True 工单状态 dataType : SingleSelect 枚举值： 0.Completed(默认值) 其他值业务自定义

请求消息样例 { "userid": "1528780879-9581", "inaction": 9, "inparams": { "call_id": "1528780879-9581", "call_dst_id": "10086", "flow_result_type":"1", "input":"帮我查一下我的话费", "inter_idx": "1", "begin_play": "2018090407:16:24", "end_play": "2018090407:16:30", "result_time":"2018090407:16:3", "inter_no":"0" }, "extparams": { "transin_data":"95,22714,0,,1,1,,test_gdj_01005", "queueIndex":"2", "agentCount":"5" } } ODFS判断如果 flow_result_type = 1 且 input = (识别结果id值) 时会调用Redis获取转写文本（key=识别结果id值中redis值编号key），获取到的识别文本格式为字符串（非JSON格式）。 Lua脚本获取Redis结果示例代码如下，示例中代码key值为“msg”字符串。

响应消息样例1 { "userid": "1528780879-9581", "outaction": 9, "outparams": { "call_id": "1528780879-9581", "prompt_type": "1", "prompt_wav": "welcome", "prompt_text": "查询话费", "language": "0", "inter_idx": "1", "model_type":"1011201" "timeout": "10", "tone": "", "grammar": "", "question_id": "Q1", "question_name": "问题1", "answer_id": "Y" } }

响应消息样例 { "outaction": 12, "outparams": { "call_id": "1528780879-9581", "prompt_type": "1", "inter_idx": "1", "moduleName":"查询", "xxx":"xxx" //扩展 } }

响应消息样例2 { "userid": "1528780879-9581", "outaction": 11, "outparams": { "call_id": "1528780879-9581", "call_sor_id": "13500000001", "calling_num":"1234567890", "trans_type": "1", "route_value": "123456789", "inter_idx": "1", "trans_idx": "1", "question_id": "Q1", "question_name": "问题1", "answer_id": "Y" } }

响应消息样例3 { "userid": "1528780879-9581", "outaction": 10, "outparams": { "call_id": "1528780879-9581", "call_sor_id": "13500000001", "call_dst_id": "10086", "start_time": "2018090407:16:24", "end_time": "2018090407:30:24", "release_reason": "0", "region_id": "025", "entrance_id": "03", "exit_id": "05", "user_type_id": "01", "suilu_region_id":"025" } }

ExtParams参数 参数名称 数据类型 参数位置 必选/可选 描述 transin_data String body False 由接入方跟OIAP约定的随路数据参数，例如IVR传入的数据包参数 release_reason String body False(语音导航场景特有字段) ivr上报给odfs呼叫拆线的原因码： 0、业务流程正常拆线； 1、系统异常拆线； 2、用户拆线； queueIndex String body False(查询排队信息场景特有) 查询技能队列的排队位置 agentCount String body False(查询排队信息场景特有) 查询技能队列的在线座席数 estimateTime String body False(查询排队信息场景特有) 查询技能队列的预计等待时间 idleAgentCount String body False(查询排队信息场景特有) 查询技能队列的空闲座席数

inparams 参数 参数名称 数据类型 参数位置 必选/可选 描述 call_id String body True 呼叫唯一标志，与userid 取值相同，给流程使用。 不超过64位 call_dst_id String body True 接入标识 1、语音导航场景传入被叫号码； 2、语音外呼问卷场景时为问卷类型id； 3、其他交互场景时传入接入标识。 不超过20位 flow_result_type String body True 结果类型。 1： 语音识别 输入或者文字输入 2：语音按键输入 3：正常无输入(只播放) 4：录音结束 -1：其他 input String body True 对话交互结果。 语音识别结果或者文字输入：语音识别结果为id值,格式为redis值编号key+@+inter_no；文字输入结果则直接为文字内容 语音按键结果：按键值,如"1","201801"等 playover：放音结束 timeout：超时 nomatch：识别或按键失败 sys_err：系统异常 hangup：挂机 recordend：录音结束 当结果为hangup时,可触发ODFS的拆线响应。 不超过1024位 auth_token String body True 授权信息，取接入控制系统返回的token值。 请参见C3 智能助手平台接口鉴权方式。 recordFileName String body False(支持全流程录音的语音导航场景特有字段) 全流程录音的路径文件名，例如：Y:/record/1/20200421/xxxxxx.wav inter_idx String body False(语音导航场景特有字段) 交互次数，直接取上一次ODFS返回的inter_idx值即可。 begin_play String body False(语音导航场景特有字段) 放音开始时间 end_play String body False(语音导航场景特有字段) 放音结束时间 result_time String body False(语音导航场景特有字段) 结果产生的时间 inter_no String body False(语音导航场景特有字段) 识别标识 IACmd String body False(语音导航场景特有字段) 智能匹配和智能工单填写专用字段 智能匹配时，只支持值为match 智能工单时，可取值如下： match：请求填单 rematch：当识别的事项分类错误时,重新识别 confirm：当座席点选某字段时,告知odfs该字段已确认 TextSource String body False(语音导航场景特有字段) 当IACmd为match时，用于区分输入文本来自座席还是用户（智能匹配、智能工单相同）,值为staff或customer staff：座席 customer：用户 当IACmd为confirm时，传入座席点选的字段名,如：对象二级 当IACmd为rematch时，可不填 feedback int body False 反馈的满意度: 1(满意)；0(不满意) feedbackContent String body False 反馈的不满意原因(如果反馈为满意则为空) mediaType String body False 媒体类型（文本,音频,视频... 例如：audio,video...） channelType String body False 渠道类型 WEB（Web） INSTAG RAM （Instagram） TELEGRAM(Telegram) WECHAT(微信) FACEBOOK（Facebook） TWITTER（X (Twitter)） EMAIL（邮件） LINE WHATSAPP（WhatsApp） 5G（5G消息） SMS （短信）。 说明： 括号里为界面字段,区别于接口传参字段。 refeedbackContentcordFileName String body False 录音文件名 call_media_type String body False 呼入ivr的呼叫类型，文本：0 音频：1视频：3

报文样例 场景描述：根据敏感词分类的唯一标识取得分类下敏感词列表的接口。 请求头: x-app-key:************************************ X-UserID:1611917095665261978 Authorization:Bearer ******************************** 请求参数: { "page": 1, "limit": 10, "category_id": "894378241379274753" } 响应参数: { "data": [{ "category_id": "894378241379274753", "sw_id": "894378241689653248", "sw_name": "哈哈哈" }], "resultCode": "0401000", "paging": { "total": 1 }, "resultDesc": "操作成功" }

请求说明 表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 False 操作员标识 可在登录后，进入员工管理页面，查看接口返回的userId 表2 请求体参数 序号 名称 参数类型 是否必选 说明 1.1 category_id string True 敏感词分类的唯一标识 1.2 page number True 页码 1.3 limit number True 每页数量 取值范围：5, 10, 20, 50, 100

响应说明 响应状态码: 200 表3 响应体参数 序号 名称 参数类型 是否必选 说明 1.1 paging object False 分页信息对象 1.1.1 total number False 查询结果总数 1.2 data array[object] False 返回的句子数据集合对象 1.2.1 sw_id string False 敏感词id 1.2.2 sw_name string False 敏感词名称 1.2.3 category_id string False 敏感词分类的唯一标识 1.3 resultCode string False 返回码 0401000 表示成功 其他表示失败 1.4 resultDesc string False 返回描述 响应状态码: 400 错误的请求：请检查请求路径及参数。 响应状态码: 401 未授权：1. 请确认是否购买了相关服务。 2. 请联系客服人员检查您账号的当前状态。 响应状态码: 404 请求的路径未找到：请检查请求的路径 响应状态码: 500 业务失败：请依次确认您请求中各参数的取值。

响应说明 表6 消息体参数说明 序号 参数名 参数类型 说明 1 resultCode String 原因码。0200000表示成功，其他表示失败。 具体见表5。 2 resultDesc String 描述。 3 importTaskId String 文件导入任务ID 4 returnCode String 原因码。0200000表示成功，其他表示失败。 具体见表7 5 returnDesc String 描述。

错误结果码 表7 错误原因码说明 序号 错误码 说明 1 0200001 参数异常，异常详情在resultDesc中描述。 2 02000001 参数值为空 3 02000002 参数包含非法字符 4 02000003 参数长度不能大于规定长度 5 02000004 参数长度不能小于规定长度 6 02000005 参数长度需要介于规定长度之间 7 02000006 参数值类型不正确 8 02000007 参数值大小不正确 9 02000008 参数转换异常，请检查请求参数 10 02000009 参数组合不正确，请检查请求参数 11 02000010 hour和minute必须同时存在 12 02000011 参数个数不能大于规定个数

黑名单模板 请参考表1创建Excel模板文件。 表1 黑名单模板 黑名单号码（必填） 到期时间（非必填） 有效时长（非必填，单位：小时） 限制次数 限制周期 65676950 - - 1 1 88888888 2022-05-27 23:06:25 - - - 88888888 2022-06-24 10:06:25 - - - 12345678 2022-06-24 10:06:25 - - - 表2 黑名单模板参数说明 序号 参数名 参数类型 是否必选 说明 1 黑名单号码（必填） String True 号码最大长度为24个字符，有效字符为：0~9、*、# 2 到期时间（非必填） String False 到期时间，到期时间=新增时间点+有效时长。例：“2020-12-31 10:06:25”新增2条黑名单号码，有效时长120小时，则到期时间为“2021-01-05 10:06:25”。 3 有效时长（非必填，单位：小时） INT False 有效时长，单位小时，取值范围1~120。 4 限制次数 INT False 限制次数（与限制周期绑定，两者都填或都不填，范围：1-100） 5 限制周期 String False 限制周期（0：每小时；1：每天） 示例1："restrictTimes":1，"restrictPeriod":"0" 表示2020-12-30 10:06:25 呼出一次，下次可呼出时间为2020-12-30 11:00:00 示例2："restrictTimes":1，"restrictPeriod":"1" 表示2020-12-30 10:06:25 呼出一次，下次可呼出时间为2020-12-31 00:00:00

接口URI https://ip:port/rest/isales/v1/openapi/campaigns/{vdnId}/blackfile/uploadFileServer 其中，ip为CC-iSales服务器地址，port为CC-iSales服务器的HTTPS端口号。 表3 URL中携带的参数说明 序号 参数名 参数类型 是否必选 说明 1 vdnId int True 虚拟呼叫中心ID。 取值的类型为整数，取值范围为1～9999。

报文样例 该接口的请求消息体举例如下： { "serverId":"164690088271159234793429225848", "filePath":"/isales/upload", "fileName":"demoBlack.xlsx", "hour":"11", "minute":"00" } 该接口的响应消息体举例如下： { "returnCode": "0200000", "importTaskId": "164757251098048478018607266946", "resultCode": "0200000", "resultDesc": "数据导入中，请通过“导入结果”查看详细信息。", "returnDesc": "数据导入中，请通过“导入结果”查看详细信息。" }

错误结果码 表1 CC-Gateway错误结果码 错误结果码 说明 000-001 获取Agent事件的方法错误。 000-002 座席通过URL传递的参数或者地址错误或接口参数不合法，不符合定义。 000-003 没有权限调用接口，可能座席鉴权失效。 000-004 座席正在倒换中。 000-005 质检座席是质检员自己 000-006 消息参数错误 100-001 签入参数为空或者不合法。 100-002 座席已经登录。 100-003 座席登录的时候抛ResourceUnavailableException或ProviderUnavailableException异常。 100-004 登录过程中，用户名或者密码错误。 100-005 登出参数不合法。 100-006 座席没有登录。 100-007 座席操作时发生异常，可能是WAS资源错误无法访问或者内部错误产生。 100-008 座席已经登出。 100-009 设置座席状态错误，可能是座席没有权限设置产生。 100-010 签出时状态错误。 100-011 签入时参数不合法错误。 100-012 签入时座席类型错误。 100-013 绑定座席电话时电话无效。 100-014 座席签入的电话号码不在配置范围内。 100-015 座席已经登录。并且不能被强制签出。 100-016 座席签入时，IP地址无效。 100-017 uPortal鉴权失败 100-018 座席签入时的 vdnId 和 放音的 vdnId 不一致 110-016 账号正处于锁定状态。 101-001 座席没有电话会议。 101-002 座席不是当前电话会议的主席。 101-003 座席已经在会议中 101-004 非质检员没有查询vdn会议权限 101-005 主席的主席权限不可以转给自己 101-006 主席不可以删除自己 101-007 主席不可以退出会议 104-001 未开启录音下载功能 104-002 用户无质检录音/质检放音权限 104-003 录音下载失败之文件名不合法 104-004 录音下载失败之没有配置映射盘符 104-005 录音下载失败之录音文件不存在 104-006 录音下载失败之空闲空间不足 104-007 录音文件格式不支持 104-008 录音格式系统参数未配置 104-009 录音转换失败 104-010 POOL模式下 locationId 参数未配置 105-001 Redis中未缓存座席信息 105-002 当前座席正在容灾恢复中 105-003 已经完成容灾恢复 105-004 增加座席到容灾恢复队列失败 105-005 等待容灾恢复超时，座席需执行重新签入 105-006 容灾恢复Guid不匹配，座席需执行重新签入获取Guid 105-007 容灾开关未打开，座席需执行重新签入 106-001 多媒体开关没有开启 106-002 发送的消息为空 106-003 设置的会话数超过最大值，最大值为60 106-004 会话转接设备类型（devicetype）不支持 106-005 会话转移内部错误或不支持的转出模式、转出设备类型 106-006 会话转接时，座席信息空 106-007 消息内容超过最大值，最大值为2048个字节 106-008 渠道类型不正确 106-009 会话转接时，允许携带数据的最大值，最大值为2048个字节 106-010 会话转接时，转出的模式不支持 106-011 参数为空 106-012 超过short类型范围 106-013 座席发送多媒体消息时，callId为空 106-014 座席发送多媒体消息时，callId无效（不是当前座席的callId） 106-015 用户类型不合法 108-001 未开启视频下载功能 108-002 视频ID对应的VDN与当前VDN不一致 108-003 recordId不存在 108-004 请求RSE服务超时 108-005 视频文件下载请求异常 108-006 视频文件下载 查询录播地址失败异常 108-007 视频文件下载失败异常码 108-008 视频文件下载 RSE服务地址格式错误 108-009 视频文件下载 文件类型不存在 108-011 视频下载失败之映射路径不存在 108-012 视频下载失败之视频文件不存在 108-013 视频文件转换失败异常码 108-014 宇高服务地址未配置 108-015 录音文件下载失败异常码 108-016 录音文件下载请求异常 108-017 鉴权token为空 108-018 文件路径不匹配 200-001 外呼号码错误。 200-002 应答/拒接时没有呼叫错误。 200-003 静音时没有呼叫错误。 200-004 静音时呼叫状态错误。 200-005 连接保持时没有呼叫错误。 200-006 连接保持时没有保持呼叫错误。 200-007 取消静音时没有呼叫错误。 200-008 取消静音时呼叫状态错误 200-009 报音时没有呼叫错误。 200-010 三方通话时没有呼叫错误。 200-011 三方通话时没有保持呼叫错误。 200-012 呼叫转移时没有呼叫错误。 200-013 保持时没有呼叫错误。 200-014 保持时呼叫状态错误。 200-015 取保持时没有保持呼叫错误。 200-016 取保持时呼叫状态错误。 200-017 挂断时无呼叫错误。 200-018 内部咨询时无呼叫错误。 200-019 静像时没有呼叫错误。 200-020 静像时呼叫状态错误。 200-021 取静像时没有呼叫错误。 200-022 取静像时呼叫状态错误。 200-023 释放指定电话号码时没有呼叫错误。 200-024 释放指定电话号码时不存在此号码呼叫错误。 200-025 拆除呼叫时没有呼叫错误。 200-026 呼叫不存在。 200-027 音视频切换时没有呼叫错误 200-028 音视频切换时媒体类型错误 200-029 音视频切换时呼叫类型错误 200-030 音视频切换请求异常 200-031 三方视频调整画面参数错误 200-032 三方视频调整画面没有呼叫错误 200-033 三方视频调整画面呼叫类型错误 200-034 三方视频调整画面呼叫状态错误 200-035 三方视频调整画面请求异常 200-036 预览外呼参数无效错误 200-037 拒接时没有正在ringing的呼叫错误 200-038 拒接时TerminalConnection为空错误 200-039 拒接时座席没有绑定话机错误 210-001 URL信息查询不到。 300-001 查询座席信息无权限错误。 300-002 查询座席信息无座席信息错误。 300-003 查询座席班组信息无此座席信息错误。 300-004 查询座席班组信息无此座席班组信息错误。 400-001 设置随路数据时无呼叫信息错误。 400-003 获取保持队列信息时无话务信息。 500-001 快退时状态错误。 500-002 快进时状态错误。 500-003 暂停放音时状态错误。 500-004 暂停录音时状态错误。 500-005 继续放音时状态错误。 500-006 继续录音时状态错误。 500-007 开始放音时状态错误。 500-008 开始录音时状态错误。 500-009 停止放音时状态错误。 500-010 停止录音时状态错误。 500-011 开始录音时座席指定文件路径开关未开启 600-001 查询座席技能队列信息无此座席信息或座席无配置技能错误。 600-002 查询指定VDN的技能队列信息无队列配置信息。 600-003 查询座席所在VDN的接入码信息时无配置信息。 600-004 查询座席所在VDN的IVR信息时无配置信息。 600-005 查询座席所在VDN的技能队列信息无队列配置信息。 700-001 会话不存在。 700-002 调用平台异常。 700-012 消息发送失败。 700-013 富媒体文件上传功能没有开启 700-014 富媒体文件上传时，文件服务器异常 700-015 富媒体文件上传时，文件后缀或大小不符合要求 700-016 富媒体文件下载时，文件不存在 700-017 富媒体文件下载时，无权限下载 700-018 数据库异常 701-001 多媒体会议成员为空。 701-002 查询多媒体会议状态返回空值。 701-003 创建会议时，创建者或者参与者已经在其他会议中 。 701-004 邀请与会者时，当前操作者不在会议中。 701-005 停止会议时，会议不存在或者没有权限操作该会议。 701-006 创建会议时， 配置台MS IP未配置。 800-001 配置代理服务为空。 800-002 配置信息查询异常。 800-003 默认媒体网关信息不存在。 900-001 质检操作时发生NOPROVIDER异常 。 900-002 质检操作时发生没有权限异常。 900-003 质检操作时发生ResourceUnavailableException异常。 900-004 质检监视时发生没有座席信息。 900-005 质检操作时发生状态异常。 900-006 质检操作时发生录屏的时间参数错异常。 900-007 质检操作时发生录屏的未加载支持录屏的许可异常。 900-008 质检操作时发生录屏的平台未知异常。 900-009 删除质检任务时，未找到任务异常 。 900-010 被质检座席不能为质检员 999-001 服务端的配置文件中配置的WAS URL不正确。 999-002 查询消息过载。 999-003 登录数量超过最大值。 表2 CTI错误结果码 错误结果码 说明 21201 会议与会方超过120方的最大限制 21202 会议个数超过系统默认配置 21203 会议创建时本VDN的可用pstn呼叫数小于3，不允许创建会议 21204 坐席已加入一方会议中，不可再加入其他会议 21205 只允许空闲坐席或处于呼叫中的坐席发起会议 21207 内部错误，创建会议时无法为会议分配到呼叫控制块 21208 内部错误，创建会议时无法为会议分配到VISIT 21209 内部错误，创建会议时无法为会议分配到CALL对象 21210 内部错误，创建会议时VISIT绑定呼叫失败 21211 内部错误，会议呼叫不存在 21212 占用坐席失败 21213 会议占用超时 21214 会议不存在 21215 释放会议时主席已不在会议中 21216 主席修改与会者属性：与会者现在的属性与要修改的属性相等 21217 批量删人时主席在删人列表中 21218 转移主席权限失败、主席转移给自己 21219 坐席加入会议时当前VDN的PSTN可用呼叫数为0 21220 空闲座席申请会议过程中，座席强制签出导致会议释放 21221 批量增加与会者时主席在加人列表中 21222 申请会议时常小于4分钟 21223 申请会议时常超过24小时 21224 申请添加的与会者数量超过会议当前剩余资源方数 21225 申请或释放会场时不允许调用接口对会场进行操作 21226 内部异常，创建会议对象时出错 21227 创建会议时申请与会者方数为0 21228 批量添加零个人 21229 批量删除零个人 21230 释放会议时\转移主席权限\添加与会者\删除与会者时，操作用户不是主席。 21231 CTIS无响应（未返回ack） 21232 主备倒换，会议创建失败释放会议 21233 会议创建过程中异常释放会议 21234 在会议创建成功前有成员退出 21235 超过了最大允许成员数 21236 会议握手超时 21237 被操作者不在会议中 21238 修改会议资源方数：加资源方数后超过120方 21239 修改会议资源方数：减资源方数大于会议剩余方数 21240 修改会议资源方数：操作类型不正确 21241 修改会议资源方数：修改方数小于2 21242 修改会议资源方数：修改方数大于118 21243 查询VDN中进行的会议ID：VDN数不正确 21244 批量查询会议：查询会议数大于最大可查询数 21245 延长会议时常小于1分钟 21246 延长会议时常大于1440分钟 21247 主席在给会场放音时，此时会场正在放音，只有会场在通话状态下才能放音 21248 主席在给会场停止放音时，此时会场并不在放音状态下 21249 主席在给通道放音时，此时通道正在放音，只有通道在通话状态、或者保持状态下才能放音 21250 主席在给通道停止放音时，此时通道不在放音，只有通道在放音时才能停止放音 21251 主席在给通道保持时，此时通道本身已保持，只有通道在非保持状态下才能保持 21252 主席在给通道取保持时，此时通道本身为非保持状态，只有通道在保持状态下才能取保持 相同原因对应不同原因码是由于版本迭代需要兼容历史版本，定位问题时需要结合原因、原因码。 表3 CTI错误原因码 原因码 如何理解 3 无资源，排对机中无相关资源：如控制块，电路资源等。没有呼出到用户。 4 被叫正在变更，已经转移 5 呼叫等待，当A用户正在与B用户通话，C用户试图与A用户建立通话连接，此时给A用户一个呼叫等待的指示，表示另有用户等待通话 6 被叫正在转移，原因为遇忙转 7 被叫正在转移，原因为无应答转 8 被叫正在转移，原因为无条件转，不管被叫用户是在什么状态，都自动转到一个预先指定的号码 9 免打扰服务是“暂不受话服务”，原因为免打扰，后续被叫端局通常会主动拆线 10 被叫正在转移，振铃过程中转移 11 立即回应转移，未振铃 12 不可达的移动用户 13 DTE终端状态无效 14 DTE终端转移，无原因 15 被叫拍叉转移，被叫外拨一个号码，并把呼叫转移到该号码上 18 信令检测到对端交换机正在放音 129 未分配的号码 132 发送专用信息音 145 用户忙 146 用户无响应 147 用户无应答 149 用户拒绝 150 号码改变 155 目的地不可达 160 检测到音乐 162 检测到自动设备，如自动留言机、集团pbx 180 回铃音 181 忙音 182 SIT音，SIT是Special Information Tone的缩写，包含多种信号音，在ITU-T E.181和ITU-T E.182中有定义，实现的时候特指"免打扰音"，SIT目前用于防打扰设备上，一般是串接在电话机上的一个小设备。当来电后，该设备会自动接通电话，然后发出由三段固定频率组成的SIT音，用于让主叫方误认为被叫方是自动设备，然后主动挂断电话（实际是阻止外呼系统的一个设备）。如果被叫带该设备，接通后设备会自动发出SIT信号音。 184 检测到Modem 185 检测到Fax 186 Modem或者Fax。由于传真和MODEM某些信号音使用的是相同的标准，音频检测有可能无法明确具体类型 187 未定义信号音，信号符合信号音特征但无法对应到具体某种定义，信号音特征为： 频率恒定，并且持续ON时长大于2.5 Second 频率恒定，持续ON时长大于1.5 Second 在ON之前有OFF持续大于100ms 190 文本电话(ANS1) 191 文本电话(ANS2) 192 文本电话(ANS3) 193 文本电话(ANS4) 194 文本电话(ANS5) 195 文本电话(EDT) 196 文本电话(FSK) 197 文本电话(DTMF) 259 资源不足 260 被叫为Modem 261 传真 262 传真或Modem 263 自动应答机 531 用户挂机 537 被叫忙 538 空号或错号 548 手机关机 549 手机不在服务区 551 排队机异常拆线 601 应答前用户挂机 602 排队机无资源 603 无应答拆线 604 呼叫拒绝 605 交换设备忙 606 排队机超时 701 排队中用户主动挂机 702 排队超时，平台释放呼叫（若配置为排队超时释放） 703 呼叫数据超时（用于API接口方式） 1040 振铃超时，平台释放呼叫。（即在设置的振铃时间内，用户一直没有摘机） 1041 占用座席设备超时 1043 平台内部等待外呼结果超时 1046 占用座席失败 1048 达到限制obs呼叫数 1049 等待排队机摘机后外呼检测结果超时 1056 座席和用户做话路搭接失败 1281 座席和用户做话路搭接之前，座席通过座席条控件释放用户呼叫 1288 座席和用户做话路搭接时，座席通过座席条控件释放用户呼叫 1333 座席通过座席条控件应答呼叫时，座席自身话机挂断 23000 呼叫排队溢出 34601 外呼任务不存在 34602 任务已经为暂停态，暂停失败 34603 任务已经为非暂停态，恢复失败 34605 电话号码为空，即外呼获取的被叫号码为空字符串 34606 试呼失败，即调用呼出接口失败(比较常见的一种情况：当前的并发外呼数达到了在系统配置台配置的outbound呼出数；可以查看OBS日志，了解详细的失败原因)，没有呼出到用户。 34607 OBS退出(或任务被删除)，将没有呼出的记录回写 34608 呼出后，没有得到呼出结果信息，超时后将该呼叫数据回写。 34609 OBS倒换为备时，安全退出时以及预占用呼出发现没有可用座席时，未呼出的记录退单 34610 OBS倒换为备时，正在呼出的记录退单 34611 Obs退出时，对正在呼出的没回结果的记录退单回写 35027 预览呼出被叫号码填写不正确 714 呼叫路由失败 715 呼叫超时 1138 被叫挂机 1153 座席挂断 1154 座席取消呼叫 1155 超时 1156 座席断连 1162 资源超载 1163 空号或错号 1164 被叫忙 1165 手机关机 1166 手机不在服务区 1167 资源不足 1168 用户无响应 1169 用户拒绝 1170 交换设备忙 1171 超时 20301 无效用户 20302 无效设备 20303 无可用应答设备 20304 异常 20305 无效路由设备 20306 空号或错号 20307 被叫忙 20308 交换设备重启 20309 用户无响应 20310 未知异常 20920 呼叫资源不足 20921 无有效VDN 20922 呼叫失败 20923 路由座席失败 20924 无效技能队列 20925 路由技能队列失败 20926 路由转接人工失败 父主题： 附录

报文样例 请求头： x-app-key:9******************************3 Authorization:Bearer 9******************************7 请求参数: { "called": "8899", "voiceContent": "100001", "callerPresent": "2222201", "callBackUrl": "http://xx.xx.xx.xx:8800/callbackTest" } 响应参数: { "retMsg": "Created successfully.", "retCode": "0", "result": {"callSerialNo": "1308434073450058757"} }

请求说明 表1 请求头参数 序号 名称 参数类型 是否必选 说明 1 X-APP-Key string False appKey字段，用户标识 2 Authorization string True 鉴权字段，内容格式为：Bearer +tokenByAKSK接口的返回值中AccessToken（Bearer后有空格） 表2 请求体参数 序号 名称 参数类型 是否必选 说明 1 called string True 外呼被叫号码 长度限制:string(32) 2 voiceContent string True 录音id 长度限制:string(1024) 3 callBackUrl string False 回调URL 长度限制:string(256) 回调URL的域名或IP端口已通过系统管理员加入手机客服回调的地址白名单中。 4 callerPresent string False 用户侧主叫外显号码 长度限制:string(32) 5 priority string False 播放语音通知优先级参数。 取值范围1-9整数，默认值为9。数字越小优先级越高。

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