华为云用户手册

呼叫类型 表1 呼叫类型 编号 呼叫类型 描述 呼叫方式 0 SP_CALL_NORMAL 普通呼入 呼入 1 SP_CALL_SPECIAL 特殊呼入 呼入 2 KE11_CALL VMS呼叫（获取语音信息） 呼出 3 KE15_CALL VMS呼叫（删除语音信息） 呼出 4 BP_CALL VMS呼叫（向BP发送信息） 呼出 5 SP_CALL_LONG 长途呼入呼叫 呼入 6 INTER_CALL 内部呼叫 内部呼叫是指一个业务代表向另一个业务代表发起呼叫并实现通话。内部呼叫不能被转出、不能被静音。 呼出 7 SP_CALL_OUT 普通呼出 一般指人工呼出。 呼出 8 OP_CALL_OUT 座席呼出类型 呼出 9 OP_PRI_OUT PRI呼出 呼出 10 IVR_CALL_OUT IVR呼出 呼出 11 SELF_CALLOUT 电话座席的自身呼出 呼出 12 IVR_PRI_CALL IVR PRI呼出 呼出 13 NIRC_CALL_IN 网络呼叫中心的呼入 呼入 14 NIRC_CALL_OUT 网络呼叫中心的呼出 呼出 15 NIRC_SPY_CALL_IN 网络呼叫中心的质检呼入 呼入 16 NIRC_SPY_CALL_OUT 网络呼叫中心的质检呼出 呼出 17 NIRC_INTER_CALL_IN 内部呼叫虚座席的网络呼入 呼入 18 NIRC_INTER_CALL_OUT 内部呼叫虚座席的网络呼出 呼出 20 ICD_SP_OPS_AIDERCALL 辅助呼叫 呼出 21 ICD_SP_OPS_INCALL 来话呼叫(国际话务员) 呼入 22 ICD_SP_OPS_PASSCALL 递延呼叫 呼出 23 ICD_SP_OPS_GIVECALL 去话呼叫(国际话务员) 呼出 30 ICD_SP_VCP_ISDNCALL_IN 视频呼入实际呼叫（排队机发起） 呼入 31 ICD_SP_VCP_ISDNCALL_OUT 视频呼出实际呼叫（到排队机） 呼出 32 ICD_SP_VCP_VIRTUALCALL_IN_2BD 视频呼入2B+D虚呼叫（2路呼叫整合成的一路呼叫） 呼入 33 ICD_SP_VCP_VIRTUALCALL_IN_6BD 视频呼入6B+D虚呼叫（6路呼叫整合成的一路呼叫） 呼入 34 ICD_SP_VCP_VIRTUALCALL_OUT_2BD 视频呼出2B+D虚呼叫（C CS 发起） 呼出 35 ICD_SP_VCP_VIRTUALCALL_OUT_6BD 视频呼出6B+D虚呼叫（CCS发起） 呼出 40 OUTBOUND_CALL_OUT 预约呼出 预约呼出就是系统定期查询一次预约呼出数据库，将预约时间在当前机器时间之前的所有预约呼叫取回，进行强制呼出。 呼出 41 ICD_SP_OUTBOUND_PRE_OCCUPY 预占用呼出 系统首先占用某空闲座席，然后才发起呼出，成功后由该座席处理。 呼出 42 ICD_SP_OUTBOUND_PRE_CONNECT 预连接呼出 系统直接向用户发起呼叫，呼叫成功用户开始振铃后再连接座席。 呼出 43 ICD_SP_OUTBOUND_VIRTUAL_CALLIN 预测呼出 系统直接向用户发起呼叫，呼叫成功用户摘机后再连接座席。 呼出 44 ICD_SP_OUTBOUND_PREVIEW 预览呼出 呼出信息首先发给座席预览，然后由座席发起呼叫。 呼出 45 ICD_SP_OUTBOUND_CALLBACK 回呼请求 当Web用户在因特网上进行浏览时，如需要与呼叫中心取得联系，可以通过该网页的“回呼请求”服务，由呼叫中心的业务代表呼叫该Web用户预先指定的电话号码。 当电话接通后，Web用户既可以接受业务代表的语音指导，同时又可以享受到护航浏览等其他服务。 呼出 46 ICD_SP_IDD 国际长途来话 呼入 50 ICD_SP_CBRT_CALL 彩铃业务呼叫 呼出 51 ICD_SP_INTERNAL_TWO_HELP 两方求助呼叫 业务代表在接听来话的时候，可以发起内部求助。如果是两方求助，客户的呼叫被保持，业务代表和被求助的业务代表通话。 呼出 52 ICD_SP_INTERNAL_THREE_HELP 三方求助呼叫 业务代表在接听来话的时候，可以发起内部求助。如果是三方求助，用户、业务代表和被求助的业务代表三方通话。在两方求助的情况，可以通过再发起三方求助进行三方通话。 呼出 60 ICD_SP_OUTBOUND_PRE_OCCUPY_PRI_CALL 预占用PRI呼出 呼出 61 ICD_SP_OUTBOUND_PRE_CONNECT_PRI_CALL 预连接PRI呼出 呼出 62 ICD_SP_OUTBOUND_VIRTUAL_CALLIN_PRI_CALL 虚呼入PRI呼出 呼出 63 ICD_SP_OUTBOUND_PREVIEW_PRI_CALL 预览PRI呼出 呼出 64 ICD_SP_OUTBOUND_CALLBACK_PRI_CALL PRI回呼请求 呼出 80 SP_SUBSCRIBE_CALLIN SUBSCRIBE呼入 呼入 81 SP_SUBSCRIBE_CALLOUT SUBSCRIBE呼出 呼出 82 SP_VOICE_OPEN_CALLIN 互联网话音呼入 呼入 83 SP_VOICE_OPEN_CALLOUT 互联网话音呼出 呼出 90 SP_ROUTEOUT_CALLOUT 路由到外部DN呼出 呼出 92 BRIDGE_PHONE_CALL_IN 座席phone桥呼叫的呼入 呼入 93 BRIDGE_PHONE_CALL_OUT 座席phone桥呼叫的呼出 呼出 94 AGENT_CONF_CALL 人工会议占用呼叫 呼出 95 OFFLINE_OUT 离线外呼 呼出 96 SMC_PROXY_CALL 视频报警 代理呼叫 呼出

