文档首页/云客服/API参考/座席操作类接口参考/座席班组:agentgroup/查询指定座席详细座席信息
更新时间：2025-11-13 GMT+08:00
查看PDF
分享

查询指定座席详细座席信息

前置条件

  • 座席已签入

场景描述

座席签入后，根据座席工号，查询指定座席详细座席信息。

接口方法

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

接口URI

https://ip:port/agentgateway/resource/agentgroup/{agentid}/agentbyworkno/{workno}

如果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。

2

workno

string

True

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

该座席工号必须与前面agentid为同一vdn下面的座席。

日志中的方法名

queryAgentInfoByWorkNo

请求说明

  • 消息头
    表2 请求头参数说明

    序号

    名称

    参数类型

    是否必选

    说明

    1

    Content-Type

    string

    True

    消息主体编码方式，缺省值：application/json; charset=UTF-8

    2

    Guid

    string

    True

    静态鉴权（AUTHMODE =1）签入接口返回的Guid；动态鉴权（AUTHMODE =2）轮询事件接口返回的Guid。

  • 消息体

    无

响应说明

表3 消息体参数说明

序号

名称

参数类型

说明

1

message

string

描述

2

retcode

string

错误码。取值如下：

0：成功

非0：失败

3

result

object

查询成功后，返回座席对象列表。

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

表4 result对象参数说明

序号

名称

参数类型

说明

3.1

workno

string

座席工号

3.2

name

string

座席名称

3.3

status

int

座席状态，参见表1

3.4

ctiStatus

int

座席平台状态，请参考表2

3.5

groupid

int

座席班组ID

3.6

groupname

string

未使用该返回参数

3.7

skilllist

list

座席技能对象列表

该对象的参数说明请参见表5。

3.8

callids

list

未使用该返回参数

3.9

mediatype

string

签入媒体服务器是否成功，T表示成功，F表示失败，三位分别表示CTIServer、WebM、MailM。只有签入CTIServer成功，才能进行音视频呼叫业务处理；只有签入WebM成功，才能进行文字交谈业务处理；当前不支持签入MailM。

3.10

vdnid

int

所属VDN ID

3.11

phonenumber

string

座席电话号码

3.12

currentstatetime

long

当前状态时长（秒）

3.13

logindate

long

签入时间，时间戳（毫秒）

3.14

inMultimediaConf

int

是否在多媒体会议中。

0表示不在多媒体会议中。

1表示在多媒体会议中。

3.15

currentStateReason

int

当前状态原因码

3.16

preRestFlag

boolean

标识座席是否预休息。

  • true：预休息状态
  • false：非预休息状态
说明：

组网为全容器化时，由于容器化CTI不支持，所以容器化CC-Gateway也不支持。

3.17

preBusyFlag

boolean

  • 标识座席是否预示忙。
  • true：预示忙状态
  • false：非预示忙状态
说明：

组网为全容器化时，由于容器化CTI不支持，所以容器化CC-Gateway也不支持。

表5 skilllist对象参数说明

序号

名称

参数类型

说明

3.7.1

name

string

技能名称

3.7.2

id

int

技能ID

3.7.3

mediatype

int

媒体类型。其中：

  • 1：文字交谈
  • 2：点击通话
  • 4：回呼请求
  • 5：普通音视频电话
  • 15：预测呼出
  • 16：预浏览呼出
  • 17：消息呼叫
  • 19：视频普通呼叫
  • 51：多媒体Web Chat
  • 53：Social Chat

触发事件

  • 无

错误结果码

  • 100-006
  • 100-007

报文样例

  • 消息头 
    Content-Type:application/json; charset=UTF-8
Guid：xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.AgentGateway1
  • 请求参数

    无

  • 响应参数 
    {
    "message": "",
    "retcode": "0",
    "result": {
        "workno": "20011",
        "name": "20011",
        "status": "4",
        "ctiStatus": "1",
        "groupid": 1,
        "groupname": "jst",
        "skilllist": [
            {
                "name": "clicktodial_jst",
                "id": 10,
                "mediatype": 2
            },
            {
                "name": "callback",
                "id": 2,
                "mediatype": 4
            },
            {
                "name": "webchat",
                "id": 3,
                "mediatype": 1
            },
            {
                "name": "email",
                "id": 4,
                "mediatype": 6
            },
            {
                "name": "voice_hym",
                "id": 5,
                "mediatype": 5
            },
            {
                "name": "voice",
                "id": 6,
                "mediatype": 5
            },
            {
                "name": "webchat_jst",
                "id": 9,
                "mediatype": 1
            }
        ],
        "mediatype": "TTT",
        "vdnid": 6,
        "phonenumber": "70942",
        "currentstatetime": 1210,
        "logindate": 1501125758000,
        "callids": [],
        "inMultimediaConf": 0,
        "currentStateReason": 0,
        "perRestFlag": false,
        "perBusyFlag": false
    }
}