Wachtrijen
Beheer de wachtrijlijst, de wachtende oproepen in de wachtrij en wachtrijlidmaatschappen. API-sleutel (bereik call; Authorization: Bearer bt_… in de header, zie API-beveiliging), GET. Snelheidslimiet: 120 verzoeken per minuut per sleutel.
GETWachtrijlijst
GET https://api.buluthat.com/api/queues.php
[
{ "number": 200, "name": "Satış" },
{ "number": 201, "name": "Teknik Destek" }
]
number is het nummer van de wachtrij op de telefooncentrale (in het paneel "wachtrijnummer"); bij de overige endpoints queue_number wordt gebruikt als.
GETWachtenden in de wachtrij
GET https://api.buluthat.com/api/queues_pending.php
[
{
"queue_number": "200",
"uuid": "a7713781-…",
"call_uuid": "f776683e-1bde-4b58-bc43-128b99497bd9",
"caller_id": "905320000000",
"joined_at": "1758182219"
}
]
joined_at Is een Unix-tijdstempel. Om een wachtende oproep rechtstreeks aan een medewerker te koppelen call_uuid met Oproep doorverbinden kan worden gebruikt.
GETToestellen in de wachtrij
GET https://api.buluthat.com/api/queue_user_list.php?queue_number=200
[{ "user": 1000, "name": "Ayşe Kara" }, { "user": 1001, "name": "Mert Aydın" }]
GETToestel aan wachtrij toevoegen / verwijderen / ordenen
De ledenlijst van de wachtrij volledig vervangt door de lijst die u opgeeft; de volgorde is de afspeelvolgorde.
GET https://api.buluthat.com/api/queue_manage_users.php?queue_number=200&user_list=1000,1001,1002
| Parameter | Omschrijving |
|---|---|
queue_number | Wachtrijnummer |
user_list | Toestelnummers gescheiden door komma's; een lege lijst maakt de wachtrij leeg |
Antwoord 200 OK / OK. Fouten: Queue_number value null or none, User value null or none 1001 (geen toestel).
De wijziging wordt direct toegepast; lopende oproepen worden niet beïnvloed. Gebruik voor pauzes van medewerkers "Pauzebeheer" in het paneel of het statusendpoint van de medewerker.
AI-medewerker
De spraakassistent die aan een wachtrij is gekoppeld (overloop-/eerst-assistent-modus) wordt niet via de API maar in het paneel ingesteld, via Wachtrijen > kaart "AI-medewerker"; de assistent is geen wachtrijlid en voert parallelle gesprekken. Zie Spraakassistent.
