获取座席实时监控指标

场景描述

获取座席实时监控指标。

接口方法

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

内部封装接口

BMS接口：/ccbms/ws/monitor/agentstatusinfobyagentids

请求URL

https://ip:port/rest/cmsapp/v1/openapi/agentgroup/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
agentIds	array	True	座席工号的数组，最大数组长度为100。取值范围：101-59999
indexIds	array	True	指标的数组。数组最大长度为座席实时监控指标的个数，当前不大于4。该对象的参数说明请参见表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,
    "agentIds":[1032,1099],
    "indexIds":["IDX_AGENT_PHONE","IDX_AGENT_CURRENT_STATE","IDX_DURATION_AGENT_CURRENT_STATE","IDX_AGENT_LOGIN_SKILLS"]
}

响应参数：

{
    "result": "0",
    "resultCode": "0100000",
    "resultDatas": [
        {
            "idxs": [
                {
                    "val": "88880103",
                    "id": "IDX_AGENT_PHONE"
                },
                {
                    "val": 7,
                    "id": "IDX_AGENT_CURRENT_STATE"
                },
                {
                    "val": 17728,
                    "id": "IDX_DURATION_AGENT_CURRENT_STATE"
                },
                {
                    "val": [
                        3
                    ],
                    "id": "IDX_AGENT_LOGIN_SKILLS"
                }
            ],
            "id": 1032
        },
        {
            "idxs": [
                {
                    "val": "88881609",
                    "id": "IDX_AGENT_PHONE"
                },
                {
                    "val": 1,
                    "id": "IDX_AGENT_CURRENT_STATE"
                },
                {
                    "val": 1414,
                    "id": "IDX_DURATION_AGENT_CURRENT_STATE"
                },
                {
                    "val": [
                        2,
                        4
                    ],
                    "id": "IDX_AGENT_LOGIN_SKILLS"
                }
            ],
            "id": 1099
        }
    ],
    "resultDesc": [
        {
            "idxs": [
                {
                    "val": "88880103",
                    "id": "IDX_AGENT_PHONE"
                },
                {
                    "val": 7,
                    "id": "IDX_AGENT_CURRENT_STATE"
                },
                {
                    "val": 17728,
                    "id": "IDX_DURATION_AGENT_CURRENT_STATE"
                },
                {
                    "val": [
                        3
                    ],
                    "id": "IDX_AGENT_LOGIN_SKILLS"
                }
            ],
            "id": 1032
        },
        {
            "idxs": [
                {
                    "val": "88881609",
                    "id": "IDX_AGENT_PHONE"
                },
                {
                    "val": 1,
                    "id": "IDX_AGENT_CURRENT_STATE"
                },
                {
                    "val": 1414,
                    "id": "IDX_DURATION_AGENT_CURRENT_STATE"
                },
                {
                    "val": [
                        2,
                        4
                    ],
                    "id": "IDX_AGENT_LOGIN_SKILLS"
                }
            ],
            "id": 1099
        }
    ]
}

父主题： 座席维度实时接口

上一篇：查询座席维度系统状态信息

下一篇：获取座席操作详情