Статуси операторів
Повертає список поточного стану клієнтських операторів (внутрішніх номерів) і черг, до яких вони належать. Використовується для настінної панелі, індикатора «хто вільний» у 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
Нотатки
- Внутрішні номери з мобільним додатком при вимкненому екрані можуть виглядати на АТС незареєстрованими; при вхідному дзвінку їх пробуджує push. У цій кінцевій точці
LOGGED_OUT відображення не означає «недоступний»; розподіл черги вважає вільним того учасника, якого можна пробудити. - Якщо внутрішній номер увімкнув «Не турбувати» (DND)
ON_BREAK замість LOGGED_OUT відображається.
