Liste des agents Filtres Notes

Statuts des agents

Liste l'état instantané des agents commerciaux (postes) et les files dont ils sont membres. Utilisé pour un affichage mural, un indicateur « qui est disponible » dans le CRM ou un rapport de service. Clé API (portée call; Authorization: Bearer bt_… dans l'en-tête, voir Sécurité de l'API), GET.

Limite de débit : 2 requêtes par minute. Ne bouclez pas ce point d'accès pour un rafraîchissement à la seconde ; l'écran de suivi en direct ou les données du pont CRM conviennent mieux.

GETListe des agents

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

Champ	Description
`agent`	Numéro de poste
`status`	`AVAILABLE` disponible · `TALKING` en conversation · `ON_BREAK` en pause · `LOGGED_OUT` non enregistré / hors ligne
`queues`	Numéros des files dont il est membre
`break_description`	Nom de la pause, si en pause

Filtres

Paramètre	Description
`agent`	Un seul poste (`1010`)
`status`	Filtre de statut (`AVAILABLE`, `TALKING`, `ON_BREAK`, `LOGGED_OUT`)
`queue`	Membres d'une file précise (numéro ou nom de la file)

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

Notes

Les postes avec application mobile peuvent apparaître non enregistrés sur le standard quand l'écran est éteint ; ils sont réveillés par push à l'appel entrant. Sur ce point d'accès LOGGED_OUT s'afficher comme « injoignable » ne signifie pas qu'il l'est ; la distribution de la file considère un membre réveillable comme disponible.
Si le poste interne a activé « Ne pas déranger » (DND) ON_BREAK à la place de LOGGED_OUT s'affiche.

← Files d'attente Liste noire