更新时间:2023-12-19 GMT+08:00

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

场景描述

批量查询技能队列的详细统计信息。(该接口CTI3.6版本不支持)

接口方法

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

内部封装接口

BMS接口:

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

请求URL

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

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

skillIds

array

True

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

取值范围:1~2000。

响应消息

表3 响应消息体参数说明

序号

名称

参数类型

说明

1

result

String

查询结果。取值如下:

  • 0:成功
  • 其他:失败

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

说明:

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

2

resultCode

string

查询结果。取值如下:

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

3

resultDatas

array

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

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

说明:

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

4

resultDesc

array

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

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

表4 resultDesc/resultDatas对象参数说明

序号

名称

参数类型

说明

2.1

skillId

int

技能队列编号。

2.2

agentLoginNums

long

签入座席数。

2.3

agentTalkingNums

long

通话座席数。

2.4

agentIdleNums

long

空闲座席数。

2.5

agentAvailableNums

long

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

2.6

agentSetBusyNums

long

示忙座席数。

2.7

agentRestNums

long

休息座席数。

2.8

agentMaxIdleTimeIn5

long

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

2.9

agentWorkNums

long

事后整理座席数,包括调整态等。

2.10

agentStudyNums

long

学习态座席数。

2.11

agentOccupyNums

long

占用态座席数。

2.12

agentPreOccupyNums

long

预占用座席数。

2.13

totalCallNums

long

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

2.14

processingCallNums

long

正在处理的呼叫数。

2.15

maxCallWaitTimesIn5

long

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

2.16

callWaitNums

long

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

2.17

evenCallTimeIn5

long

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

2.18

evenWaitTimeIn5

long

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

2.19

allCallCount

long

当前5分钟呼入呼叫总和。

2.20

cnnedIn20sCallCount

long

当前5分钟内在20S内接通呼叫总和。

样例报文

  • 请求头:
    Content-Type: application/json;charset=UTF-8
    Authorization: ******************
  • 请求参数:
    {
        "queryParam":
        {
            "ccId":1, 
            "vdn":1, 
            "skillIds":[1,2]
        }
    }
  • 响应参数:
    {
        "result": "0",
        "resultCode": "0100000",
        "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,
                "allCallCount": 0,
                "cnnedIn20sCallCount": 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,
                "allCallCount": 0,
                "cnnedIn20sCallCount": 0
            }
        ],
        "resultDesc": [
            {
                "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,
                "allCallCount": 0,
                "cnnedIn20sCallCount": 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,
                "allCallCount": 0,
                "cnnedIn20sCallCount": 0
            }
        ]
    }