华为云用户手册

响应消息 表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 workSubStateBegin int 整理座席数 2.2 lateAdjust int 事后整理座席数 2.3 usable int 可用座席数 2.4 rest int 休息座席数 2.5 studying int 学习态座席数 2.6 setBusy int 示忙座席数 2.7 occupy int 占用态座席数 2.8 idle int 空闲座席数 2.9 preoccupy int 预占用态座席数 2.10 answering int 应答座席数 2.11 talking int 通话座席数 2.12 loginEd int 签入座席数 2.13 callOut int 呼出座席数

请求说明 表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。 其中技能队列ID取值范围：1~2000。 4 isSkillAllMatch string False 座席技能队列是否完全匹配。 取值类型为布尔型，取值如下，默认false。 true：是。表示座席签入的技能队列完全匹配所查询的技能队列时才统计。 false：否。表示座席签入的技能中，只要包含有要查询的技能队列之一就统计。

报文样例 请求消息样例 { "tenantId":"00030010"， "authToken": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"， "model": { "id": 22897， "faqGroupId": 10012， "question": "南京市购房限购"， "simQuestions": [ { "statement": "南京市购房限购政策"， "type": "Q" } ]， "answer": "每户限购2套"， "simAnswers": [ { "statement": "每户最多购买2套"， "type": "A" } ]， "keywords": [ { "w": "限购" } ] } } 响应消息样例 { "errorCode" : "0"， "errorMsg" : "" }

报文样例 请求头 POST /CCFS/resource/ccfs/getRecordFileUrlFromObs HTTP/1.1 Authorization: ************ Accept: */* Host: 10.154.198.164 Content-Type: application/json;charset=UTF-8 Content-Length: 185 请求参数 { "callId": "1637742300-27", "beginTime": "2021-11-24 06:25:03", "endTime": "2021-11-25 06:25:11", "version": "2.0" } 响应头 HTTP/1.1 200 OK Content-Type: application/json;charset=UTF-8 Date: Mon, 02 Jul 2018 02:43:03 GMT 响应参数 { "resultData": { "url": "https://south-aicc-develop.obs.cn-south-1.myhuaweicloud.com:443/ccfs/record/developId/13ddcde6-2072-40d2-b96f-58cac16e18f5?AccessKeyId=************&Expires=1637936620&Signature=************" }, "resultCode": "0", "resultDesc": "success" }

响应说明 表3 响应消息参数说明 参数名称 参数类型 说明 resultCode String 请求返回的结果码。 0：表示成功 其他：失败 resultDesc String 请求结果描述，详见错误码参考。 resultData Object 请求响应数据。 url String 调用本接口成功后，从OBS/LSS返回的录音播放和下载路径，失效时间默认8小时。 如果一个callid有多个录音文件，将会返回多个录音文件的播放和下载路径，url按开始时间和结束时间顺序排序。

请求说明 表1 请求Headers参数说明 参数名称 选取原则 参数类型 默认值 说明 Content-Type 必选 String 无 固定填 application/json; charset=UTF-8。 Authorization 必选 String 无 生成方式参见C2 监控/系统外呼/话单/知识库类接口鉴权方式。 表2 请求Body参数说明 参数名称 选取原则 参数类型 默认值 说明 callId 必选 String（1-25） 无 呼叫标识Id。 beginTime 必选 String 无 录音记录的起始时间。格式为：yyyy-MM-dd HH:mm:ss。 endTime 必选 String 无 录音记录的截止时间。格式为：yyyy-MM-dd HH:mm:ss。 录音记录的截止时间与起始时间跨度不能超过3天。 version 可选 String 无 当前接口版本，此版本为2.0。 须知： 东八区以外的其他时区：“录音记录的起始时间”和“录音记录的截止时间”两个参数需填入当前租间所在时区时间，且当前参数（version）必填。 东八区时区： “录音记录的起始时间”和“录音记录的截止时间”两个参数填写0时区时间，当前参数（version）可不填。 例如，您现在位于中国（东八区），您希望查询的开始时间为2022-01-02 10:00:00，那么“录音记录的起始时间”参数应该填入的值为2022-01-02 02:00:00。 “录音记录的起始时间”和“录音记录的截止时间”两个参数填写租间所在时区时间，当前参数（version）必填。

场景描述 调用该接口，将CC-FS侧的录音文件上传到OBS/LSS，再从OBS/LSS获取录音下载和播放的路径。 前提条件：录音文件已经通过定时任务同步到CCFS侧的数据库。 使用限制 开发者只能下载自己帐号下的录音，开发者帐号（ak）和录音记录（callId）必须对应。 开发者账号（ak）包含在鉴权认证字符串中，详见C2 监控/系统外呼/话单/知识库类接口鉴权方式。 callId、beginTime、endTime必须唯一确定一条录音。

报文样例 请求头: 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查询

响应说明 响应状态码: 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;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分钟内整理的总时长 （单位：秒）

请求消息样例 { "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） INSTAGRAM（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

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

响应消息 表3 消息体参数说明 序号 名称 参数类型 说明 1 result String 查询结果。取值如下： 0：成功 其他：失败 失败的原因说明请参见错误码参考。 说明： 当前字段为兼容8.13及其之前版本接口响应参数使用。 2 resultCode string 查询结果。取值如下： "0100000"：成功 其他：失败 失败的原因说明请参见错误码参考。 3 resultDatas boolean 查询成功后，返回true（有）/false（无）。 说明： 当前字段为兼容8.13及其之前版本接口响应参数使用。 4 resultDesc boolean 查询成功后，返回true（有）/false（无）。

请求说明 表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 agentId Int True 座席工号。 取值范围：101-59999

错误结果码 表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 路由转接人工失败 父主题： 附录

响应说明 当调用本接口响应成功，则从httpresponse消息中获取文件的二进制数据生成录音文件，文件后缀名为.wav，响应中content-type字段为Application/Octet-stream;charset=UTF-8。 当调用本接口响应失败，则返回相应的错误码信息，错误码响应数据结构请查看表 响应消息response参数说明，resultData为保留字段，默认为空字符串。 表4 响应消息参数说明 序号 名称 参数类型 说明 1 resultCode String 请求返回的结果码，详见错误码参考。 2 resultDesc String 请求结果描述。 3 resultData Object 请求响应数据

报文样例 请求头 POST /CCFS/resource/ccfs/ivr/downloadFile HTTP/1.1 Authorization: auth-v2/ak/2021-08-31T09:38:50.872Z/content-length;content-type;host/c12f0ed0******************94941bdd106 Accept: */* Content-Type: application/json;charset=UTF-8 Content-Length: 193 请求参数 { "request": { "version": "2.0" }, "msgBody": { "filePath": "Y:/3rdfile/53/thirdvoicebotfile", "mode":"1" } }

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

错误结果码 表4 错误原因码说明 序号 错误码 说明 1 0200001 参数异常，异常详情在resultDesc中描述。 2 0200006 数据库操作异常。 3 0200007 外呼活动已经不存在。 4 0200011 当前状态不允许暂停。 5 02000001 参数值为空 6 02000002 参数包含非法字符 7 02000003 参数长度不能大于规定长度 8 02000004 参数长度不能小于规定长度 9 02000005 参数长度需要介于规定长度之间 10 02000006 参数值类型不正确 11 02000007 参数值大小不正确 12 02000008 参数转换异常，请检查请求参数 13 02000009 参数组合不正确，请检查请求参数 14 02000010 hour和minute必须同时存在 15 02000011 参数个数不能大于规定个数

样例报文 请求头： Content-Type: application/json;charset=UTF-8 Authorization: ****************** 请求参数： { "ccId":1, "vdn":170, "offset":0, "limit":3 } 响应参数： { "result": "0", "resultCode": "0100000", "resultDatas": { "onRestAgentNum": 2, "allowRestAgentNum": 0, "details": [ { "agentId": 1034, "cantRestCause": 2, "vdnId": 170, "ccId": 1, "beginTime": 1602830642000, "applyRestLength": 600, "name": "zhang1130user" }, { "agentId": 1039, "cantRestCause": 0, "vdnId": 170, "ccId": 1, "beginTime": 1602830613000, "applyRestLength": 600, "name": "HW285601039", "reqRestDura": 238 }, { "agentId": 1099, "cantRestCause": 0, "vdnId": 170, "ccId": 1, "beginTime": 1602830638000, "applyRestLength": 600, "name": "HW285601099", "reqRestDura": 213 } ], "waitRestAgentNum": 1 }, "resultDesc": { "onRestAgentNum": 2, "allowRestAgentNum": 0, "details": [ { "agentId": 1034, "cantRestCause": 2, "vdnId": 170, "ccId": 1, "beginTime": 1602830642000, "applyRestLength": 600, "name": "zhang1130user" }, { "agentId": 1039, "cantRestCause": 0, "vdnId": 170, "ccId": 1, "beginTime": 1602830613000, "applyRestLength": 600, "name": "HW285601039", "reqRestDura": 238 }, { "agentId": 1099, "cantRestCause": 0, "vdnId": 170, "ccId": 1, "beginTime": 1602830638000, "applyRestLength": 600, "name": "HW285601099", "reqRestDura": 213 } ], "waitRestAgentNum": 1 }, "count": 30 }

响应说明 表3 响应消息体参数说明 序号 名称 参数类型 说明 1 result String 查询结果。取值如下： 0：成功 其他：失败 失败的原因说明请参见错误码参考。 说明： 当前字段为兼容8.13及其之前版本接口响应参数使用。 2 resultCode string 查询结果。取值如下： "0100000"：成功 其他：失败 失败的原因说明请参见错误码参考。 3 resultDatas object 查询成功后，返回结果信息的对象。 该数组中对象的参数说明请参见表4。 说明： 当前字段为兼容8.13及其之前版本接口响应参数使用。 4 resultDesc object 查询成功后，返回结果信息的对象。 该对象中的参数说明请参见表4 5 count int 当前查询VDN下座席总数。 表4 resultDesc/resultDatas对象参数说明 序号 名称 参数类型 说明 2.1 onRestAgentNum int 正在休息人数。 2.2 allowRestAgentNum int 已经允许休息人数，但是座席仍然未休息的座席人数。 2.3 waitRestAgentNum int 申请休息人数。 2.4 details Array 座席休息详情，该对象数组的参数说明具体见表5。 说明： 当前响应结果为limit和offset分页入参条件下获取的座席休息数据 例如：limit：10 ，offset：10 表示入参获取第二页（10个/页）的10个座席，再统计这十个座席中的休息态数据 表5 座席休息详情 序号 名称 参数类型 媒体类型描述 2.4.1 agentId int 座席工号。 2.4.2 cantRestCause int 座席不允许休息的原因，此参数仅对于等待休息的座席有效。 该对象的参数说明请参见表6 2.4.3 vdnId int 虚拟呼叫中心编号。 2.4.4 ccId int 呼叫中心编号。 2.4.5 beginTime long 开始时间（若正在休息指休息开始时间，若还未休息指申请或批准休息开始时间），时间格式：时间戳。 2.4.6 applyRestLength int 申请休息时长（单位：秒）。 2.4.7 name String 座席姓名。 2.4.8 reqRestDura long 休息持续时长（正在休息的座席已经休息的时长），单位：秒 2.4.9 skillIds String 等待休息的座席签入的技能队列，仅当cantRestCause等于4时才有值返回。 表6 不允许休息原因 不允许休息原因值 如何理解 0 等待批准 1 座席示忙 2 VDN 休息人数已满。 3 座席不接来话，未签入任何技能队列。 4 签入队列休息人数已满。