Статусы операторов
Перечисляет текущий статус сотрудников клиента (внутренних номеров) и очереди, в которых они состоят. Используется для настенного табло, индикатора «кто свободен» в 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 отображается.
