队列

管理队列列表、队列中等待的来电以及队列成员关系。API 密钥（权限范围 call; Authorization: Bearer bt_… 在请求头中，参见 API 安全), GET。速率限制：每个密钥每分钟 120 次请求。

GET队列列表

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

[
  { "number": 200, "name": "Satış" },
  { "number": 201, "name": "Teknik Destek" }
]

number 是队列在总机上的号码（面板中的“队列号码”）；其他接口中 queue_number 用作。

GET队列中等待的来电

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

[
  {
    "queue_number": "200",
    "uuid": "a7713781-…",
    "call_uuid": "f776683e-1bde-4b58-bc43-128b99497bd9",
    "caller_id": "905320000000",
    "joined_at": "1758182219"
  }
]

joined_at Unix 时间戳。若要将排队中的来电直接接给某位坐席 call_uuid 与 转接通话 可用。

GET队列中的分机

GET https://api.buluthat.com/api/queue_user_list.php?queue_number=200

[{ "user": 1000, "name": "Ayşe Kara" }, { "user": 1001, "name": "Mert Aydın" }]

GET在队列中添加/移除/排序分机

队列的成员列表 完全 替换为您提供的列表；顺序即播放顺序。

GET https://api.buluthat.com/api/queue_manage_users.php?queue_number=200&user_list=1000,1001,1002

响应 200 OK / OK。错误： Queue_number value null or none, User value null or none 1001 （无分机）。

变更立即生效；进行中的通话不受影响。坐席休息请使用面板的“休息管理”或坐席状态接口。

AI 坐席

与队列绑定的语音助手（溢出/助手优先模式）不是通过 API，而是在面板 > 队列 >“AI 坐席”卡片中设置；助手不是队列成员，而是并行接听。参见 语音助手.