调用ListUserLevelsOfSkillGroup获取技能组的坐席等级列表_云联络中心(Cloud Contact Center)-阿里云帮助中心

调用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>	技能等级列表。
UserSkillLevel	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。

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

变更历史

变更时间	变更内容概要	操作

暂无变更历史