Очереди

Управляйте списком очередей, ожидающими в очереди вызовами и участием в очередях. Ключ 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
ПараметрОписание
queue_numberНомер очереди
user_listВнутренние номера через запятую; пустой список очищает очередь

Ответ 200 OK / OK. Ошибки: Queue_number value null or none, User value null or none 1001 (нет внутреннего номера).

Изменение применяется мгновенно; идущие вызовы не затрагиваются. Для перерывов операторов используйте «Управление перерывами» в панели или метод статуса оператора.

ИИ-агент

Голосовой ассистент, привязанный к очереди (режим переполнения / «сначала ассистент»), настраивается не через API, а в панели: Очереди > карточка «ИИ-агент»; ассистент не является участником очереди, он ведёт разговоры параллельно. См. Голосовой ассистент.