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

获取技能队列实时监控指标

场景描述

获取技能队列实时监控指标。

接口方法

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

内部封装接口

BMS接口:/ccbms/ws/monitor/rindexSkill

请求URL

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

其中,公有云环境请联系管理员获取,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 消息体参数说明

参数名

数据类型

是否必选

说明

ccId

int

True

呼叫中心编号。

取值范围:1~65535

vdn

int

True

虚拟呼叫中心编号。

取值范围:1~5000

skillIds

array

True

技能队列ID信息的对象数组。

数组长度不大于1000。

取值范围:1~2000

indexIds

array

True

指标的数组。数组最大长度为技能实时监控指标的个数,当前为12。

该对象的参数说明请参见表2

响应消息

表3 消息体参数说明

参数名

数据类型

说明

result

String

查询结果。取值如下:

  • 0:成功
  • 其他:失败

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

说明:

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

resultCode

string

查询结果。取值如下:

  • "0100000":成功
  • 其他:失败

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

resultDatas

array

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

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

说明:

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

resultDesc

array

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

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

表4 resultDesc/resultDatas对象参数说明

参数名

数据类型

说明

id

int

技能队列编号。

idxs

array

指标结果集。

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

表5 idxs对象参数说明

参数名

数据类型

说明

id

string

指标ID。

val

object

指标结果。

该对象的参数说明请参见表2

