华为云用户手册

请求说明 表2 请求消息头参数 序号 名称 参数类型 是否必选 说明 1 Content-Type String True 固定填 application/json; charset=UTF-8。 2 Authorization String True 生成方式参见C2 监控/系统外呼/话单/知识库类接口鉴权方式。 3 locale String False i18n（internationalization，国际语言代码），如zh_CN表示中文、en_US表示英文等，默认zh_CN。 表3 请求消息体参数说明 序号 参数名 参数类型 是否必选 说明 1 blocklist List True 新增黑名单号码列表，最多20条。 号码最大长度为24个字符，有效字符为：0~9、*、# 2 validityExpirationTime String False 到期时间，到期时间=新增时间点+有效时长。例：“2020-12-31 10:06:25”新增2条黑名单号码，有效时长120小时，则到期时间为“2021-01-05 10:06:25”。 3 validityTime INT False 有效时长，单位小时，取值范围1~120。 4 restrictTimes INT False 限制次数（与限制周期绑定，两者都填或都不填，范围：1-100） 5 restrictPeriod 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

错误结果码 表5 错误原因码说明 序号 错误码 说明 1 0200001 参数异常，异常详情在resultDesc中描述。 2 0200006 数据库操作异常。 3 0200007 号码已存在黑名单中。 4 0200018 存在重复的号码。 5 0200029 超过了每次添加允许的最大值。 6 02000001 参数值为空 7 02000002 参数包含非法字符 8 02000003 参数长度不能大于规定长度 9 02000004 参数长度不能小于规定长度 10 02000005 参数长度需要介于规定长度之间 11 02000006 参数值类型不正确 12 02000007 参数值大小不正确 13 02000008 参数转换异常，请检查请求参数 14 02000009 参数组合不正确，请检查请求参数 15 02000010 hour和minute必须同时存在 16 02000011 参数个数不能大于规定个数

使用说明 前提条件 已经申请了开发者账号。 使用限制 黑名单号码最大长度为24个字符。 黑名单号码有效字符为：0~9、*、#。 每次只能增加20条黑名单号码，否则提示“超过单次新增最大数量”，且不新增黑名单号码。 每次追加的黑名单号码不能有重复，否则提示“号码重复”，且不新增黑名单号码。 每次追加的黑名单号码中不能存在已有黑名单号码。 当同时传入有效时长和到期时间时，则以指定时间（validityexpirationtime）为准处理。 限制次数小于重试策略设置的试呼次数。

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

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

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

请求说明 表2 请求消息头参数 序号 名称 参数类型 是否必选 说明 1 Content-Type String True 固定填 application/json; charset=UTF-8。 2 Authorization String True 生成方式参见C2 监控/系统外呼/话单/知识库类接口鉴权方式。 3 locale String False i18n（internationalization，国际语言代码），如zh_CN表示中文、en_US表示英文等，默认zh_CN。 表3 请求消息体参数说明 序号 参数名 参数类型 是否必选 说明 1 archiveHistory int False 是否移历史表。 取值范围：0，1。 0：不移历史表，直接删除。1：移入历史表。默认为0。

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

错误结果码 表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 不一致 100-019 查询技能队列时参数不合法 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 路由转接人工失败 父主题： 附录

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

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

请求说明 表2 请求消息头参数 序号 名称 参数类型 是否必选 说明 1 Content-Type String True 固定填 application/json; charset=UTF-8。 2 Authorization String True 生成方式参见C2 监控/系统外呼/话单/知识库类接口鉴权方式。 3 locale String False i18n（internationalization，国际语言代码），如zh_CN表示中文、en_US表示英文等，默认zh_CN。 无请求消息体。

接口URL 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 参数个数不能大于规定个数

请求说明 表2 请求消息头参数 序号 名称 参数类型 是否必选 说明 1 Content-Type String True 固定填 application/json; charset=UTF-8。 2 Authorization String True 生成方式参见C2 监控/系统外呼/话单/知识库类接口鉴权方式。 3 locale String False i18n（internationalization，国际语言代码），如zh_CN表示中文、en_US表示英文等，默认zh_CN。 无请求消息体。

报文样例 请求头: Content-Type:application/json;charset=UTF-8 Authorization:XXXXXXXXXXXXXXXXXXXXXXX 请求参数: { "callId" : "1688028889-836" } 响应参数: { "returnCode": "0200000", "recordList": [ { "interNo": "1", "userSaying": null, "systemReply": "啊您看我们请专门负责的同事和您简要介绍一下展会亮点您看可以吗只要和外贸相关的企业对于我们展会都会有兴趣的", "intention": null, "systemReplyTime": "2022-05-31 20:13:08", "requestTime": "2022-05-31 20:13:10", "responseSource": "0" }, { "interNo": "2", "userSaying": "null", "systemReply": "您好，欢迎使用智能机器人", "intention": null, "systemReplyTime": "2022-05-31 20:13:08", "requestTime": "2022-05-31 20:13:08", "responseSource": "0" } ], "resultCode": "0200000", "resultDesc": "success", "returnDesc": "success" }

