获取指定实例下指定坐席关联的技能组的技能等级列表,也可以使用该接口查询坐席可关联但未关联的技能组列表。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| InstanceId |
string |
是 |
实例 ID。 |
ccc-test |
| UserId |
string |
否 |
坐席 ID。 |
agent@ccc-test |
| IsMember |
boolean |
否 |
是否与传入的坐席关联,如果值为 true,表示获取传入的坐席关联的技能组的技能等级列表,如果值为 false,表示获取坐席可关联但未关联的技能组列表。默认值为 true。 |
true |
| PageNumber |
integer |
是 |
分页序号,范围 1-100。 |
1 |
| PageSize |
integer |
是 |
分页大小,范围 1-100。 |
10 |
| SearchPattern |
string |
否 |
根据技能组名称或技能组展示名进行模糊匹配,非必填,默认为空,为空表示不过滤。 |
skillgroup |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
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 |
总数。 |
10 |
| List |
array<object> |
技能组等级列表。 |
|
|
object |
|||
| SkillLevel |
string |
技能等级,取值范围 1-10,数值越小,业务能力越强,单位时间内能处理更多的通话。 |
5 |
| SkillGroupId |
string |
技能组 ID。 |
skillgroup@ccc-test |
| SkillGroupName |
string |
技能组名称。 |
skillgroup |
| MediaType |
string |
媒体类型,默认是语音(AUDIO), 其他可选参数包括 CHAT 和 VIDEO。 |
VIDEO |
示例
正常返回示例
JSON格式
{
"Code": "OK",
"HttpStatusCode": 200,
"Message": "无",
"RequestId": "EEEE671A-3E24-4A04-81E6-6C4F5B39DF75",
"Data": {
"PageNumber": 1,
"PageSize": 10,
"TotalCount": 10,
"List": [
{
"SkillLevel": "5",
"SkillGroupId": "skillgroup@ccc-test",
"SkillGroupName": "skillgroup",
"MediaType": "VIDEO"
}
]
}
}
错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 400 | Parameter.Blank | The parameter %s may not be null or blank. | 该参数不能为null或含有空白符的字符串。 |
| 400 | Parameter.Null | The parameter %s may not be null. | 该参数不能为null值. |
| 404 | NotExists.InstanceId | The specified instance %s does not exist. | 指定的呼叫中心实例不存在。 |
| 404 | NotExists.UserId | The user %s does not exist in instance %s. | 云联络中心实例中不存在指定的用户。 |
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。