接口URI https://ip:port/agentgateway/resource/agentconf/{agentid}/requestleaveagentconf 其中，ip为agentgateway服务器地址，port为agentgateway服务器的HTTPS端口号。 表1 URI中携带的参数说明 序号 参数名 数据类型 选取原则 说明 1 agentid string True 座席的工号，取值范围：101～59999。

接口URI https://ip:port/agentgateway/resource/agentconf/{agentid}/unholdparticipant 其中，ip为agentgateway服务器地址，port为agentgateway服务器的HTTPS端口号。 表1 URI中携带的参数说明 序号 参数名 数据类型 选取原则 说明 1 agentid string True 座席的工号，取值范围：101～59999。

报文样例 消息头 Content-Type:application/json; charset=UTF-8Guid：xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.AgentGateway1 请求参数 { "address": "2002", "addressType": "9"} 响应参数 { "result": {}, "message": "success", "retcode": "0"}

请求说明 消息头 表2 请求头参数说明 序号 名称 参数类型 是否必选 说明 1 Content-Type string True 消息主体编码方式，缺省值：application/json; charset=UTF-8 2 Guid string True 静态鉴权（AUTHMODE = 1）签入接口返回的Guid；动态鉴权（AUTHMODE = 2）轮询事件接口返回的Guid。 消息体 表3 消息体参数说明 序号 名称 参数类型 是否必选 说明 1 addressType String True 地址类型。 6：电话号码 9：座席工号 2 address String True 地址标识，即电话号码或者座席工号。 最大长度为24字节。

请求说明 消息头 表2 请求头参数说明 序号 名称 参数类型 是否必选 说明 1 Content-Type string True 消息主体编码方式，缺省值：application/json; charset=UTF-8 2 Guid string True 静态鉴权（AUTHMODE = 1）签入接口返回的Guid；动态鉴权（AUTHMODE = 2）轮询事件接口返回的Guid。 消息体 表3 消息体参数说明 序号 名称 参数类型 是否必选 说明 1 attribute int True 与会者属性。 1：只能听，不能说。 2：只能说，不能听。 3：既能听，也能说。 4：不能听，不能说。 2 addressType String True 地址类型。 6：电话号码 9：座席工号 3 address String True 地址标识，即电话号码或座席工号。 最大长度为24字节。

