华为云用户手册

响应说明 表3 消息体参数说明 序号 名称 参数类型 说明 1 message string 描述 说明： 当出现错误提示“Unknown ERROR._*****”时，*****表示CTI错误结果码，详情请参见表2。 2 retcode string 错误码。取值如下： 0：成功 非0：失败 3 result map 请参考表4 表4 会议ID数组 序号 名称 参数类型 说明 3.1 confIds array 会议ID数组

响应说明 表4 消息体参数说明 序号 名称 参数类型 说明 1 message string 描述 说明： 当出现错误提示“Unknown ERROR._*****”时，*****表示CTI错误结果码，详情请参见表2。 2 retcode string 错误码。取值如下： 0：成功 非0：失败 3 result map 只有失败时，才返回该参数。请参考表5 表5 放音失败原因 序号 名称 参数类型 说明 3.1 errorReason int 放音失败时透传排队机侧返回的失败原因码。

接口URI https://ip:port/agentgateway/resource/agentconf/{agentid}/playvoicetoparticipant 其中，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", "playMode": 2, "voicePath": "y:/conf/120/1136287.V3"} 响应参数 { "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字节。 3 playMode int False 放音模式。 2：播放指定文件音。 默认值为2。 4 voicePath voicePath True 文件绝对路径名。文件格式为: 盘符/conf/vdn编号/放音文件名，例如： y:/conf/120/1136287.V3 最大长度为127个字符。

报文样例 消息头 Content-Type:application/json; charset=UTF-8Guid：xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.AgentGateway1 请求参数 { "address": "88887946", "addressType": "6", "playMode": 2, "voicePath": "y:/conf/120/1136287.V3"} 响应参数 { "result": {}, "message": "success", "retcode": "0"}

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

请求说明 消息头 表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字节。 3 playMode int False 放音模式。 2：播放指定文件音。 默认值为2。 4 voicePath String True 文件绝对路径名。文件格式为: 盘符/conf/vdn编号/放音文件名，例如： y:/conf/120/1136287.V3 最大长度为127个字符。

请求说明 消息头 表2 请求头参数说明 序号 名称 参数类型 是否必选 说明 1 Content-Type string True 消息主体编码方式，缺省值：application/json; charset=UTF-8 2 Guid string True 静态鉴权（AUTHMODE = 1）签入接口返回的Guid；动态鉴权（AUTHMODE = 2）轮询事件接口返回的Guid。 消息体 表3 消息体参数说明 序号 名称 参数类型 是否必选 说明 1 userType string True 用户类型。 默认为“agent”代表座席 2 callid string True 呼叫标识。

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

报文样例 消息头 Content-Type:application/json; charset=UTF-8Guid：xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.AgentGateway1 请求参数 {"callid":"1552524689-16797284","userType":"agent"} 响应参数 {"message": "success","retcode": "0","result":{ "userId": "坐席工号", "ctime": "过期时间", "channelId": "15945185-345", "appId": "8345234631", "ip": "xxx.xxx.xxx.xxx", "port": "6500", "role": "0", "signalingDomainIn": "https: //in.isdpdomain.com", "signalingDomainOut": "https: //out.isdpdomain.com", "locationId": "65535", "signature": "xxx", "appId": "sdcp0BPcVGymItWppGX6XqrZGTCYa13d" }}

响应说明 表4 消息体参数说明 序号 名称 参数类型 说明 1 retcode string 消息发送结果。 0：成功 非0：失败 2 message string 描述 3 result object 查询成功后，返回连接信息对象。 该对象的参数说明请参见表5。 表5 result对象参数说明 序号 名称 参数类型 说明 1 userId string 坐席工号 2 ctime string 过期时间 3 channelId string 频道ID（房间ID） 4 role string 角色 5 ip string 媒体服务器接入点IP地址 6 port string 媒体服务器接入点端口 7 signalingDomainIn string 内侧信令domain； 格式：https:// 域名 :端口 8 signalingDomainOut string 外侧信令domain； 格式：https://域名:端口 9 locationId string 节点 10 signature string 签名 11 appId string 用户标识

