فهرست نمایندگان فیلترها یادداشت‌ها

وضعیت نمایندگان

وضعیت لحظه‌ای نمایندگان مشتری (داخلی‌ها) و صف‌هایی که عضو آن‌ها هستند را فهرست می‌کند. برای تابلوی دیواری، نشانگر «چه کسی آزاد است» در CRM یا گزارش شیفت استفاده می‌شود. کلید API (دامنه call; Authorization: Bearer bt_… در هدر، رجوع شود به امنیت API), GET.

محدودیت نرخ: 2 درخواست در دقیقه. برای تازه‌سازی ثانیه‌ای این نقطه را در حلقه نگذارید؛ صفحه پیگیری زنده یا داده پل CRM مناسب‌تر است.

GETفهرست نمایندگان

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

حوزه	توضیح
`agent`	شماره داخلی
`status`	`AVAILABLE` آزاد · `TALKING` در گفتگو · `ON_BREAK` در استراحت · `LOGGED_OUT` ثبت‌نشده / آفلاین
`queues`	شماره صف‌هایی که عضو آن است
`break_description`	اگر در استراحت است نام استراحت

فیلترها

پارامتر	توضیح
`agent`	یک داخلی (`1010`)
`status`	فیلتر وضعیت (`AVAILABLE`, `TALKING`, `ON_BREAK`, `LOGGED_OUT`)
`queue`	اعضای صف مشخص (شماره یا نام صف)

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

یادداشت‌ها

داخلی‌های دارای اپلیکیشن موبایل با صفحه خاموش ممکن است در سانترال ثبت‌نشده دیده شوند؛ این‌ها در تماس ورودی با push بیدار می‌شوند. در این نقطه LOGGED_OUT دیده شدن به معنی «در دسترس نیست» نیست؛ توزیع صف عضو قابل بیدارشدن را آزاد حساب می‌کند.
اگر داخلی «مزاحم نشوید» (DND) را روشن کرده باشد ON_BREAK به‌جای LOGGED_OUT دیده می‌شود.

← صف‌ها لیست سیاه