文档首页/云客服/API参考/监控类接口参考/接口说明/实时数据查询类接口/VDN维度实时接口/查询指定VDN下的所有座席的静态配置信息
更新时间：2025-11-13 GMT+08:00
查看PDF
分享

查询指定VDN下的所有座席的静态配置信息

场景描述

查询指定VDN下的所有座席的静态配置信息。

接口方法

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

请求URL

https://ip:port/rest/cmsapp/v1/openapi/vdn/queryagentstaticconfinfo

其中，公有云环境请联系管理员获取，ip为CC-CMS服务器地址，port为CC-CMS服务器的HTTPS端口号。

非公有云环境如果配置了NSLB服务，ip请填写NSLB的服务器地址，port为CC-CMS服务在NSLB映射的HTTPS端口号。

请求说明

表1 请求头参数

序号

名称

参数类型

是否必选

说明

1

Content-Type

String

True

固定填 application/json; charset=UTF-8。

2

Authorization

String

True

生成方式参见C2 监控/系统外呼/话单/知识库类接口鉴权方式。

表2 请求消息体参数说明

序号

名称

参数类型

是否必选

说明

1

ccId

int

True

呼叫中心编号。

取值范围：1～65535

2

vdn

int

True

虚拟呼叫中心编号。

取值范围：1～5000

3

offset

int

True

分页offset参数

取值范围：大于等于0

4

limit

int

True

分页limit参数

取值范围：1～100

响应消息

表3 响应消息体参数说明

序号

名称

参数类型

说明

1

result

String

查询结果。取值如下：

  • 0：成功
  • 其他：失败

失败的原因说明请参见错误码参考。

说明：

当前字段为兼容8.13及其之前版本接口响应参数使用。

2

resultCode

string

查询结果。取值如下：

  • "0100000"：成功
  • 其他：失败
  • 失败的原因说明请参见错误码参考。

3

resultDatas

array

查询成功后，返回结果信息的对象数组。

该数组中对象的参数说明请参见表4。

说明：

当前字段为兼容8.13及其之前版本接口响应参数使用。

4

resultDesc

array

查询成功后，返回结果信息的对象数组。

该数组中对象的参数说明请参见表4

5

count

int

当前查询VDN下座席总数。

表4 resultDesc/resultDatas对象参数说明

序号

名称

参数类型

说明

2.1

agentId

int

座席工号

2.2

groupId

int

所属班组ID，目前该字段取-1值

班组：为了方便对业务代表进行管理，通常对虚拟呼叫中心的业务代表进行分组。分为一组的业务代表形成一个班组（目前AICC不支持该字段只返回-1 ，即没有所属班组）

2.3

rights

string

座席的权限值。0表示没有权限，1表示有权限。角色权限位说明如表5

2.4

name

string

座席姓名

2.5

realFlag

int

是否为网络座席。取值：0表示网络座席，1表示普通座席。AICC当前均为普通座席

表5 座席权值

位数

描述

1

示忙/示闲

2

静音/结束静音

3

保持/取保持

4

连接保持

5

普通呼出

6

内部呼叫

7

内部转移

8

接转接来话

9

三方通话

10

转出

11

人工转移自动

12

不接来话

13

监听/监听插入/耳语

14

拦截

15

强制签出/强制示忙/强制示闲

16

质检录音/质检放音

17

质检监视

18

考评管理员

19

普通考评员

20

告警台

21

报表处理员

22

未使用，平台保留值

23

监控台

24

配置管理员

25

报表管理员

26

国内长途呼出

27

国际长途呼出

28

本呼叫中心接入码呼出

29

全屏质检

30

同组代答

31

未使用，平台保留值

32

配置业务代表

33

技能配置

34

不可填写外呼主叫

35

配置审计

36~128

未使用，平台保留值

样例报文

  • 请求头： 
    Content-Type: application/json;charset=UTF-8
Authorization: ******************
  • 请求参数： 
    {
    "ccId":1, 
    "vdn":170,
    "offset":0,
    "limit":100
}
  • 响应参数： 
    {
    "result": "0",
    "resultCode": "0100000",
    "count": 30,
    "resultDatas": [
        {
            "agentId": 1086,
            "groupId": -1,
            "rights": "[1,1,1,1,1,1,1,1,1,1,1,0,0,0,0,0,0,0,0,0,0,0,1,0,0,1,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]",
            "name": "HW285601086",
            "realFlag": 1
        },
        {
            "agentId": 1087,
            "groupId": -1,
            "rights": "[1,1,1,1,1,1,1,1,1,1,1,0,0,0,0,0,0,0,0,0,0,0,1,0,0,1,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]",
            "name": "HW285601087",
            "realFlag": 1
        }
    ],
    "resultDesc": [
        {
            "agentId": 1086,
            "groupId": -1,
            "rights": "[1,1,1,1,1,1,1,1,1,1,1,0,0,0,0,0,0,0,0,0,0,0,1,0,0,1,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]",
            "name": "HW285601086",
            "realFlag": 1
        },
        {
            "agentId": 1087,
            "groupId": -1,
            "rights": "[1,1,1,1,1,1,1,1,1,1,1,0,0,0,0,0,0,0,0,0,0,0,1,0,0,1,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]",
            "name": "HW285601087",
            "realFlag": 1
        }
    ]
}