坐席

坐席 – 获取所有坐席

GET

/api/agents

权限：坐席

Header

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

成功 200

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

成功返回值

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