请求说明 消息头 表2 请求头参数说明 序号 名称 参数类型 是否必选 说明 1 Content-Type string True 消息主体编码方式，缺省值：application/json; charset=UTF-8 2 Guid string True 静态鉴权（AUTHMODE = 1）签入接口返回的Guid；动态鉴权（AUTHMODE = 2）轮询事件接口返回的Guid。 消息体 表3 消息体参数说明 序号 名称 参数类型 是否必选 说明 1 callid string True 呼叫标识。 2 caller string False 主叫号码。 3 devicetype int True 转出的设备类型。 1：技能队列 2：座席 4：系统接入码 4 mode int True 转出的模式，详细释义见表4。 当devicetype值为1时取值： 0：释放转 2：成功转 当devicetype值为2时取值： 0：释放转。 2：成功转。 当devicetype值为4时取值： 0：释放转。 2：成功转。 5 address string True 转移地址，即转移设备类型对应的设备ID。最大长度24。 当devicetype为1时，此处为技能队列编号；当devicetype为2时，此处为座席平台工号；当devicetype为4时，此处为系统接入码。 6 calldata string False 携带数据给转接的座席，最大不能超过2048个字节。 7 skillId Integer 可选 技能ID。当devicetype为业务代表为2时，设置该字段才有效。

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

报文样例 消息头 Content-Type:application/json; charset=UTF-8Guid：xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.AgentGateway1 请求参数 { "callid": "1552524689-16797284", "caller": "88880021", "devicetype": 2, "mode": 2, "address": "205", "calldata": "help"} 响应参数 { "message": "success", "retcode": "0"}

接口URI https://ip:port/agentgateway/resource/calldata/{agentid}/waitcallinfo/{skillid} 其中，ip为agentgateway服务器地址，port为agentgateway服务器的HTTPS端口号。 表1 URI中携带的参数说明 序号 参数名 数据类型 选取原则 说明 1 agentid string True 座席的工号，取值范围：101～59999。 2 skillid int True 被查询技能队列ID。

响应说明 表3 消息体参数说明 序号 名称 参数类型 说明 1 message string 描述 2 retcode string 错误码。取值如下： 0：成功 非0：失败 3 result list 查询成功后，返回排队等待呼叫信息对象列表。 该对象的参数说明请参考表4。 表4 result对象参数说明 序号 名称 参数类型 说明 3.1 callfeature int 呼叫类型，请参考呼叫类型 3.2 callid string 呼叫ID 3.3 caller int 主叫号码 3.4 called int 被叫号码 3.5 callskill string 呼叫技能描述 3.6 callskillid int 呼叫技能ID 3.7 orgicallednum string 未使用该返回参数 3.8 calldata string 随路数据 3.9 begintime long 应答开始时间，时间戳（毫秒） 3.10 endtime long 未使用该返回参数 3.11 userPriority int 客户级别 3.12 trunkNo int 中继号 3.13 logontimes int 进入总时长（秒）。 3.14 mediaType int 媒体类型。其中： 1：文字交谈 2：点击通话 4：回呼请求 5：普通音视频电话 15：预测呼出 16：预浏览呼出 17：消息呼叫 19：视频普通呼叫 51：多媒体Web Chat 53：Social Chat 3.15 mediaAbility int 媒体能力。其中： 1：音频 2：视频 3：音视频 3.16 waitTime long 等待应答时间，时间戳（秒） 3.17 trace HWCallDeviceTraceEx 呼叫轨迹扩展属性，预留字段，默认为空。

报文样例 消息头 Content-Type:application/json; charset=UTF-8Guid：xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.AgentGateway1 请求参数 无 响应参数 { "message": "", "retcode": "0", "result": [ { "callfeature": 0, "callid": "1476707884-279", "caller": "70004", "called": "60015", "callskill": "voice", "callskillid": 1, "orgicallednum": "", "calldata": "", "begintime": 1476707884000, "endtime": null, "userPriority": 0, "mediaType": 5, "mediaAbility": 1, "waitTime": 0, "trace": null }, { "callfeature": 0, "callid": "1476707885-280", "caller": "70003", "called": "60015", "callskill": "voice", "callskillid": 1, "orgicallednum": "", "calldata": "", "begintime": 1476707885000, "endtime": null, "userPriority": 0, "trunkNo": 65535, "logontimes": 0, "mediaType": 5, "mediaAbility": 1, "waitTime": 0, "trace": null } ]}

