Lista de agentes Filtros Notas

Estados de agentes

Lista el estado en tiempo real de los agentes (extensiones) y las colas a las que pertenecen. Se usa para el panel mural, el indicador de "quién está disponible" en el CRM o el informe de turnos. Clave de API (alcance call; Authorization: Bearer bt_… en el encabezado, véase Seguridad de la API), GET.

Límite de velocidad: 2 solicitudes por minuto. No ponga este endpoint en bucle para refrescar cada segundo; es más apropiada la pantalla de seguimiento en vivo o los datos del puente CRM.

GETLista de agentes

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	Descripción
`agent`	Número de extensión
`status`	`AVAILABLE` disponible · `TALKING` en conversación · `ON_BREAK` en descanso · `LOGGED_OUT` sin registro / sin conexión
`queues`	Números de las colas a las que pertenece
`break_description`	Si está en descanso, el nombre del descanso

Filtros

Parámetro	Descripción
`agent`	Una sola extensión (`1010`)
`status`	Filtro de estado (`AVAILABLE`, `TALKING`, `ON_BREAK`, `LOGGED_OUT`)
`queue`	Miembros de una cola determinada (número o nombre de la cola)

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

Notas

Las extensiones con aplicación móvil pueden aparecer sin registro en la central con la pantalla apagada; se despiertan con push en las llamadas entrantes. En este endpoint LOGGED_OUT que aparezca no significa "inalcanzable"; la distribución de la cola considera disponible al miembro que se puede despertar.
Si la extensión activó "No molestar" (DND) ON_BREAK en lugar de LOGGED_OUT aparece.

← Colas Lista negra