坐席列表筛选备注

坐席状态

列出客户坐席（分机）的实时状态及其所属队列。用于电子看板、CRM 中的“谁有空”指示或排班报表。API 密钥（权限范围 call; Authorization: Bearer bt_… 在请求头中，参见 API 安全), GET.

速率限制：每分钟 2 次请求。请勿循环调用此接口以实现秒级刷新；实时监控界面或 CRM 对接数据更为合适。

GET坐席列表

GET https://api.buluthat.com/api/agent_statuses.php

[
  { "agent": "1010", "status": "AVAILABLE", "queues": ["204", "205"] },
  { "agent": "1011", "status": "TALKING",   "queues": ["202"] },
  { "agent": "1026", "status": "ON_BREAK",  "queues": ["204"], "break_description": "Kahve" },
  { "agent": "1030", "status": "LOGGED_OUT", "queues": [] }
]

区域	说明
`agent`	分机号码
`status`	`AVAILABLE` 可用 · `TALKING` 通话中 · `ON_BREAK` 休息中 · `LOGGED_OUT` 未注册 / 离线
`queues`	所属的队列号码
`break_description`	若在休息中，则为休息名称

筛选

参数	说明
`agent`	单个分机（`1010`)
`status`	状态筛选（`AVAILABLE`, `TALKING`, `ON_BREAK`, `LOGGED_OUT`)
`queue`	指定队列的成员（队列号码或名称）

GET https://api.buluthat.com/api/agent_statuses.php?queue=204&status=AVAILABLE

备注

使用移动应用的分机在锁屏时可能在总机上显示为未注册；来电时会通过推送唤醒。在此接口中 LOGGED_OUT 显示不代表“无法接通”；队列分配会将可唤醒的成员视为空闲。
若分机开启了“请勿打扰”(DND) ON_BREAK 代替 LOGGED_OUT 可见。

← 队列黑名单