接口URI https://ip:port/agentgateway/resource/agentconf/{agentid}/changeparticipantmode 其中，ip为agentgateway服务器地址，port为agentgateway服务器的HTTPS端口号。 表1 URI中携带的参数说明 序号 参数名 数据类型 选取原则 说明 1 agentid string True 座席的工号，取值范围：101～59999。

报文样例 消息头 Content-Type:application/json; charset=UTF-8Guid：xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.AgentGateway1 请求参数 { "attribute": 3, "address": "88887744", "addressType": "6"} 响应参数 { "result": {}, "message": "success", "retcode": "0"}

呼叫离开设备原因 表1 呼叫进入/离开设备原因 原因码 含义 0 普通接入/转移 1 溢出转 2 超时转 3 无人上班转 4 取消排队转移 5 座席久不应答转移 6 挂起恢复 7 连接保持 8 三方求助 9 取保持 10 三方通话 11 内部求助，求助方释放 12 拦截 13 代答 14 呼叫的被叫分析未配置 15 用户主动释放 16 座席释放 17 转出 18 保持 19 内部处理错误 20 被叫忙 22 手机关机 23 手机不在服务区 24 空号 25 排队机无资源 26 用户不应答 27 被叫拒绝 28 成功转队列 29 三方转队列 30 成功转队列超时 31 三方转队列超时 34 超时/溢出/遇忙网呼失败排队 35 网络呼叫返回原呼叫中心排队 36 排队的呼叫重路由 37 由呼入路由进入CDN 38 由座席咨询进入CDN 39 CDN正常返回路由结果 40 CDN路由超时 41 咨询时座席取消或路由失败 42 由CDN路由超时进入PGR 43 由CDN正常返回路由进入PGR 44 由呼入路由进入PGR 45 由座席咨询进入PGR 46 座席不可达，CDN重路由 47 呼叫在多个队列排队 48 在从队列中接听主队列的呼叫 49 座席拒绝呼入来话（取消） 50 座席拒接呼叫 51 用户呼叫进入电话会议 52 会议主席主动释放会议，或CCS异常导致会议释放 53 与会者被请出会议 54 接通率低于阈值转接 88 座席应答后，用户挂机 89 座席应答前，用户挂机 父主题： 参考说明

座席操作类型 表1 座席操作类型 操作类型 含义 操作对象 操作原因 0 座席签出CCS。 -1 1~255：客户端传入原因 256：座席与平台断连 257：座席被质检员强制签出 258：座席主动签出 259：座席重新签入前的签出 260：媒体服务器和CCS关于座席控制块握手超时 261：CCS检测到与UIS关于座席控制块握手超时 262：媒体服务器与CCS握手断连导致座席签出 263：UIS与座席握手超时 264：具有相同工号的座席正在新的客户端强制登录，导致本座席被强制签出 1 座席签入。 -1 -1 2 空闲。 -1 -1 3 示忙。 -1 1：自己示忙 2：久不应答被示忙 3：被质检员强制示忙 4：休息 5：座席电话不可用 7：座席拒接呼叫 200～250：业务自定义原因码 4 通话态。 -1 1：座席未真实退出通话态时，每个准点0分和5分输出的话单。 0：座席完全退出通话态时的话单。 说明：此通话态话单仅表示文字交谈时的话单 10 三方通话。 工号 -1 13 人工转自动，业务代表处于挂起状态。 -1 -1 20 监听/插入/耳语。 工号 0 22 放音。 -1 -1 26 座席休假(休息)。 工号 休息原因由客户端调用CCC_REQUEST_REST_EX_Msg时指定（默认0）。 27 工作状态。 -1 0：事后整理，业务侧设置自动进入工作态。 0~255：手动调整，由业务座席通过调用接口手动进入工作态。 缺省为0，即事后整理。 29 强制签出。 工号 -1 30 强制示闲。 工号 -1 31 强制示忙。 工号 -1 32 座席对用户静音。 -1 -1 38 座席保持呼叫。 工号 -1 40 座席发起内部求助。 工号 0：无组合操作 1：两方人工求助 2：三方人工求助 3：通话转被叫应答后先和业务代表通话，业务代表释放时连接主被叫用户。 4：三方通话转被叫应答后实现三方通话，业务代表释放时连接主被叫用户。 5：三方通话 6：连接呼叫 41 座席发起内部呼叫。 工号 -1 43 拦截呼叫。 工号 -1 44 暂停放音。 -1 -1 45 内部转移。 工号 -1 46 转出。 -1 -1 47 签入媒体服务器。 -1 -1 52 签出媒体服务器。 -1 -1 53 转移正在公有队列中排队的呼叫。 -1 -1 54 释放转。 -1 -1 55 转移到其他设备。 -1 -1 57 内部求助时切换保持。 -1 -1 58 座席进入“会议态”。 座席工号 -1 父主题： 参考说明

