更新时间:2025-12-01 GMT+08:00
分享

查询技能组

场景描述

调用该接口查询VDN技能组。

接口方法

该接口仅支持POST方法,不支持GET、PUT、DELETE等方法。

接口URI

https://ip:port/agentgateway/resource/config/vdn/skillgroups/query

其中,ip为CC-Gateway服务器地址,port为CC-Gateway服务器的HTTPS端口号。

日志中的方法名

querySkillGroup

请求消息

  • 消息头
    表1 消息头参数说明

    序号

    名称

    参数类型

    是否必选

    说明

    1

    Content-Type

    string

    True

    消息主体编码方式,缺省值:application/json; charset=UTF-8

    2

    Guid

    string

    True

    Guid的取值为C5 智能辅助类接口鉴权方式接口返回的guid。

  • 消息体
    表2 消息体参数说明

    序号

    名称

    参数类型

    是否必选

    说明

    1

    ids

    array

    True

    需要查询的技能组编号。

    数组为空时,表示查询所有技能组的数据。

    取值类型为整数,根据实际的技能组编号填写。

响应消息

表3 消息体参数说明

序号

名称

参数类型

说明

1

message

string

描述。

2

retcode

number

操作的结果原因码。

取值类型为整数。

3

result

array

查询技能组的对象数组。单个result数组元素定义如表4所示。

表4 技能组对象参数说明

序号

名称

参数类型

说明

3.1

id

number

技能组id。

3.2

skills

array

技能对象数组,数组中为技能对象。单个技能对象的定义如表5 所示

3.3

groupName

string

技能组名称。

最大长度为64字节,不含特殊字符。

表5 技能队列对象参数说明

序号

名称

参数类型

说明

3.2.1

skillId

number

技能队列编号。

取值类型为整数,根据实际的技能队列编号填写。

3.2.2

skillPower

number

技能队列对应的技能权值。

取值类型为整数,取值范围为1~100。

3.2.3

agentPower

number

技能队列对应的座席权值。

取值类型为整数,取值范围为1~300。

报文样例

  • 消息头
    Content-Type:application/json; charset=UTF-8
    Guid:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.AgentGateway1
  • 请求参数
    {
        "ids": [
            1,
            2
        ]
    }
  • 响应参数
    {
        "result": [
            {
                "id": 1,
                "skills": [
                    {
                        "skillId": 1,
                        "skillPower": 1,
                        "agentPower": 1
                    }
                ],
                "groupName": "skillgroup1"
            },
            {
                "id": 2,
                "skills": [
                    {
                        "skillId": 2,
                        "skillPower": 1,
                        "agentPower": 1
                    }
                ],
                "groupName": "skillgroup2"
            }
        ],
        "message": "success",
        "retcode": "0"
    }

相关文档