文档首页/云客服/API参考/座席操作类接口参考/座席会议:agentconf/批量查询会议信息
更新时间：2025-11-13 GMT+08:00
查看PDF
分享

批量查询会议信息

前置条件

  • 座席已签入

场景描述

调用此接口，可批量查询会议信息。

  • 质检员可以批量查询所在VDN下所有会议信息。
  • 普通座席只能查询自己所在会议的会议信息。

接口方法

设置成“POST”。该接口仅支持POST方法，不支持GET、PUT和DELETE等方法。

接口URI

https://ip:port/agentgateway/resource/agentconf/{agentid}/queryconfinfos

如果CC-Gateway单机部署，IP地址为CC-Gateway服务器地址，port为CC-Gateway服务器的HTTPS端口号，默认值为8043；如果CC-Gateway采用集群模式部署，IP请配置为NSLB地址， Port请配置为默认值8043。

NSLB上的CC-Gateway端口号，请以nslb用户登录任意一个NSLB节点，执行./nslbctl l查询，查询结果中，如下端口表示CC-Gateway通过NSLB面向第三方系统开放的端口。

SaaS场景下请咨询运维人员获取IP和Port。

表1 URI中携带的参数说明

序号

参数名

数据类型

选取原则

说明

1

agentid

string

True

座席的工号，取值范围：101～999999。

日志中的方法名

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。

响应说明

表4 消息体参数说明

序号

名称

参数类型

说明

1

message

string

描述

说明：

当出现错误提示“Unknown ERROR._*****”时，*****表示CTI错误结果码，详情请参见表2。

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

加入会议的时间，时间戳（毫秒）

触发事件

无

错误结果码

  • 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
                    }
                ]
            }
        ]
    }
}