呼叫子媒体类型说明 表1 呼叫子媒体类型（对应呼叫媒体类型编号53） 编号 子媒体类型 描述 1 SUB_MEDIA_TYPE_WEB WEB 2 SUB_MEDIA_TYPE_WHATSAPP WhatsApp 3 SUB_MEDIA_TYPE_LINE Line 4 SUB_MEDIA_TYPE_WECHAT 微信 5 SUB_MEDIA_TYPE_FACEBOOK FaceBook Messenger 6 SUB_MEDIA_TYPE_TWITTER Twitter 7 SUB_MEDIA_TYPE_5GMESSAGE 5G消息 8 SUB_MEDIA_TYPE_EAMIL Email 9 SUB_MEDIA_TYPE_ SMS SMS 父主题： 参考说明

报文样例 请求头 POST /CCFS/resource/ccfs/ivr/deleteFile HTTP/1.1Authorization: auth-v2/ak/2021-08-31T09:38:50.872Z/content-length;content-type;host/c12f0ed0******************941bdd106Accept: */*Content-Type: application/json;charset=UTF-8Content-Length: 193 请求参数 { "request": { "version": "2.0" }, "msgBody": { "fileName": "Y:/3rdfile/2/thirdvoicebotfile/5dckNDei_1647502396161.wav" }} 响应参数 { "resultData": null, "resultCode": "0", "resultDesc": "success"}

响应说明 当调用本接口响应成功，则返回0和operate success。 当调用本接口响应失败，则返回相应的错误码信息，错误码响应数据结构请查看表4，resultData为保留字段，默认为空字符串。 表4 响应消息参数说明 序号 名称 参数类型 说明 1 resultCode String 请求返回的结果码，详见错误码参考。 2 resultDesc String 请求结果描述。 3 resultData Object 请求响应数据

响应说明 当调用本接口响应成功，则返回对应录音文件的二进制数据流，可供windows media player直接播放。 当调用本接口响应失败，则返回相应的错误码信息，响应中content-type字段为application/octet-stream;charset=UTF-8，错误码响应数据结构请查看表2，resultData为保留字段，默认为null。 表2 响应消息参数说明 序号 名称 参数类型 说明 1 resultCode String 请求返回的结果码，详见错误码参考。 2 resultDesc String 请求结果描述。 3 resultData Object 请求响应数据 4 response Object 请求结果对象，参数说明详见表3 不推荐使用，为兼容老版本保留字段。 表3 响应消息response参数说明 序号 名称 参数类型 说明 4.1 version String（1-32） 协议版本，如2.0。 4.2 resultCode String(1-32) 请求返回的结果码，详见错误码参考。 4.3 resultMsg String 请求结果描述。

报文样例 请求示例 GET https://ip:port/CCFS/resource/ccfs/playVoice?t=1596677685425&version=2.0&st=7D41CF5DE98948979AAE063114C8AFCF3 响应头 HTTP/1.1 200 OKContent-Type: application/octet-stream;charset=UTF-8Date: Mon, 02 Jul 2018 02:43:03 GMT 响应参数 { "resultData": null, "resultCode": "010106", "resultDesc": "Parameter token is empty."}

响应说明 该接口的响应说明体举例如下： 下载失败时： 消息头Content-Type: application/json;charset=UTF-8 消息体示例请参见报文样例 表3 消息体参数说明 序号 名称 参数类型 说明 1 message string 描述 2 retcode string 错误码。取值如下： 0：成功 非0：失败 3 result object 预留字段 下载成功时： 消息头 Content-Type: application/octet-stream;charset=utf-8 消息体 文件流

报文样例 消息头 Content-Type:application/json; charset=UTF-8Guid：xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.AgentGateway1 请求参数 无 响应参数 { "retcode": "000-003", "message": "no right to invite resource", "result": ""}

前置条件 Gateway已经打开了视频文件下载开关（VIDEO_DOWNLOAD_FLAG 配置为ON）和视频事件开关（IF_SUPPORT_VIDEO配置为ON），配置文件路径：/home/elpis/tomcat/webapps/agentgateway/WEB-INF/config/basic.properties。 Gateway已经挂载文件服务器。 座席已签入。 配置文件中已配置挂载目录。

接口URI https://ip:port/agentgateway/resource/recordfile/{agentid}/videofiledownloadEx?recordId=xxx&locationId=xxx 例 其中，ip为CC-Gateway服务器地址，port为CC-Gateway服务器的HTTPS端口号。 表1 URI中携带的参数说明 序号 名称 参数类型 是否必选 说明 1 agentid string True 座席的工号，取值范围：101～59999。 2 recordId string True 视频文件路径。 说明： 如果recordId不传，默认下载第一条录播地址对应的视频文件。 3 locationId int False 节点Id（CTI POOL模式下为必选）

接口URI https://ip:port/CCFS/resource/ccfs/ivr/uploadFile?vdnId={vdnId} 其中，ip为CC-FS安装的服务器IP地址，port为CC-FS的HTTPS端口号。 如果经过NSLB路由，ip为NSLB的服务器IP地址，port为CC-FS服务在NSLB映射的HTTPS端口号。 表1 URL中携带的参数说明 序号 名称 参数类型 是否必选 说明 1 vdnId int True 虚拟呼叫中心 id。

报文样例 请求头 POST /CCFS/resource/ccfs/ivr/upload?vdnId=xx HTTP/1.1Authorization: auth-v2/ak/2021-08-31T09:38:50.872Z/content-length;content-type;host/c12f0ed******************941bdd106Accept: */*Content-Type: application/json;charset=UTF-8Content-Length: 193 请求参数 { "request": { "version": "2.0" }, "msgBody": { "data":"base64" }} 响应参数 { "resultData": { "fileName": "Y:/3rdfile/53/thirdvoicebotfile/8fSsBaEb_1631869974029.wav", "locationId": [ "0", "256" ] }, "resultCode": "0", "resultDesc": "success"}

