قائمة الموظفين المرشحات الملاحظات

حالات الموظفين

يعرض الحالة اللحظية لموظفي خدمة العملاء (الأرقام الداخلية) والطوابير التي ينتمون إليها. يُستخدم للوحة الحائط أو مؤشر "من متاح" في 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 يظهر.

→ الطوابير القائمة السوداء