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