الطوابير

حين يصل مسار المكالمة إلى أمر <Enqueue>، ينتظر المتّصل في طابور مُسمّى ويرنّ عند الوكلاء المسجَّل دخولهم إليه. تُنشَأ الطوابير عند الطلب — لا شيء لتهيئته. تُسجِّل هذه الواجهة دخول الوكلاء وخروجهم وتُظهِر لك من ينتظر.

يستخدم التحكّم بالطوابير مفتاح production (sk_live_) ونطاقَي queues:write / queues:read. لا تستطيع مفاتيح sandbox إدارة الطوابير.

تسجيل دخول وكيل

POST /v1/queues/agents/login — يبدأ الوكيل بالرنين لمكالمات ذلك الطابور.

curl -X POST https://api.wave.sa/v1/queues/agents/login \
  -H "Authorization: Bearer sk_live_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{ "agent": "agent_001", "queue": "support" }'

await fetch("https://api.wave.sa/v1/queues/agents/login", {
  method: "POST",
  headers: {
    Authorization: "Bearer sk_live_xxxxxxxxxxxx",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ agent: "agent_001", queue: "support" }),
});

الحقل	النوع	مطلوب	ملاحظات
`agent`	نصّ	نعم	`A–Z a–z 0–9 _ -`، ≤64 حرفًا.
`queue`	نصّ	نعم	المحارف نفسها، ≤64 حرفًا. يطابق اسم `<Enqueue>`.

{ "agent": "agent_001", "queue": "support", "status": "logged_in" }

تسجيل خروج وكيل

POST /v1/queues/agents/logout يسجّل خروج الوكيل من جميع الطوابير.

cURL

curl -X POST https://api.wave.sa/v1/queues/agents/logout \
  -H "Authorization: Bearer sk_live_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{ "agent": "agent_001" }'

{ "agent": "agent_001", "queue": null, "status": "logged_out" }

من ينتظر

GET /v1/queues/members?queue=support يُعيد لقطة حيّة للمتّصلين في الطابور.

{
  "queue": "support",
  "count": 2,
  "members": [
    {
      "position": 1,
      "channel_uuid": "27d6dd39-…",
      "src_number": "+966501112222",
      "state": "waiting",
      "wait_seconds": 45,
      "agent": null
    }
  ]
}

الحقل	المعنى
`position`	المكان في الصفّ (1 = التالي).
`state`	`waiting` أو `talking`.
`wait_seconds`	كم انتظر هذا المتّصل.
`agent`	الوكيل الذي يخدم المتّصل، أو `null` أثناء الانتظار.

يتحدّث التحكّم بالطوابير إلى المحرّك الصوتيّ الحيّ. إن تعذّر الوصول إليه ستحصل على QUEUE_SERVICE_UNAVAILABLE (503) أو QUEUE_CONTROL_FAILED (502) — أعِد المحاولة مع تراجُع تدريجيّ.

الجمع بينها

يضع مسارك المتّصل في الطابور

يُسمّي أمر <Enqueue> الطابور، مثل support.

يسجّل الوكلاء دخولهم

استدعِ endpoint تسجيل الدخول لكلّ وكيل متاح على support.

يرنّ المتّصلون عند الوكلاء المسجَّلين

يرنّهم Wave حسب استراتيجيّة طابورك (ring-all أو round-robin).

تراقب الطابور

استعلِم GET /v1/queues/members لعرض حيّ؛ كما تسير أحداث مؤشّرات أداء الطابور على تدفّق الأحداث الخاصّ بك.

البدء

الصوت

Web Callback

المرجع

تسجيل دخول وكيل

تسجيل خروج وكيل

من ينتظر

الجمع بينها

الخطوات التالية

WaveML: Enqueue

كيف يعمل الصوت

​تسجيل دخول وكيل

​تسجيل خروج وكيل

​من ينتظر

​الجمع بينها

​الخطوات التالية

WaveML: Enqueue

كيف يعمل الصوت

تسجيل دخول وكيل

تسجيل خروج وكيل

من ينتظر

الجمع بينها

الخطوات التالية