批量查询会议信息
前置条件
- 座席已签入
场景描述
调用此接口，可批量查询会议信息。
- 质检员可以批量查询所在VDN下所有会议信息。
- 普通座席只能查询自己所在会议的会议信息。
接口方法
设置成“POST”。该接口仅支持POST方法，不支持GET、PUT和DELETE等方法。
接口URI
https://ip:port/agentgateway/resource/agentconf/{agentid}/queryconfinfos
其中，ip为agentgateway服务器地址，port为agentgateway服务器的HTTPS端口号。
序号 |
参数名 |
数据类型 |
选取原则 |
说明 |
|---|---|---|---|---|
1 |
agentid |
string |
True |
座席的工号，取值范围：101～59999。 |
日志中的方法名
queryConfInfos
请求说明
- 消息头
表2 消息体参数说明 序号
名称
参数类型
是否必选
说明
1
Content-Type
string
True
消息主体编码方式，缺省值：application/json; charset=UTF-8
2
Guid
string
True
静态鉴权（AUTHMODE = 1）签入接口返回的Guid；动态鉴权（AUTHMODE = 2）轮询事件接口返回的Guid。
- 消息体
表3 消息体参数说明 序号
名称
参数类型
是否必选
说明
1
confIds
array
True
会议ID数组。
数组最大长度为20。
响应说明
序号 |
名称 |
参数类型 |
说明 |
|---|---|---|---|
1 |
message |
string |
描述
说明：
当出现错误提示“Unknown ERROR._*****”时，*****表示CTI错误结果码，详情请参见表2。 |
2 |
retcode |
string |
错误码。取值如下： 0：成功 非0：失败 |
3 |
result |
array |
请参考表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 |
序号 |
名称 |
参数类型 |
说明 |
|---|---|---|---|
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 |
加入会议的时间，时间戳（毫秒） |
触发事件
无
错误结果码
- 000-002
- 100-006
- 100-007
报文样例
- 消息头
Content-Type:application/json; charset=UTF-8 Guid：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 } ] } ] } }
