Colas

Gestione la lista de colas, las llamadas en espera en cola y la pertenencia a colas. Clave de API (alcance call; Authorization: Bearer bt_… en el encabezado, véase Seguridad de la API), GET. Límite de velocidad: 120 solicitudes por minuto por clave.

GETLista de colas

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

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

number es el número de la cola en la central (en el panel "número de cola"); en los demás endpoints queue_number se usa como.

GETEn espera en la cola

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 Es una marca de tiempo Unix. Para conectar una llamada en espera directamente con un agente call_uuid con Transferir llamada se puede utilizar.

GETExtensiones en la cola

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

GETAgregar / quitar / ordenar extensiones en la cola

La lista de miembros de la cola completamente lo reemplaza por la lista que usted entregue; el orden es el orden de reproducción.

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

Respuesta 200 OK / OK. Errores: Queue_number value null or none, User value null or none 1001 (sin extensión).

El cambio se aplica al instante; las llamadas en curso no se ven afectadas. Para los descansos de agentes, use "Gestión de descansos" del panel o el endpoint de estado del agente.

Agente de inteligencia artificial

El asistente de voz vinculado a la cola (modo desborde / asistente primero) no se configura por API sino desde Panel > Colas > tarjeta "Agente de Inteligencia Artificial"; el asistente no es miembro de la cola y atiende en paralelo. Véase Asistente de Voz.