调用ListUserLevelsOfSkillGroup获取指定实例下指定技能组下属的坐席技能等级列表,也可以调用该接口反差可关联但未关联指定技能组的坐席列表。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| 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 |
角色名称。 枚举值:
|
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。 |
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。