Черги

Керуйте списком черг, дзвінками, що очікують у черзі, та членством у чергах. 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, а в панелі > Черги > картка «Представник зі штучним інтелектом»; асистент не є учасником черги, веде розмови паралельно. Див. Голосовий асистент.