文档首页/ 云客服/ API参考/ 呼叫中心配置类/ 技能队列管理/ 查询一组技能队列统计信息
更新时间：2023-09-27 GMT+08:00
查看PDF
分享

查询一组技能队列统计信息

前置条件

  • 座席已签入

场景描述

座席登录后，查询一组技能队列的统计信息。

接口方法

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

接口URI

https://ip:port/agentgateway/resource/queuedevice/{agentid}/queryacdstat

其中，ip为CC-Gateway服务器地址，port为CC-Gateway服务器的HTTPS端口号。

表1 URI中携带的参数说明

序号

参数名

数据类型

选取原则

说明

1

agentid

string

True

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

日志中的方法名

queryStatInfoOfAcd

请求说明

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

    序号

    名称

    参数类型

    是否必选

    说明

    1

    Content-Type

    string

    True

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

    2

    Guid

    string

    True

    静态鉴权（AUTHMODE = 1）签入接口返回的Guid；动态鉴权（AUTHMODE = 2）轮询事件接口返回的Guid。
  • 消息体
    表3 消息体参数说明

    序号

    名称

    参数类型

    是否必选

    说明

    1

    skills

    List

    True

    技能队列ID列表，数组长度不能大于100

响应说明

表4 消息体参数说明

序号

名称

参数类型

说明

1

message

string

描述

2

retcode

string

错误码。取值如下：

0：成功

非0：失败

3

result

array

查询成功后，返回技能队列的统计信息。

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

序号

名称

参数类型

说明

4.1

pilotNbr

string

技能队列的接入码

4.2

deviceNo

int

技能队列ID

4.3

queueSize

int

当前等待在队列中的呼叫数目

4.4

queueTime

long

队列中等待最久的呼叫的等待时间（秒）

4.5

loadFactor

int

该返回参数未使用

4.6

estWaitTime

long

该返回参数未使用

4.7

loggedOnAgents

int

当前注册到该技能队列的Agent数目

4.8

availAgents

int

该技能队列中当前可用的Agent数目

4.9

transferFlg

int

转移标志（0表示释放，2表示转接）

4.10

transferDeviceType

int

设备类型，请参考设备类型

4.11

transferDeviceNo

int

设备号码

4.12

skillDescrip

string

技能描述

4.13

resourceIdleRate

int

该返回参数未使用

4.14

serviceLevel

int

该返回参数未使用

4.15

oldCallIdEx

object

等待最久的呼叫ID信息对象。

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

4.16

maxQueueSize

int

队列最大可排多少呼叫
表6 oldCallIdEx对象参数说明

序号

名称

参数类型

说明

4.15.1

dateTime

Date

呼叫进入时间

4.15.2

dsn

int

呼叫进入的任务号

4.15.3

server

int

唯一标识一个服务器的标识

4.15.4

handle

int

呼叫进入一个任务的次数

oldCallIdEx转callId的计算方法：

StringBuilder buffer = new StringBuilder(24);

buffer.append(dateTime);

buffer.append('-');

long identify = ((long) server << 24) + ((long) handle << 16) + dsn;

buffer.append(identify);

触发事件

  • 无

错误结果码

  • 000-002
  • 100-006
  • 100-007

报文样例

  • 消息头 
    Content-Type:application/json; charset=UTF-8
Guid：xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.AgentGateway1
  • 请求参数 
    {
    "skills": [
        1,
        10
    ]
}
  • 响应参数 
    {
    "message": "",
    "retcode": "0",
    "result": [
        {
            "pilotNbr": "",
            "deviceNo": 1,
            "queueSize": 0,
            "queueTime": 0,
            "loadFactor": 65535,
            "estWaitTime": 0,
            "loggedOnAgents": 1,
            "availAgents": 1,
            "transferFlg": 0,
            "transferDeviceType": 255,
            "transferDeviceNo": 65535,
            "skillDescrip": "chat_madeqiang",
            "resourceIdleRate": 100,
            "serviceLevel": 100,
            "oldCallIdEx": {
                "dateTime": 4294967295000,
                "dsn": 65535,
                "server": 255,
                "handle": 255
            },
            "maxQueueSize": 100
        },
        {
            "pilotNbr": "1009",
            "deviceNo": 10,
            "queueSize": 0,
            "queueTime": 0,
            "loadFactor": 65535,
            "estWaitTime": 0,
            "loggedOnAgents": 2,
            "availAgents": 2,
            "transferFlg": 0,
            "transferDeviceType": 255,
            "transferDeviceNo": 65535,
            "skillDescrip": "chat_jinsitao",
            "resourceIdleRate": 100,
            "serviceLevel": 100,
            "oldCallIdEx": {
                "dateTime": 4294967295000,
                "dsn": 65535,
                "server": 255,
                "handle": 255
            },
            "maxQueueSize": 100
        }
    ]
}
父主题： 技能队列管理