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
| Parameter | Beschreibung |
|---|---|
queue_number | Warteschlangennummer |
user_list | Durch 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.
