Elenco degli operatori Filtri Note

Stati degli operatori

Elenca lo stato istantaneo degli operatori (interni) e le code di cui sono membri. Si usa per il tabellone a muro, l'indicatore "chi è disponibile" nel CRM o il report dei turni. Chiave API (ambito call; Authorization: Bearer bt_… nell'intestazione, vedi Sicurezza API), GET.

Limite di frequenza: 2 richieste al minuto. Non inserisca questo endpoint in un ciclo per aggiornamenti al secondo; la schermata di monitoraggio in diretta o i dati del ponte CRM sono più adatti.

GETElenco degli operatori

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

[
  { "agent": "1010", "status": "AVAILABLE", "queues": ["204", "205"] },
  { "agent": "1011", "status": "TALKING",   "queues": ["202"] },
  { "agent": "1026", "status": "ON_BREAK",  "queues": ["204"], "break_description": "Kahve" },
  { "agent": "1030", "status": "LOGGED_OUT", "queues": [] }
]

Campo	Descrizione
`agent`	Numero dell'interno
`status`	`AVAILABLE` disponibile · `TALKING` in conversazione · `ON_BREAK` in pausa · `LOGGED_OUT` non registrato / offline
`queues`	Numeri delle code di cui è membro
`break_description`	Nome della pausa, se in pausa

Filtri

Parametro	Descrizione
`agent`	Interno singolo (`1010`)
`status`	Filtro per stato (`AVAILABLE`, `TALKING`, `ON_BREAK`, `LOGGED_OUT`)
`queue`	Membri di una coda specifica (numero o nome della coda)

GET https://api.buluthat.com/api/agent_statuses.php?queue=204&status=AVAILABLE

Note

Gli interni con app mobile, a schermo spento, possono risultare non registrati sul centralino; vengono risvegliati con push alla chiamata in entrata. In questo endpoint LOGGED_OUT il fatto che compaia non significa "non raggiungibile"; la distribuzione della coda considera disponibile il membro risvegliabile.
Se l'interno ha attivato "Non disturbare" (DND) ON_BREAK invece di LOGGED_OUT compare.

← Code Lista nera