停止录音成功 标示符 AgentMediaEvent_StopRecordDone 作用 座席停止录音成功。 附带信息 beginTime：录音开始时间。 endTime：录音结束时间。 taskId表示平台内部的录音任务号。 fileMediaType表示媒体类型，1是音频，2视频。 示例： {"eventType":"AgentMediaEvent_StopRecordDone","workNo":"1115","content":{"beginTime":1566867437000,"endTime":1566867472000,"fileMediaType":"1","taskId":5451,"jsonKey":["beginTime","endTime","taskId"]},"jsonKey":["eventType","workNo","content"]} 父主题： 录音事件

监视座席通知事件 表示符 QC_AgentState_Notify 作用 表示某个座席的监视（质检）事件。 附带信息 agentname：表示座席工号或用户名。 subtype：子类型，表示被监视座席的状态或操作。 示例： {"eventType":"QC_AgentState_Notify","workNo":"107","content":{"subtype":"QC_AgentState_Login","monitoredagent":"108","agentname":"108","mediaserver":"CtiServer","jsonKey":["subtype","monitoredagent","agentname","mediaserver"]},"jsonKey":["eventType","workNo","content"]} 其中subtype的类型有： QC_AgentState_Login:监视座席签入事件 QC_AgentState_Logout:监视座席签出事件。 父主题： 实时质检事件

音视频切换 标示符 AgentEvent_MediaSwith 作用 音频呼叫切换视频呼叫场景中，座席调用音视频切换接口，选择媒体类型为视频，调用成功后呼叫从音频切换到视频时，座席会收到该事件，reason为0时表示从IVR返回成功。 附带信息 reason表示切换原因码，0代表成功，其余为失败。 caller表示主叫号码。 called表示被叫号码。 callId表示呼叫唯一标记。 mediaType表示媒体类型。 示例： {"eventType":"AgentEvent_MediaSwith","workNo":"111","content":{"callid":"1603286369-16773","reason":0,"caller":"","mediaType":3,"called":"88022","jsonKey":["callid","reason","caller","mediaType","called"]},"jsonKey":["eventType","workNo","content"]} 父主题： 音视频通话事件

从IVR返回 标示符 AgentEvent_ReturnFromIvr 作用 音视频呼叫的转移场景中，座席调用转移接口，选择转移设备类型为IVR，转移模式为挂起转进行呼叫转移，转移成功后呼叫从IVR返回到座席时，座席会收到该事件表示从IVR返回成功。 附带信息 content：文本型，呼叫所属于的CallId（呼叫标示）。 示例： {"message":"","retcode":"0","event":{"eventType":"AgentEvent_ReturnFromIvr","workNo":"108","content":"1529571145-1187"}}} 父主题： 音视频通话事件

请求说明 表1 请求头参数 序号 名称 参数类型 是否必选 说明 1 X-APP-Key string False appKey字段，用户标识 2 Authorization string True 鉴权字段，内容格式为: Bearer +tokenByAKSK接口的返回值中AccessToken（Bearer后有空格） 表2 请求体参数 序号 名称 参数类型 是否必选 说明 1 userId String True 用户id。 t_aicc_pub_appcube_user表中USER_ID的值。

响应说明 响应状态码: 200 表3 响应体参数 序号 名称 参数类型 是否必选 说明 1 id string False 主键id 2 callType string False 呼叫类型 0：直呼 1：双呼 2：透显呼叫 3 callerPresent String[] False 被叫显示号码。 最多5个，多个号码之间以，隔开 每个号码长度限制：string（15） 4 callNumber String[] False 坐席软电话号码。 最多5个，多个号码之间以，隔开 每个号码长度限制：string（15） 5 userId String False 用户id t_aicc_pub_appcube_user表中SUM_USER_ID的值。 6 callNumberDefault String False 默认坐席绑定的软电话号码。 长度限制：string（15） 7 callerPresentDefault String False 被叫默认显示号码。 长度限制：string（15） 8 agentName String False 坐席绑定的业务帐号。 9 returnCode string True 0：成功 其他值表示失败 10 returnDesc string False 响应结果描述。 11 createTime string False 配置创建时间 12 partdbId string False 分区id 13 tenantId string False 租间id 响应状态码: 400 错误的请求：请检查请求路径及参数。 响应状态码: 401 未授权：1.请确认是否购买了相关服务。2.请联系客服人员检查您账号的当前状态。 响应状态码: 404 请求的内容未找到：请检查请求的路径。 响应状态码: 500 业务失败：请依次确认您请求中各参数的取值。

