Medewerkerslijst Filters Notities

Medewerkerstatussen

Toont de actuele status van klantmedewerkers (toestellen) en de wachtrijen waarvan ze lid zijn. Te gebruiken voor een wandbord, een "wie is beschikbaar"-indicator in het CRM of een diensttijdenrapport. API-sleutel (bereik call; Authorization: Bearer bt_… in de header, zie API-beveiliging), GET.

Snelheidslimiet: 2 verzoeken per minuut. Gebruik dit endpoint niet in een lus voor verversing per seconde; het live volgscherm of de gegevens van de CRM-brug zijn daarvoor geschikter.

GETMedewerkerslijst

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": [] }
]

Veld	Omschrijving
`agent`	Toestelnummer
`status`	`AVAILABLE` beschikbaar · `TALKING` in gesprek · `ON_BREAK` in pauze · `LOGGED_OUT` niet geregistreerd / offline
`queues`	Nummers van de wachtrijen waarvan hij lid is
`break_description`	Indien in pauze, de pauzenaam

Filters

Parameter	Omschrijving
`agent`	Eén toestel (`1010`)
`status`	Statusfilter (`AVAILABLE`, `TALKING`, `ON_BREAK`, `LOGGED_OUT`)
`queue`	Leden van een bepaalde wachtrij (wachtrijnummer of naam)

GET https://api.buluthat.com/api/agent_statuses.php?queue=204&status=AVAILABLE

Notities

Toestellen met de mobiele app kunnen bij uitgeschakeld scherm als niet geregistreerd in de telefooncentrale verschijnen; bij een inkomende oproep worden ze via push gewekt. Bij dit endpoint LOGGED_OUT zichtbaar zijn betekent niet "onbereikbaar"; de wachtrijdistributie beschouwt een wekbaar lid als beschikbaar.
Heeft het toestel "Niet storen" (DND) ingeschakeld, ON_BREAK in plaats van LOGGED_OUT zichtbaar.

← Wachtrijen Zwarte lijst