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

查询指定座席详细信息

场景描述

查询指定座席详细信息。

接口方法

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

内部封装接口

BMS接口：/ccbms/ws/monitor/siteagentinfobyagentids

请求URL

https://ip:port/rest/cmsapp/v1/openapi/agent/agentbyworkno

其中，公有云环境请联系管理员获取，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

agentId

Int

True

座席工号。

取值范围：101-59999和70000-999999

响应消息

表3 消息体参数说明

序号

名称

参数类型

说明

1

result

String

查询结果。取值如下：

  • 0：成功
  • 其他：失败

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

说明：

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

2

resultCode

string

查询结果。取值如下：

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

3

resultDatas

object

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

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

说明：

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

4

resultDesc

object

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

该对象的参数说明请参见表4。
表4 resultDesc/resultDatas对象参数说明

序号

名称

参数类型

说明

2.1

workNo

int

座席工号。

2.2

vdnId

int

所属VDN ID。

2.3

citStatus

Int

座席平台状态。CTI平台座席状态码参考

2.4

name

String

座席名称。

2.5

phoneNumber

String

座席电话号码。

2.6

loginDate

long

签入时间。（毫秒级时间戳）

2.7

currentStateTime

long

当前状态时长 单位秒(s)。

2.8

mediaType

Int

座席媒体类型，请参见表1

2.9

status

Int

座席状态。表5
表5 座席状态

值

说明

0

未知。对应CTI平台状态的9。

1

签入状态。未使用。

2

签出状态。对应CTI平台状态的0。

3

示忙状态。对应CTI平台状态的7。

4

空闲状态。对应CTI平台状态的1。

5

整理态。对应CTI平台状态的6。

6

同空闲态。未使用。

7

通话态。对应CTI平台状态的2、3、4、5。

8

休息状态。对应CTI平台状态的8。

样例报文

  • 请求头： 
    Content-Type: application/json;charset=UTF-8
Authorization: ******************
  • 请求参数： 
    {
    "queryParam":
    {
        "ccId":1, 
        "vdn":1,
        "agentId":101
    }
}
  • 响应参数： 
    {
    "result": "0",
    "resultCode": "0100000",
    "resultDatas": {
        "workNo": 101,
        "vdnId": 1,
        "citStatus": 0,
        "name": "HW35154101",
        "phoneNumber": null,
        "loginDate": 4294967295000,
        "currentStateTime": 436879,
        "mediaType": 0,
        "status": 2
    },
    "resultDesc": {
        "workNo": 101,
        "vdnId": 1,
        "citStatus": 0,
        "name": "HW35154101",
        "phoneNumber": null,
        "loginDate": 4294967295000,
        "currentStateTime": 436879,
        "mediaType": 0,
        "status": 2
    }
}

相关文档