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
ParameterOmschrijving
queue_numberWachtrijnummer
user_listToestelnummers 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.