获取座席维度的历史监控指标

场景描述

获取座席维度的历史监控指标。

接口方法

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

请求URL

https://ip:port/rest/cmsapp/v1/openapi/hisindex/agent

其中，公有云环境请联系管理员获取，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	False	呼叫中心编号，取值范围：1～65535。集成环境，默认值为系统管理员登录AICC系统后，通过“配置中心 > 系统管理 > CMS系统配置”查看的呼叫中心编号。若该配置为空，取值数据库t_cms_sysparam表中的sys_key="default_cc_id",sys_type="cms_system_config"对应的数据。独立部署环境，默认值为系统管理员登录AICC系统后，通过“配置中心 > 系统管理 > 参数配置”查看“默认呼叫中心标识”的值。
vdn	int	True	虚拟呼叫中心编号，取值范围：1～5000。
agentIds	List<Integer>	True	座席工号的数组，数组长度最大100。座席工号为int型，取值范围为0~99999。
timeGrain	String	False	该入参可按分钟粒度进行历史监控指标统计，可选值为（"15MIN"，"30MIN"，"60MIN"），如果不传则统计当天（VDN所在时区）数据。注：部分座席操作类历史监控指标不支持分钟粒度查询，具体指标参见表1
indexIds	List<String>	True	指标的数组。指标为String型。数组最大长度为座席历史监控指标的个数。具体指标参见表1
mediaType	int	False	呼叫媒体类型，具体请参见表1。
subMediaType	int	False	子媒体类型，具体请参见表3。
enableOffset	String	False	可选值为（"Y"，"N"），传"Y"则查询前一天的数据，传"N"则查询当天的数据，不传默认为"N"。

响应消息

表3 响应消息体参数说明
参数名	数据类型	说明
result	String	查询结果。取值如下： 0：成功其他：失败失败的原因说明请参见错误码参考。说明：当前字段为兼容8.13及其之前版本接口响应参数使用。
resultCode	String	查询结果。取值如下： "0100000"：成功其他：失败失败的原因说明请参见错误码参考。
resultDatas	array	查询成功后，返回结果信息的对象数组。该数组中对象的参数说明请参见表4。说明：当前字段为兼容8.13及其之前版本接口响应参数使用。
resultDesc	array	查询成功后，返回结果信息的对象数组。该数组中对象的参数说明请参见表4。

表4 resultDesc/resultDatas对象参数说明
参数名	数据类型	说明
id	String	座席工号。
idxs	array	指标结果集。该对象的参数说明请参见表5。

表5 idx对象参数说明
参数名	数据类型	说明
id	String	指标ID。
val	Object	指标结果，该时间为零时区时间。

样例报文

请求头：

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

请求参数：

{
    "ccId":1,
    "vdn":22,
    "agentIds":[295],
    "timeGrain":"15MIN",
    "indexIds":["IDX_COUNT_AGENT_COLLATION","IDX_COUNT_AGENT_SET_BUSY","IDX_DURATION_AGENT_CALL_IN"],
    "mediaType":53,
    "subMediaType":3
}

响应参数：

{
    "result": "0",
    "resultCode": "0100000",
    "resultDatas": [
        {
            "idxs": [
                {
                    "val": {
                        "2020-08-24 10:30:00.0": "15",
                        "2020-08-24 10:45:00.0": "19"
                    },
                    "id": "IDX_COUNT_AGENT_COLLATION"
                },
                {
                    "val": {
                        "2020-08-24 10:30:00.0": "15",
                        "2020-08-24 10:45:00.0": "19"
                    },
                    "id": "IDX_DURATION_AGENT_AVG_COLLATION"
                },
                {
                    "val": {
                        "2020-08-24 10:30:00.0": "15",
                        "2020-08-24 10:45:00.0": "19"
                    },
                    "id": "IDX_COUNT_AGENT_SET_BUSY"
                }
            ],
            "id": "11"
        },
        {
            "idxs": [
                {
                    "val": {
                        "2020-08-24 10:30:00.0": "15",
                        "2020-08-24 10:45:00.0": "19"
                    },
                    "id": "IDX_COUNT_AGENT_COLLATION"
                },
                {
                    "val": {
                        "2020-08-24 10:30:00.0": "15",
                        "2020-08-24 10:45:00.0": "19"
                    },
                    "id": "IDX_DURATION_AGENT_AVG_COLLATION"
                },
                {
                    "val": {
                        "2020-08-24 10:30:00.0": "15",
                        "2020-08-24 10:45:00.0": "19"
                    },
                    "id": "IDX_COUNT_AGENT_SET_BUSY"
                }
            ],
            "id": "12"
        }
    ],
    "resultDesc": [
        {
            "idxs": [
                {
                    "val": {
                        "2020-08-24 10:30:00.0": "15",
                        "2020-08-24 10:45:00.0": "19"
                    },
                    "id": "IDX_COUNT_AGENT_COLLATION"
                },
                {
                    "val": {
                        "2020-08-24 10:30:00.0": "15",
                        "2020-08-24 10:45:00.0": "19"
                    },
                    "id": "IDX_DURATION_AGENT_AVG_COLLATION"
                },
                {
                    "val": {
                        "2020-08-24 10:30:00.0": "15",
                        "2020-08-24 10:45:00.0": "19"
                    },
                    "id": "IDX_COUNT_AGENT_SET_BUSY"
                }
            ],
            "id": "11"
        },
        {
            "idxs": [
                {
                    "val": {
                        "2020-08-24 10:30:00.0": "15",
                        "2020-08-24 10:45:00.0": "19"
                    },
                    "id": "IDX_COUNT_AGENT_COLLATION"
                },
                {
                    "val": {
                        "2020-08-24 10:30:00.0": "15",
                        "2020-08-24 10:45:00.0": "19"
                    },
                    "id": "IDX_DURATION_AGENT_AVG_COLLATION"
                },
                {
                    "val": {
                        "2020-08-24 10:30:00.0": "15",
                        "2020-08-24 10:45:00.0": "19"
                    },
                    "id": "IDX_COUNT_AGENT_SET_BUSY"
                }
            ],
            "id": "12"
        }
    ]
}

父主题： 历史数据查询类接口

上一篇：获取技能维度的历史监控指标

下一篇：获取指定日期内的技能维度的历史监控指标