座席会议:agentconf-华为云

云客服-申请座席会议:报文样例

报文样例消息头 Content-Type:application/json; charset=UTF-8 Guid：xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.AgentGateway1 请求参数 { "memberNum": 4, "confCallerNo": "10000", "time": 50, "promptTime": 5, "beepTone": true, "playMode": 2, "voicePath": "y:/conf/120/1136287.V3" } 响应参数 { "result": {}, "message": "success", "retcode": "0" }

云客服座席会议:agentconf

云客服-申请座席会议:触发事件

触发事件通话中（AgentState_Busy）物理话机振铃（AgentOther_PhoneAlerting）物理话机摘机（AgentOther_PhoneOffhook）自己加入会议（AgentConf_SelfJoinResult）会议申请成功（AgentConf_RequestSuccess）会议申请失败（AgentConf_RequestFailed）会议结束前提示时长：会议超时提醒事件（AgentConf_Timeout）

云客服座席会议:agentconf

云客服-申请座席会议:请求说明

请求说明消息头表2 请求头参数说明序号名称参数类型是否必选说明 1 Content-Type string True 消息主体编码方式，缺省值：application/json; charset=UTF-8 2 Guid string True 静态鉴权（AUTHMODE = 1）签入接口返回的Guid；动态鉴权（AUTHMODE = 2）轮询事件接口返回的Guid。消息体表3 消息体参数说明序号名称参数类型是否必选说明 1 memberNum int True 会场能够容纳的与会人数。取值范围：1～120。 2 confCallerNo String False 会议外呼用户时显示的主叫号码。最大长度为24字节。不输入参数时，平台默认使用VDN配置台基本信息的系统主叫号码。在VDN有号码限制的情况，需要号码在限制范围内。 3 time int False 会议申请时长。单位：分钟。取值范围：4～1440。默认值为60。 4 promptTime int False 会议结束前提示时长。可选参数。单位：分钟。取值范围：3～1440。默认值为3。如果大于等于会议申请时长，按照申请时长-1计算。 5 beepTone boolean False 有用户加入、退出会议时是否播放提示音。默认值为false。 6 playMode int False 2：播放指定文件音，默认值为2。 7 voicePath String False 文件绝对路径名。文件格式为: 盘符/conf/vdn编号/放音文件名，例如： y:/conf/120/1136287.V3 当“BeepTone”设置为“true”时，此参数必须设置并且playMode需要为2；当“BeepTone”设置为“false”时，此参数设置无效。最大长度为127。

云客服座席会议:agentconf

云客服-申请座席会议:场景描述

场景描述座席调用该接口申请一个座席会议，调用成功后则需要等待后续的异步事件，申请成功后，申请会议的座席会成为会议主席。申请会议的座席接收到AgentConf_SelfJoinResult事件，表明申请会议的座席自身已加入到会议中，但还需要继续等待AgentConf_RequestSuccess事件后，座席才能进行会议主席相关的操作。在收到AgentConf_RequestSuccess事件前，座席调用会议相关的接口操作时，平台会直接返回失败。当前座席处于空闲或者通话状态，处于通话状态时当前呼叫必须处于一个稳定状态，否则申请座席会议会失败，例如：在通话过程中进行放音、静音、保持呼叫、挂起转，则申请座席会议会返回失败。三方通话过程中如果存在两个座席，被叫座席不允许发起座席会议。与会者类型仅支持座席工号或电话号码。电话会议方数小于等于vdn中设置的“并发语音最大呼叫数”。

云客服座席会议:agentconf

云客服-申请座席会议:接口URI

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

云客服座席会议:agentconf

云客服-退出座席会议:接口URI

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

云客服座席会议:agentconf

云客服-批量查询会议信息:报文样例

报文样例消息头 Content-Type:application/json; charset=UTF-8Guid：xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.AgentGateway1 请求参数 { "confIds": [ 1029888, 1029889 ]} 响应参数 { "message": "", "retcode": "0", "result": { "confs": [ { "confId": 1029888, "confState": 0, "startTime": 1475745454000, "applyConfTime": 60, "confHaveBeenTime": 29, "addresses": [ { "addressType": "6", "address": "70005", "deviceCallType": 0, "deviceType": 0, "channelAttrib": 3, "channelState": 0, "role": 0, "enterTime": 1475745464000 }, { "addressType": "9", "address": "153", "deviceCallType": 0, "deviceType": 6, "channelAttrib": 3, "channelState": 0, "role": 1, "enterTime": 1475745454000 } ] } ] }}

云客服座席会议:agentconf

云客服-批量查询会议信息:响应说明

响应说明表4 消息体参数说明序号名称参数类型说明 1 message string 描述 2 retcode string 错误码。取值如下： 0：成功非0：失败 3 result array 请参考表5 表5 会议信息序号名称参数类型说明 3.1 confId long 会议id 3.2 confState int 会议状态。 0：正常会议通话。 1：会场放音 3.3 startTime long 会议开始时间，时间戳（毫秒） 3.4 applyConfTime int 申请会议时长，单位分钟 3.5 confHaveBeenTime int 会议已进行时长，单位分钟 3.6 addresses array 与会者列表，请参考表6 表6 与会者信息序号名称参数类型说明 3.6.1 addressType String 3地址类型。 6：电话号码 9：座席工号 3.6.2 address String 地址标识。 3.6.3 deviceCallType int 自定义的设备呼叫类型，详细见表3。 3.6.4 deviceType int 自定义的设备类型，详细见表2。 3.6.5 channelAttrib int 会议属性。 1：只听。 2：只说。 3：听说。 3.6.6 channelState int 会议通道状态。 0：正常会议通话中。 1：保持。 2：放音。 3.6.7 role int 会议角色。 0：与会者。 1：主席。 3.6.8 enterTime long 加入会议的时间，时间戳（毫秒）

云客服座席会议:agentconf

云客服-批量查询会议信息:接口URI

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

云客服座席会议:agentconf

云服务器内容精选

座席会议:agentconf

7*24

备案

专业服务

退订

建议反馈

售前咨询热线