Warteschlangen

Verwalten Sie die Warteschlangenliste, in der Warteschlange wartende Anrufe und Warteschlangenmitgliedschaften. API-Schlüssel (Geltungsbereich call; Authorization: Bearer bt_… im Header, siehe API-Sicherheit), GET. Ratenbegrenzung: 120 Anfragen pro Minute und Schlüssel.

GETWarteschlangenliste

GET https://api.buluthat.com/api/queues.php
[
  { "number": 200, "name": "Satış" },
  { "number": 201, "name": "Teknik Destek" }
]

number ist die Nummer der Warteschlange in der Telefonanlage (im Panel „Warteschlangennummer“); bei den anderen Endpunkten queue_number wird verwendet als.

GETWartende in der Warteschlange

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 Ein Unix-Zeitstempel. Um einen wartenden Anruf direkt mit einem Mitarbeiter zu verbinden call_uuid mit Anruf weiterleiten nutzbar.

GETNebenstellen in der Warteschlange

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

GETNebenstelle zur Warteschlange hinzufügen / entfernen / sortieren

Die Mitgliederliste der Warteschlange vollständig ersetzt sie durch die von Ihnen übergebene Liste; die Reihenfolge ist die Wiedergabereihenfolge.

GET https://api.buluthat.com/api/queue_manage_users.php?queue_number=200&user_list=1000,1001,1002
ParameterBeschreibung
queue_numberWarteschlangennummer
user_listDurch Komma getrennte Nebenstellennummern; eine leere Liste leert die Warteschlange

Antwort 200 OK / OK. Fehler: Queue_number value null or none, User value null or none 1001 (keine Nebenstelle).

Änderungen werden sofort angewendet; laufende Anrufe sind nicht betroffen. Für Pausen der Mitarbeiter nutzen Sie im Panel die „Pausenverwaltung“ oder den Endpunkt für den Agentenstatus.

KI-Mitarbeiter

Der an die Warteschlange gebundene Sprachassistent (Überlauf- / Assistent-zuerst-Modus) wird nicht per API, sondern im Panel > Warteschlangen > Karte „KI-Mitarbeiter“ eingestellt; der Assistent ist kein Warteschlangenmitglied, er führt parallele Gespräche. Siehe Sprachassistent.