更新时间:2023-09-27 GMT+08:00

批量查询技能队列的详细统计信息

场景描述

批量查询技能队列的详细统计信息。

  • 在集成环境下如需调用该接口,呼叫中心ccId需要配置成1。

接口方法

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

内部封装接口

BMS接口:

  • /ccbms/ws/monitor/querycurrentcallstatinfo
  • /ccbms/ws/monitor/queryStatInfoOfEverySkill

请求URL

https://ip:port/rest/cmsapp/v1/openapi/realindex/skill/stateinfo

其中,ip为NSLB的服务器IP地址,port为CC-CMS服务在NSLB映射的HTTPS端口号。

请求说明

表1 请求头参数

序号

名称

参数类型

是否必选

说明

1

Content-Type

String

True

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

2

Authorization

String

True

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

  • 消息头

    Content-Type:application/json; charset=UTF-8

  • 消息体
    该接口的请求消息体举例如下:
    {
        "queryParam":
        {
            "ccId":1, 
            "vdn":1, 
            "skillIds":[1,2]
        }
    }

    该接口的请求消息体参数说明请参见表2

    表2 请求消息体参数说明。

    参数名

    数据类型

    是否必选

    说明

    ccId

    int

    True

    呼叫中心编号。

    取值范围:1~65535

    vdn

    int

    True

    虚拟呼叫中心编号。

    取值范围:1~5000

    skillIds

    array

    True

    技能队列ID信息的对象数组。数组长度不大于1000。

响应消息

该接口的响应消息体举例如下:

{ 
    "result": "0",
    "resultDatas":[{
        "skillId":1,
        "agentLoginNums":1,
        "agentTalkingNums":0,
        "agentIdleNums":0,
        "agentAvailableNums":0,
        "agentSetbusyNums":1,
        "agentRestNums":0,
        "agentMaxIdleTimeIn5":0,
        "agentWorkNums":0,
        "agentStudyNums":0,
        "agentOccupyNums":0,
        "agentPreOccupyNums":0,
        "totalCallNums":0,
        "processingCallNums":0,
        "maxCallWaitTimesIn5":0,
        "callWaitNums":0,
        "evenCallTimeIn5":0,
        "evenWaitTimeIn5":0},
        {
        "skillId":2,
        "agentLoginNums":0,
        "agentTalkingNums":0,
        "agentIdleNums":0,
        "agentAvailableNums":0,
        "agentSetbusyNums":0,
        "agentRestNums":0,
        "agentMaxIdleTimeIn5":0,
        "agentWorkNums":0,
        "agentStudyNums":0,
        "agentOccupyNums":0,
        "agentPreOccupyNums":0,
        "totalCallNums":0,
        "processingCallNums":0,
        "maxCallWaitTimesIn5":0,
        "callWaitNums":0,
        "evenCallTimeIn5":0,
        "evenWaitTimeIn5":0}
    ] 
}

该接口的响应消息体参数说明请参见表3

表3 响应消息体参数说明

参数名

数据类型

说明

result

string

查询结果。取值如下:

  • 0:成功
  • 非0:失败

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

resultDatas

array

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

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

表4 resultDatas对象参数说明

参数名

数据类型

说明

skillId

int

技能队列编号。

agentLoginNums

int

签入座席数。

agentTalkingNums

int

正在通话座席数。

agentIdleNums

int

空闲座席数。

agentAvailableNums

int

可用座席的数目(在座席可一对多通话时,此值与空闲座席数可能不同)。

agentSetbusyNums

int

示忙座席数。

agentRestNums

int

休息座席数。

agentMaxIdleTimeIn5

int

最长座席空闲时间(5分钟内)。

agentWorkNums

int

事后整理座席数。

agentStudyNums

int

学习态座席数。

agentOccupyNums

int

占用态座席数。

agentPreOccupyNums

int

预占用座席数。

totalCallNums

int

已处理的呼叫总数(包括正在处理的呼叫)。

processingCallNums

int

正在处理的呼叫数。

maxCallWaitTimesIn5

int

最长呼叫等待时间(5分钟内)。

callWaitNums

int

排队的呼叫数(等待呼叫数)。

evenCallTimeIn5

int

平均通话时长(5分钟内平均)。

evenWaitTimeIn5

int

平均呼叫等待时长(5分钟内平均)。