响应说明 当调用本接口响应成功，则从httpresponse消息中获取文件的二进制数据生成录音文件，文件后缀名为.wav，响应中content-type字段为Application/Octet-stream;charset=UTF-8。 当调用本接口响应失败，则返回相应的错误码信息，错误码响应数据结构请查看表 响应消息response参数说明，resultData为保留字段，默认为空字符串。 表5 响应消息参数说明 序号 名称 参数类型 说明 1 resultCode String 请求返回的结果码，详见错误码参考。 2 resultDesc String 请求结果描述。 3 resultData Object 请求响应数据 4 response Object 请求结果对象，参数说明详见表6 不推荐使用，为兼容老版本保留字段。 表6 响应消息response参数说明 序号 名称 参数类型 说明 4.1 version String（1-32） 协议版本，如2.0。 4.2 resultCode String(1-32) 请求返回的结果码，详见错误码参考。 4.3 resultMsg String 请求结果描述。

报文样例 请求头 POST /CCFS/resource/ccfs/downloadOiapRecordHTTP/1.1Authorization: auth-v2/ak/2018-07-02T02:45:50Z/content-length;content-type;host/eb453f68e******************96c509c4913Accept: */*Content-Type: application/json;charset=UTF-8Content-Length: 193 请求参数 { "request": { "version": "2.0" }, "msgBody": { "fileName": "Y:/39/odfsrecord/20201019/1603089033-1205143033.wav" }}

接口URI https://ip:port/CCFS/resource/ccfs/downloadOiapRecord?locationId={locationId} 其中，ip为CC-FS安装的服务器IP地址，port为CC-FS的HTTPS端口号。 如果经过NSLB路由，ip为NSLB的服务器IP地址，port为CC-FS服务在NSLB映射的HTTPS端口号。 表1 URL中携带的参数说明 序号 名称 参数类型 是否必选 说明 1 locationId int False 节点Id，通过调用会话记录查询接口（https://IP:PORT/oifde/rest/api/queryRecordHistory）查询locationId。

请求说明 表2 请求Request参数说明 序号 名称 参数类型 是否必选 默认值 说明 1 Content-Type String True 无 固定填 application/json; charset=UTF-8。 2 Authorization String True 无 生成方式参见C2 监控/系统外呼/话单/知识库类接口鉴权方式。 表3 请求Body中request参数说明 序号 名称 参数类型 是否必选 默认值 说明 1 version String（1-32） True 2.0 协议版本。当前固定值为2.0。 表4 请求Body中msgBody参数说明 序号 名称 参数类型 是否必选 默认值 说明 1 fileName String（1-127） True 无 智能IVR录音文件名称 参数格式： 一：{录音盘符}:/{record}/{vdnId}/{odfsrecord}/{yyyymmdd}/{文件主名}.wav； 例如：Y:/record/39/odfsrecord/20201015/10233946082696733.wav 二：{录音盘符}:/{vdnId}/{odfsrecord}/{yyyymmdd}/{文件主名}.wav； 例如：Y:/39/odfsrecord/20201015/10233946082696733.wav 三： {录音盘符}:/{record}/{vdnId}/{yyyymmdd}/{文件主名}.wav ； 例如：Y:/record/39/20201015/10233946082696733.wav 四：{录音盘符}:/{vdnId}/{transferrecord}/{yyyymmdd}/{文件主名}.wav 例如：Y:/39/transferrecord/20201015/10233946082696733.wav 说明：{vdnId}为vdn编号，{yyyymmdd}为生成智能IVR录音文件的日期，{文件主名}为录音文件的名称。

报文样例 消息头 Content-Type:application/json; charset=UTF-8Guid：xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.AgentGateway1 请求参数 { "fileName": "Y:/12/0/20211019/155/1406470.V3", "position": "0", "playTime": "1", "fileFormat": "0", "ccId": "1", "locationId": "-1"} 响应参数 { "result": {}, "message": "success", "retcode": "0"}

接口URI https://ip:port/agentgateway/resource/recordplay/{agentid}/backfast/{time} 其中，ip为CC-Gateway服务器地址，port为CC-Gateway服务器的HTTPS端口号。 表1 URI中携带的参数说明 序号 参数名 数据类型 选取原则 说明 1 agentid string True 座席的工号，取值范围：101～59999。 2 time string True 快进的时长，单位为秒（s），取值范围：0~2147483647。

接口URI https://ip:port/agentgateway/resource/recordplay/{agentid}/netplay 其中，ip为CC-Gateway服务器地址，port为CC-Gateway服务器的HTTPS端口号。 表1 URI中携带的参数说明 序号 参数名 数据类型 选取原则 说明 1 agentid string True 座席的工号，取值范围：101～59999。

请求说明 表1 请求Headers参数说明 序号 名称 参数类型 是否必选 默认值 说明 1 Content-Type String True 无 固定填 application/json; charset=UTF-8。 2 Authorization String True 无 生成方式参见C2 监控/系统外呼/话单/知识库类接口鉴权方式。 表2 请求Body中request参数说明 序号 名称 参数类型 是否必选 默认值 说明 1 version String（1-32） True 2.0 协议版本。当前固定值为2.0。 表3 请求Body中msgBody参数说明 序号 名称 参数类型 是否必选 默认值 说明 1 fileName String True 无 录音文件相对路径名称，从调用“下载话单和录音索引”时返回的录音索引文件字段“original_file_name”中获取。 注意：fileName中“\”需改为“/”。

接口URI https://ip:port/agentgateway/resource/recordplay/{agentid}/stoprecordscreen 其中，ip为agentgateway服务器地址，port为agentgateway服务器的HTTPS端口号。 表1 URI中携带的参数说明 序号 参数名 数据类型 选取原则 说明 1 agentid string True 座席的工号，取值范围：101～59999。