响应说明 响应状态码: 200 表4 响应体参数 序号 名称 参数类型 是否必选 说明 1 resultCode String True 原因码。0200000表示成功，其他表示失败。 错误码请参考表5。 2 recordList List false 通话记录。 2.1 interNo string True 内部序号 2.2 systemReply string True 系统回复。 系统回复为IVR流程或智能IVR流程中的语音文件时，语音文件有杂音或为音乐将会无法准确转写为文本信息。 语音文件或 TTS 文本在通话过程中如果被打断无法播放完整，查询出来的系统回复也会是完整的语音文件内容。 2.3 userSaying string True 用户回复 2.4 intention string True 用户意图 2.5 systemReplyTime string True 系统回复时间 2.6 requestTime string True 用户请求时间 2.7 responseSource string True 回复来自机器人还是静默座席。 机器人--0，静默座席--1 3 resultDesc String true 返回描述信息 响应状态码: 404 请求的内容未找到：请检查请求的路径。 响应状态码: 500 业务失败：请依次确认您请求中各参数的取值

请求说明 表2 请求头参数 序号 名称 参数类型 是否必选 说明 1 Authorization string True 生成方式参见C2 监控/系统外呼/话单/知识库类接口鉴权方式。 2 Content-Type string True 固定填 application/json; charset=UTF-8。 3 locale String False i18n（internationalization，国际语言代码），如zh_CN表示中文、en_US表示英文等，默认zh_CN。 表3 请求体参数 序号 名称 参数类型 是否必选 说明 1 callId String true 通话记录ID，用于与CTI平台的话单等通话数据关联。通过查询外呼结果或者外呼结果回调接口中返回的callId字段获取。

错误码 表5 错误原因码说明 序号 错误码 说明 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 参数个数不能大于规定个数

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

报文样例 该接口的请求消息体举例如下： [ { "campaignId": "3", "sessionId": "1202_test013", "called": "60584", "callTimeStr": "2020-08-30 20:00:00", "callStatus": 6, "failCode": "0", "vdnId": 11, "callId": "0023-134864174", "recordPath": "Y:/1/11/20200830/3408/0949218.V3" } ] 该接口的响应消息体举例如下： { "retCode": "0", "retMsg": "success" }

使用说明 前提条件 已经申请了开发者账号。 外呼活动已经创建，并已添加外呼数据。 注意事项 接收请求后，需服务端返回200的响应，其他响应均认为推送失败。 接收到非200响应后，会立即再次推送。如果仍为非200响应，则认为本次推送失败。 使用限制 每条呼叫数据最大推送次数为 6 次。 推送失败后 10 分钟再次推送。 HTTPS采用TLS1.2及以上版本，确保web应用的敏感数据在传输过程中不被非法截获

请求说明 无请求头消息。 表1 请求消息体参数说明 序号 参数名 参数类型 说明 1 callResultList List 外呼结果列表，此处仅做说明，实际无此实体对象，response直接返回List。具体参考表2。 表2 callDataList参数说明 序号 参数名 参数类型 说明 1 campaignId String 外呼活动的id 2 sessionId String 标识用户的ID。 3 called String 被叫号码。 4 callTimeStr String 呼叫时间，格式为：yyyy-mm-dd hh:mm:ss。 5 callStatus int 呼叫结果（5: 呼叫失败，6: 呼叫成功）。 6 failCode String 失败的原因码，请参见表4。 7 vdnId int 外呼号码所属VDN ID。 8 callId String 通话记录ID，用于与CTI平台的话单等通话数据关联。 9 customField String 用户自定义字段。 10 recordPath String 通话录音文件的存储路径。 说明： 该字段仅在使用接续时（SAAS组网），才返回值，其他情况返回为空。

结果码 表4 外呼结果错误原因码说明 分类 错误原因码 错误原因描述 外呼成功 00000 外呼成功。 用户侧拆线 00531 外呼用户挂机。 00537 外呼号码被叫忙。 00538 外呼号码为空号或错号。 00548 外呼手机号码关机。 00549 外呼手机号码不在服务区。 00551 用户挂机。 00601 应答前用户挂机。 00603 外呼号码无应答后拆线。 00604 呼叫拒绝。 00701 外呼用户转队列，排队中用户主动挂机。 平台正常拆线 00702 外呼用户转队列，排队超时，平台释放呼叫（若配置为排队超时释放）。 01040 振铃超时，平台释放呼叫。（即在设置的振铃时间内，用户一直没有摘机） 01043 平台内部等待外呼结果超时。 01046 占用座席失败（转IVR外呼不涉及）。 01049 外呼检测超时。 34601 外呼任务不存在。 34605 电话号码为空，即外呼获取的被叫号码为空字符串。 34606 试呼失败，即调用呼出接口失败(比较常见的一种情况：当前的并发外呼数达到了最大外呼数；)，没有呼出到用户。 34608 呼出后，没有得到呼出结果信息，超时后将该呼叫数据回写。 系统资源不足，平台侧拆线 00602 系统资源不足，请联系管理员检查资源配置。 00605 01048 34606 系统异常 00606 请联系管理员排查。 34611 其他