Agentenstatus
Listet den Echtzeitstatus der Kundenberater (Nebenstellen) und ihre Warteschlangenmitgliedschaften auf. Wird für Wandanzeigen, die Anzeige „Wer ist verfügbar“ im CRM oder Schichtberichte verwendet. API-Schlüssel (Geltungsbereich call; Authorization: Bearer bt_… im Header, siehe API-Sicherheit), GET.
Ratenbegrenzung: 2 Anfragen pro Minute. Nutzen Sie diesen Endpunkt nicht für sekundengenaues Polling; die Live-Überwachung oder die CRM-Brückendaten sind besser geeignet.
GETMitarbeiterliste
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": [] }
]| Feld | Beschreibung |
|---|---|
agent | Nebenstellennummer |
status | AVAILABLE frei · TALKING im Gespräch · ON_BREAK in Pause · LOGGED_OUT nicht registriert / offline |
queues | Warteschlangennummern, in denen er Mitglied ist |
break_description | Falls in Pause, Name der Pause |
Filter
| Parameter | Beschreibung |
|---|---|
agent | Einzelne Nebenstelle (1010) |
status | Statusfilter (AVAILABLE, TALKING, ON_BREAK, LOGGED_OUT) |
queue | Mitglieder einer bestimmten Warteschlange (Nummer oder Name der Warteschlange) |
GET https://api.buluthat.com/api/agent_statuses.php?queue=204&status=AVAILABLENotizen
- Nebenstellen mit Mobile App können bei ausgeschaltetem Bildschirm in der Telefonanlage als nicht registriert erscheinen; sie werden bei eingehenden Anrufen per Push geweckt. Bei diesem Endpunkt
LOGGED_OUTErscheinen bedeutet nicht „nicht erreichbar“; die Warteschlangenverteilung betrachtet weckbare Mitglieder als verfügbar. - Wenn die Nebenstelle „Bitte nicht stören“ (DND) aktiviert hat
ON_BREAKstattLOGGED_OUTerscheint.