ListUserLevelsOfSkillGroup - 获取技能组的坐席等级列表

更新时间:
复制为 MD 格式

调用ListUserLevelsOfSkillGroup获取指定实例下指定技能组下属的坐席技能等级列表,也可以调用该接口反差可关联但未关联指定技能组的坐席列表。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称

类型

必填

描述

示例值

InstanceId

string

实例 ID。

ccc-test

SkillGroupId

string

技能组 ID。

skillgroup@ccc-test

IsMember

boolean

是否与传入的技能组关联,如果值为 true,表示获取 SkillgroupId 关联的坐席的技能等级列表,如果值为 false,表示获取可关联但未关联 SkillgroupId 的坐席列表。默认值为 true。

true

PageNumber

integer

分页序号,范围 1-100。

1

PageSize

integer

分页大小,范围 1-100。

10

SearchPattern

string

根据坐席登录名或坐席展示名进行模糊匹配,非必填,默认为空,为空表示不过滤。

测试坐席

返回参数

名称

类型

描述

示例值

object

Code

string

响应码。

OK

HttpStatusCode

integer

HTTP 状态码。

200

Message

string

响应信息。

RequestId

string

请求 ID。

EEEE671A-3E24-4A04-81E6-6C4F5B39DF75

Data

object

数据。

PageNumber

integer

分页序号,范围 1-100。

1

PageSize

integer

分页大小,范围 1-100。

10

TotalCount

integer

总数。

1

List

array<object>

技能等级列表。

object

技能等级信息。

DisplayName

string

坐席展示名。

坐席小王

SkillLevel

integer

坐席技能等级。

5

LoginName

string

坐席登录名。

agent

UserId

string

坐席 ID。

agent@ccc-test

SkillGroupId

string

技能组 ID。

skillgroup@ccc-test

SkillGroupName

string

技能组名称。

skillgroup

RoleName

string

角色名称。

枚举值:

  • Agent :

    坐席

  • Admin :

    管理员

  • Manager :

    技能组组长

Admin

RoleId

string

角色 ID,格式为:角色@实例 ID。

Admin@ccc-test

RamId

string

用户的 RAM 账号。

28036411123456****

示例

正常返回示例

JSON格式

{
  "Code": "OK",
  "HttpStatusCode": 200,
  "Message": "无",
  "RequestId": "EEEE671A-3E24-4A04-81E6-6C4F5B39DF75",
  "Data": {
    "PageNumber": 1,
    "PageSize": 10,
    "TotalCount": 1,
    "List": [
      {
        "DisplayName": "坐席小王",
        "SkillLevel": 5,
        "LoginName": "agent",
        "UserId": "agent@ccc-test",
        "SkillGroupId": "skillgroup@ccc-test",
        "SkillGroupName": "skillgroup",
        "RoleName": "Admin",
        "RoleId": "Admin@ccc-test",
        "RamId": "28036411123456****"
      }
    ]
  }
}

错误码

HTTP status code

错误码

错误信息

描述

400 Parameter.Maximum The parameter %s must be less than or equal to %s. 参数必须小于或等于系统规定的最大值。
400 Parameter.Minimum The parameter %s must be greater than or equal to %s. 参数必须大于或等于系统规定的最小值。
400 Parameter.Empty The parameter %s may not be null or empty. 该参数不能为null值或为空字符串。
400 Parameter.Null The parameter %s may not be null. 该参数不能为null值.
400 Parameter.Blank The parameter %s may not be null or blank. 该参数不能为null或含有空白符的字符串。
404 NotExists.InstanceId The specified instance %s does not exist. 指定的呼叫中心实例不存在。
404 NotExists.SkillGroupId The skill group ID %s does not exist in instance %s. 云联络中心实例中不存在指定的技能组ID。

访问错误中心查看更多错误码。

变更历史

更多信息,参考变更详情