Code

Gestite l'elenco delle code, le chiamate in attesa e l'appartenenza alle code. Chiave API (ambito call; Authorization: Bearer bt_… nell'intestazione, vedi Sicurezza API), GET. Limite di frequenza: 120 richieste al minuto per chiave.

GETElenco delle code

GET https://api.buluthat.com/api/queues.php

[
  { "number": 200, "name": "Satış" },
  { "number": 201, "name": "Teknik Destek" }
]

number è il numero della coda sul centralino (nel pannello "numero della coda"); negli altri endpoint queue_number viene utilizzato come.

GETIn attesa in coda

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 È un timestamp Unix. Per collegare una chiamata in attesa direttamente a un operatore call_uuid con Trasferisci chiamata è utilizzabile.

GETInterni in coda

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

GETAggiungi / rimuovi / ordina interni nella coda

L'elenco dei membri della coda completamente sostituisce con la lista da Voi fornita; l'ordine è l'ordine di squillo.

GET https://api.buluthat.com/api/queue_manage_users.php?queue_number=200&user_list=1000,1001,1002

Risposta 200 OK / OK. Errori: Queue_number value null or none, User value null or none 1001 (nessun interno).

La modifica viene applicata subito; le chiamate in corso non sono interessate. Per le pause degli operatori utilizzi la "Gestione pause" del pannello o l'endpoint di stato dell'operatore.

Agente di intelligenza artificiale

L'assistente vocale collegato alla coda (modalità trabocco / assistente per primo) non si imposta tramite API ma dalla scheda "Agente di intelligenza artificiale" in pannello > Code; l'assistente non è membro della coda, gestisce conversazioni in parallelo. Vedi Assistente vocale.