坐席状态控制 API

坐席控制模块允许您实时管理坐席的在线状态和技能组签入情况，这对构建坐席工作台至关重要。

1. 状态切换

系统通过调整坐席的并发能力（Count）来实现状态切换：

• 示闲 (Ready): 并发设为 1，可以接收新进线。
• 小休 (Break): 并发设为 0，系统停止向该坐席分配新详单，但保持在线。

GET /api/agent-control/ready

将坐席设为 示闲 状态。

• 参数： agent_id (必填)

GET /api/agent-control/break

将坐席设为 小休 状态。

• 参数： agent_id (必填)

---

2. 技能组控制

POST /api/agent-control/sign-in-group

将坐席签入指定的技能组。

• 参数：
  • agent_id : 坐席 ID
  • group_ids : 数组，目标技能组的 ID 列表

GET /api/agent-control/logout

将坐席从所有已签入的技能组中签出。

• 参数： agent_id (必填)

---

3. 工作流集成建议

在 Web 端坐席工作台中，建议的操作流程如下：

1. 签入：开启软电话注册成功后，调用 signInGroup 。
2. 就绪：准备好接听来电时，点击开启 “就绪”，调用 ready 。
3. 暂离：需要短暂离开位置时，点击 “小休”，调用 break 。
4. 下班：关闭工作台前，调用 logout 。