通过技能队列ID查询座席信息(queryAgentInfoBySkillId)
场景描述
根据技能队列ID查询该队列下的座席信息。
接口方法
POST
接口URI
https://域名/apiaccess/rest/cc-management/v1/agentAccount/queryAgentInfoBySkillId,例如域名是service.besclouds.com
请求说明
序号 |
名称 |
参数类型 |
是否必选 |
说明 |
---|---|---|---|---|
1 |
x-app-key |
string |
False |
appKey字段,用户标识,请联系运营人员获取appKey |
2 |
Authorization |
string |
True |
鉴权字段,内容格式为: Bearer +tokenByAKSK接口的返回值中AccessToken(Bearer后有空格) |
序号 |
名称 |
参数类型 |
是否必选 |
说明 |
---|---|---|---|---|
1 |
requestParam |
object |
True |
请求参数 |
1.1 |
skillId |
integer |
True |
技能队列ID |
1.2 |
pageSize |
integer |
True |
分页大小,最大值为100 |
1.3 |
pageNum |
integer |
True |
分页页号,从0开始 |
响应说明
- 响应状态码: 200
表3 响应体参数 序号
名称
参数类型
是否必选
说明
1
schema
object
True
请求成功
1.1
data
array[object]
False
返回数据
1.1.1
workNo
number
False
座席工号
1.1.2
agentType
number
False
座席类型:
4:音频座席;
11:视频座席
5:多媒体座席;
99:全能座席
1.1.3
agentWeight
number
False
座席权重,权重越高,越优先分配该座席,最低1
1.1.4
accountName
string
False
用户名称
1.1.5
sipAccount
string
False
软电话号码
1.1.6
skillWeight
number
False
技能队列权重,最低1
1.1.7
userAccount
string
False
座席账号,同创建座席的座席账号
1.2
count
integer
False
查询座席信息的数量
1.3
resultCode
string
False
请求成功返回0 ,请求失败返回1,会携带resultMessage,具体错误原因
- 响应状态码: 400
错误的请求:请检查请求路径及参数。
- 响应状态码: 401
未授权:1. 请确认是否购买了相关服务。 2. 请联系客服人员检查您账号的当前状态。
- 响应状态码: 404
请求的内容未找到:请检查请求的路径。
- 响应状态码: 500
业务失败:请依次确认您请求中各参数的取值。
错误码
无。
报文样例
场景描述:根据技能队列ID查询座席信息
请求参数:
{ "skillId":3, "pageSize":10, "pageNum":0 }
响应参数:
{"data": [ { "workNo": 107, "accountCode": "xxxxx", "agentType": 4, "agentWeight": 1, "accountName": "xxxxx", "sipAccount": "88880006", "skillWeight": 1 } ], "count": 1, "resultCode": "0" }