Lista de agentes Filtros Notas

Estados dos Agentes

Lista o estado instantâneo dos agentes (extensões) e as filas a que pertencem. Usa-se para painéis murais, indicador "quem está disponível" no CRM ou relatório de turnos. Chave de API (âmbito call; Authorization: Bearer bt_… no cabeçalho, ver Segurança da API), GET.

Limite de pedidos: 2 por minuto. Não coloque este endpoint num ciclo para atualizar ao segundo; o ecrã de monitorização em direto ou os dados da ponte de CRM são mais adequados.

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	Descrição
`agent`	Número da extensão
`status`	`AVAILABLE` disponível · `TALKING` em conversa · `ON_BREAK` em pausa · `LOGGED_OUT` não registado / offline
`queues`	Números das filas de que é membro
`break_description`	Nome da pausa, se estiver em pausa

Filtros

Parâmetro	Descrição
`agent`	Uma só extensão (`1010`)
`status`	Filtro de estado (`AVAILABLE`, `TALKING`, `ON_BREAK`, `LOGGED_OUT`)
`queue`	Membros de uma fila específica (número ou nome da fila)

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

Notas

As extensões com aplicação móvel podem aparecer não registadas na central quando o ecrã está desligado; são acordadas por push na chamada recebida. Neste endpoint LOGGED_OUT aparecer não significa "inatingível"; a distribuição da fila considera disponível o membro que pode ser acordado.
Se a extensão tiver ativado "Não incomodar" (DND) ON_BREAK em vez de LOGGED_OUT aparece.

← Filas Lista negra