分类

坐席

坐席 – 获取所有坐席

GET

/api/agents

权限:坐席

Header

字段类型描述
Content-Type字符串应用或JSON

成功 200

字段类型描述
id字符串坐席编号
name字符串坐席名
status对象坐席状态信息,包括’状态’及’是否已登入’
logged_inBoolean坐席是否已登入

成功返回值

HTTP/1.1 200 OK
[{
“id”: “charlene”,
“name”: “Charlene”,
“status”: {
“status”: “idle”,
“logged_in”: true
}
}, {
“id”: “tommy”,
“name”: “Tommy”,
“status”: {
“status”: “idle”,
“logged_in”: false
}
}]

坐席 – 获取坐席信息

GET

/api/agent/:id

权限:坐席

Header

字段类型描述
Content-Type字符串应用或JSON

参数

字段类型描述
id字符串坐席编号(必选项)

成功 200

字段类型描述
name字符串坐席名
data对象坐席数据,包括“技能等级”和“分机号”
skills对象数组坐席技能,包括“名称”和“等级”
level数字技能等级
extension字符串坐席的分机号

成功响应

HTTP/1.1 200 OK
{
“name”: “Tommy”,
“data”: {
“skills”: [{
“name”: “support”,
“level”: 5
}, {
“name”: “frontdesk”,
“level”: 6
}],
“extension”: “208”
}
}

坐席 – 更新或创建坐席

PUT

/api/agent/:id

权限:坐席

Header

字段类型描述
Content-Type字符串应用/JSON

参数

字段类型描述
id字符串坐席编号
password字符串坐席密码
name字符串坐席名
data对象坐席数据,包括“技能”和“分机号”
skills对象数组坐席技能,包括“名称”和“等级”
level数字技能等级
extension字符串坐席分机号

请求样例

{
“name”: “Test User”,
“password”: “testpassword”,
“data”: {
“skills”: [
{
“name”: “support”,
“level”: 2
},
{
“name”: “frontdesk”,
“level”: 2
}
],
“extension”: “210”
}
}

成功响应

HTTP/1.1 200 OK Agent testuser has been added.

坐席 – 删除坐席

DELETE

/api/agent/:id

权限:坐席

Header

字段类型描述
Content-Type字符串应用或JSON

参数

字段类型描述
id字符串坐席编号

成功响应

HTTP/1.1 200 OK Agent testuser has been removed.

坐席 – 获取坐席状态

GET

/api/agent/:id/status

权限:agent

Header

字段类型描述
Content-Type字符串应用或JSON

参数

字段类型描述
id字符串坐席编号

成功 200

字段类型描述
status字符串坐席状态
logged_in布尔型坐席是否已登入

坐席 – 设置坐席状态

PUT

/api/agent/:id/status

权限:agent

Header

字段类型描述
Content-Type字符串应用或JSON

参数

字段类型描述
id字符串坐席编号
login布尔型坐席登入状态

请求样例

{ “login”: true }

成功响应

HTTP/1.1 200 OK logged in

上一页 呼叫流
下一页 短信
Table of Contents