Statusy konsultantów

Wyświetla bieżący status konsultantów (numerów wewnętrznych) i kolejki, do których należą. Używane do tablicy ściennej, wskaźnika „kto jest dostępny” w CRM lub raportu zmiany. Klucz API (zakres call; Authorization: Bearer bt_… w nagłówku, zob. Bezpieczeństwo API), GET.

Limit zapytań: 2 na minutę. Nie wywołuj tego punktu końcowego w pętli dla odświeżania co sekundę; bardziej odpowiednie są ekran śledzenia na żywo lub dane mostu CRM.

GETLista konsultantów

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": [] }
]
PoleOpis
agentNumer wewnętrzny
statusAVAILABLE dostępny · TALKING w rozmowie · ON_BREAK na przerwie · LOGGED_OUT niezarejestrowany / offline
queuesNumery kolejek, do których należy
break_descriptionJeśli na przerwie, nazwa przerwy

Filtry

ParametrOpis
agentPojedynczy numer wewnętrzny (1010)
statusFiltr statusu (AVAILABLE, TALKING, ON_BREAK, LOGGED_OUT)
queueCzłonkowie określonej kolejki (numer lub nazwa kolejki)
GET https://api.buluthat.com/api/agent_statuses.php?queue=204&status=AVAILABLE

Notatki

  • Numery wewnętrzne z aplikacją mobilną mogą być przy wyłączonym ekranie widoczne w centrali jako niezarejestrowane; są budzone przy połączeniu przychodzącym przez push. W tym punkcie końcowym LOGGED_OUT widoczność nie oznacza „nieosiągalny”; dystrybucja kolejki uznaje członka możliwego do obudzenia za dostępnego.
  • Jeśli numer wewnętrzny włączył „Nie przeszkadzać” (DND) ON_BREAK zamiast LOGGED_OUT jest widoczny.