报文样例 请求头: x-app-key:9******************************3 Authorization:Bearer e******************************e Content-Type:application/json 请求参数: {"userId": "10gg000000y6OOrNaUFs"} 响应头: {"connection": "keep-alive","content-type": "application/json;charset=UTF-8"} 响应参数: { "returnCode": "0", "callNumber": [ "12323", "232343", "233", "239343" ], "callerPresent": [ "12323" ], "callNumberDefault": "23232323", "agentName": "y111", "id": "1307145259662215169", "userId": "10gg000000y6OOrNaUFs", "callerPresentDefault": "1212121212", "returnDesc": "query success", "callType": "1"}

CTI返回系统配置接口错误码 表1 VDN 错误结果码 说明 120501 同时签入的最大业务代表数超过限制 120502 并发语音最大呼叫数超过限制 120503 并发Web最大呼叫数超过限制 120504 最大并发OutBound呼出数超过限制 120505 CP会场方数超过限制 120506 同时签入的最大视频业务代表数超过限制 120507 限制主叫号码不能存在包含关系 120508 启用限制,限制主叫号码前缀不能为空 120509 启用限制,默认主叫以限制主叫号码前缀开头 120510 VDN名称与其它VDN名称重复 120511 VDN名称与VDN组名称重复 120512 VDN工号范围与其它VDN重复 120513 VDN引用的OBS不存在 120514 VDN引用的分布式资源不存在 120515 VDN引用的数据源不存在 120516 VDN引用的IVR不存在 120517 RMS 基本信息配置中录音系统为无时,本VDN采用的录音系统只能配置为华为排队机资源录音 120519 VDN强制自录音中使用的分布式节点在VDN设置中未分配 120520 VDN引用的系统接入码不存在 120521 VDN的呼叫类型不支持Email/Fax,当前VDN分配了该媒体类型的系统接入码 120522 VDN的呼叫类型不支持Web,当前VDN分配了该媒体类型的系统接入码 120523 VDN分配的系统接入码已经分配到其它VDN 120524 VDN分配的系统接入码已经分配到VDN组 120525 IVR数据源不在VDN分配的VDN数据源或第三方数据源中 120526 默认IVR数据源不在VDN分配的VDN数据源或第三方数据源中 120527 该VDN被本地CCP客户端引用,不能删除 120528 启用座席挂起转,呼叫转回座席后放提示音,必须配置提示音参数 120529 VDN管理员必须在工号范围内 120530 VDN引用的盘符不存在 120531 VDN基本信息的接入码没有分配当前VDN 120533 VDN工号范围重复 120534 VDN引用的C CS 资源组不存在 120535 工号范围已使用,不能取消 120536 可用VDN的长度不能为0 120537 可用VDN不能包含转移VDN 120538 可转移工号个数不足 120539 多媒体许可类型无效 120540 多媒体许可值超出范围 120541 座席并发处理能力1~60 120550 并发视频IVR最大呼叫数不能超过并发IVR最大呼叫数 120552 uap视频会场方数限制 120624 修改的vdn对接密码与旧密码相同 表2 接入码 错误结果码 说明 120201 系统接入码重复 120202 系统接入码与特殊路由接入码重复 120203 系统接入码与NIRC的网络呼叫接入码重复 120204 系统接入码被VDN引用，不能删除 120205 系统接入码被VDN组引用，不能删除 父主题： 错误码定义

报文样例 请求头： x-app-key:9******************************3 Authorization:Bearer 9******************************7 请求参数: { "called": "8899", "playList": [ { "voiceId": "100001", "templateParams": [ "100", "200" ] } ], "playTimes": 1, "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 playList array[object] True 数组长度：1-5 2.1 voiceId string False 录音id（voiceId，voiceFileName，templateId必须填写1个） 2.2 voiceFileName string False 录音文件名（voiceId，voiceFileName，templateId必须填写1个） 2.3 templateId string False 模板id（voiceId，voiceFileName，templateId必须填写1个） 2.5 templateParams array[string] False 数组长度：1-10 长度限制:string(32) 3 callBackUrl string False 回调URL 长度限制:string(256) 回调URL的域名或IP端口已通过系统管理员加入手机客服回调的地址白名单中。 4 callerPresent string False 用户侧主叫外显号码 长度限制:string(32) 5 playTimes number False 播放次数 范围：1-5 6 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 业务失败：请依次确认您请求中各参数的取值。

报文样例 请求头： 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"}}