分页查询坐席实时状态
服务描述
可用于查询坐席实时状态
开发须知
调用本接口前,请先获取appId
服务地址
GET https://{您的专属域名}/speech/openapi/v1/agent/status/query
请求参数
参数 |
位置 |
类型 |
是否必填 |
说明 |
appId |
header |
String |
Y |
应用ID |
timestamp |
header |
String |
Y |
时间戳,毫秒 |
sign |
header |
String |
Y |
签名 |
Content-Type |
header |
String |
Y |
application/json |
emails |
query |
String |
N |
指定查询账号邮箱,多个用英文逗号“,”隔开 |
pageNum |
query |
int |
N |
查询第几页(从1开始,默认1) |
pageSize |
query |
int |
N |
每页查询多少条(默认10) |
请求示例数据:
GET https://abc.xyz/speech/openapi/v1/v1/agent/status/query?emails=test01@163.com,test02@163.com
sign: fo1OWX+JnfeonAFSGau2gwP1GvFa+RTw5czoBWoz+k3AjV8scDl6JnvFRDj8Lgt1nQxLlmcOhIBN4j7pEE/NAzYjXUFSGo308f5V9dHBnmGLYsqKmgma4cQZLBqHp9T43IZfRX8Zh2/Hp2HOmfTgos/L8GN6YPA8fQ2d5tbtJZrrkBuwA/LEezjOJxSRRRCrcS1ZFVvTZ+cIjYeO4QdC5r5I67LLY/nLbFAFUdQsCzUIytO09vUCLGlKierNhPfCtMzTgZSE9dWO5zJ3L2uCsXM7Od6mPROVpddVafF+BueKjtbL10PwDc9f1eBpGTpgmbOy8Bbx3NIyCjDvhc9Mag==
appId: 99845aaaaebd4d61acccc9b776208f12
timestamp: 1586314097995
返回结果
参数 |
类型 |
说明 |
code |
String |
结果码 |
message |
String |
结果描述 |
data |
AgentStatusQueryVo |
查询结果 |
AgentStatusQueryVo
参数 |
类型 |
说明 |
list |
List\ |
坐席状态列表 |
total |
int |
查询到总条数 |
pageNum |
int |
第几页 |
pageSize |
int |
每页查询记录数 |
AgentStatusDetailVo
参数 |
类型 |
说明 |
staffId |
Long |
坐席账号id |
empno |
String |
坐席工号 |
email |
String |
坐席账号邮箱 |
statusCode |
String |
坐席状态枚举值 |
statusName |
String |
坐席状态中文名称 |
restSubStatusName |
String |
自定义小休子状态名称 |
坐席状态枚举值:
("FREE", "空闲"),
("TALKING", "通话"),
("REST", "小休"),
("ACW", "话后"),
("BUSY", "忙碌"),
("MANUALCALLS_FREE", "外呼空闲"),
("MANUALCALLS_TALKING", "外呼通话")
返回结果示例:
{
"code": "10000",
"message": "请求成功",
"data": {
"list": [
{
"staffId": 17681,
"empno": "1001",
"email": "test01@163.com",
"statusCode": "REST",
"statusName": "小休",
"restSubStatusName":"会议"
},
{
"staffId": 17682,
"empno": "1002",
"email": "test02@163.com",
"statusCode": "OFF_LINE",
"statusName": "离线"
}
],
"total": 2,
"pageNum": 1,
"pageSize": 10
}
}
结果码说明
结果码 |
说明 |
10000 |
请求成功 |
10001 |
鉴权失败 |
10002 |
找不到对应的公钥,请先上传公钥 |
20001 |
请求失败 |
29002 |
参数错误 |
29008 |
系统异常 |