Files d'attente

Gérez la liste des files, les appels en attente dans la file et les appartenances aux files. Clé API (portée call; Authorization: Bearer bt_… dans l'en-tête, voir Sécurité de l'API), GET. Limite de débit : 120 requêtes par minute et par clé.

GETListe des files

GET https://api.buluthat.com/api/queues.php
[
  { "number": 200, "name": "Satış" },
  { "number": 201, "name": "Teknik Destek" }
]

number est le numéro de la file sur le standard (« numéro de file » dans le panneau) ; sur les autres points d'accès queue_number est utilisé comme.

GETEn attente dans la file

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 C'est un horodatage Unix. Pour relier directement un appel en attente à un agent call_uuid avec Transférer l'appel est utilisable.

GETPostes de la file

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

GETAjouter / retirer / ordonner les postes de la file

La liste des membres de la file entièrement remplace par la liste que vous fournissez ; l'ordre est l'ordre de lecture.

GET https://api.buluthat.com/api/queue_manage_users.php?queue_number=200&user_list=1000,1001,1002
ParamètreDescription
queue_numberNuméro de file
user_listNuméros de postes séparés par des virgules ; une liste vide vide la file

Réponse 200 OK / OK. Erreurs : Queue_number value null or none, User value null or none 1001 (aucun poste interne).

Le changement est appliqué immédiatement ; les appels en cours ne sont pas affectés. Pour les pauses des agents, utilisez « Gestion des pauses » du panneau ou le point d'accès de statut des agents.

Agent d'intelligence artificielle

L'assistant vocal lié à la file (mode débordement / assistant d'abord) ne se configure pas par API mais depuis le panneau > Files > carte « Agent IA » ; l'assistant n'est pas membre de la file, il converse en parallèle. Voir Assistant vocal.