样例报文

  • 请求头:
    Content-Type: application/json;charset=UTF-8
    Authorization: ******************
  • 请求参数:
    {
        "ccId":1,
        "vdn":170,
        "skillIds":[1,2],
        "indexIds":["IDX_COUNT_REAL_SKILL_QUEUE","IDX_COUNT_REAL_SKILL_HANDLE","IDX_DURATION_SKILL_MAX_QUEUE_ACK",
        "IDX_COUNT_20S_CALL_FOR_5MIN","IDX_COUNT_REAL_AGENT_SIGN_IN","IDX_COUNT_REAL_AGENT_CONNECT",
        "IDX_COUNT_REAL_AGENT_SET_IDLE","IDX_COUNT_REAL_AGENT_USABLE","IDX_COUNT_REAL_AGENT_SET_BUSY",
        "IDX_COUNT_REAL_AGENT_ACW","IDX_COUNT_REAL_AGENT_REST","IDX_COUNT_REAL_AGENT_STUDY"]
    
    }
  • 响应参数:
    {
        "result": "0",
        "resultCode": "0100000",
        "resultDatas": [
            {
                "id": "1",
                "idxs": [
                    {
                        "id": "IDX_COUNT_REAL_SKILL_QUEUE",
                        "val": "0"
                    },
                    {
                        "id": "IDX_COUNT_REAL_SKILL_HANDLE",
                        "val": "0"
                    },
                    {
                        "id": "IDX_DURATION_SKILL_MAX_QUEUE_ACK",
                        "val": "0"
                    },
                    {
                        "id": "IDX_COUNT_20S_CALL_FOR_5MIN",
                        "val": "0"
                    },
                    {
                        "id": "IDX_COUNT_REAL_AGENT_SIGN_IN",
                        "val": "0"
                    },
                    {
                        "id": "IDX_COUNT_REAL_AGENT_CONNECT",
                        "val": "0"
                    },
                    {
                        "id": "IDX_COUNT_REAL_AGENT_SET_IDLE",
                        "val": "0"
                    },
                    {
                        "id": "IDX_COUNT_REAL_AGENT_USABLE",
                        "val": "0"
                    },
                    {
                        "id": "IDX_COUNT_REAL_AGENT_SET_BUSY",
                        "val": "0"
                    },
                    {
                        "id": "IDX_COUNT_REAL_AGENT_ACW",
                        "val": "0"
                    },
                    {
                        "id": "IDX_COUNT_REAL_AGENT_REST",
                        "val": "0"
                    },
                    {
                        "id": "IDX_COUNT_REAL_AGENT_STUDY",
                        "val": "0"
                    }
                ]
            },
            {
                "id": "2",
                "idxs": [
                    {
                        "id": "IDX_COUNT_REAL_SKILL_QUEUE",
                        "val": "0"
                    },
                    {
                        "id": "IDX_COUNT_REAL_SKILL_HANDLE",
                        "val": "0"
                    },
                    {
                        "id": "IDX_DURATION_SKILL_MAX_QUEUE_ACK",
                        "val": "0"
                    },
                    {
                        "id": "IDX_COUNT_20S_CALL_FOR_5MIN",
                        "val": "0"
                    },
                    {
                        "id": "IDX_COUNT_REAL_AGENT_SIGN_IN",
                        "val": "1"
                    },
                    {
                        "id": "IDX_COUNT_REAL_AGENT_CONNECT",
                        "val": "0"
                    },
                    {
                        "id": "IDX_COUNT_REAL_AGENT_SET_IDLE",
                        "val": "0"
                    },
                    {
                        "id": "IDX_COUNT_REAL_AGENT_USABLE",
                        "val": "0"
                    },
                    {
                        "id": "IDX_COUNT_REAL_AGENT_SET_BUSY",
                        "val": "1"
                    },
                    {
                        "id": "IDX_COUNT_REAL_AGENT_ACW",
                        "val": "0"
                    },
                    {
                        "id": "IDX_COUNT_REAL_AGENT_REST",
                        "val": "0"
                    },
                    {
                        "id": "IDX_COUNT_REAL_AGENT_STUDY",
                        "val": "0"
                    }
                ]
            }
        ],
        "resultDesc": [
            {
                "id": "1",
                "idxs": [
                    {
                        "id": "IDX_COUNT_REAL_SKILL_QUEUE",
                        "val": "0"
                    },
                    {
                        "id": "IDX_COUNT_REAL_SKILL_HANDLE",
                        "val": "0"
                    },
                    {
                        "id": "IDX_DURATION_SKILL_MAX_QUEUE_ACK",
                        "val": "0"
                    },
                    {
                        "id": "IDX_COUNT_20S_CALL_FOR_5MIN",
                        "val": "0"
                    },
                    {
                        "id": "IDX_COUNT_REAL_AGENT_SIGN_IN",
                        "val": "0"
                    },
                    {
                        "id": "IDX_COUNT_REAL_AGENT_CONNECT",
                        "val": "0"
                    },
                    {
                        "id": "IDX_COUNT_REAL_AGENT_SET_IDLE",
                        "val": "0"
                    },
                    {
                        "id": "IDX_COUNT_REAL_AGENT_USABLE",
                        "val": "0"
                    },
                    {
                        "id": "IDX_COUNT_REAL_AGENT_SET_BUSY",
                        "val": "0"
                    },
                    {
                        "id": "IDX_COUNT_REAL_AGENT_ACW",
                        "val": "0"
                    },
                    {
                        "id": "IDX_COUNT_REAL_AGENT_REST",
                        "val": "0"
                    },
                    {
                        "id": "IDX_COUNT_REAL_AGENT_STUDY",
                        "val": "0"
                    }
                ]
            },
            {
                "id": "2",
                "idxs": [
                    {
                        "id": "IDX_COUNT_REAL_SKILL_QUEUE",
                        "val": "0"
                    },
                    {
                        "id": "IDX_COUNT_REAL_SKILL_HANDLE",
                        "val": "0"
                    },
                    {
                        "id": "IDX_DURATION_SKILL_MAX_QUEUE_ACK",
                        "val": "0"
                    },
                    {
                        "id": "IDX_COUNT_20S_CALL_FOR_5MIN",
                        "val": "0"
                    },
                    {
                        "id": "IDX_COUNT_REAL_AGENT_SIGN_IN",
                        "val": "1"
                    },
                    {
                        "id": "IDX_COUNT_REAL_AGENT_CONNECT",
                        "val": "0"
                    },
                    {
                        "id": "IDX_COUNT_REAL_AGENT_SET_IDLE",
                        "val": "0"
                    },
                    {
                        "id": "IDX_COUNT_REAL_AGENT_USABLE",
                        "val": "0"
                    },
                    {
                        "id": "IDX_COUNT_REAL_AGENT_SET_BUSY",
                        "val": "1"
                    },
                    {
                        "id": "IDX_COUNT_REAL_AGENT_ACW",
                        "val": "0"
                    },
                    {
                        "id": "IDX_COUNT_REAL_AGENT_REST",
                        "val": "0"
                    },
                    {
                        "id": "IDX_COUNT_REAL_AGENT_STUDY",
                        "val": "0"
                    }
                ]
            }
        ]
    }