يُجري Web Callback اتصالًا بنقرة واحدة من الـ backend الخاصّ بك: تحدّد وجهة، فتطلبها Wave عبر الـ telephony backend الخاصّ بها وتجسر المكالمة.
إجراء مكالمة
POST /v1/callback مع رقم to على الأقلّ. راجع البدء السريع ومرجع الـ API.
| الحقل | مطلوب | الوصف |
|---|
to | ✅ | رقم وجهة سعوديّ بصيغة E.164 (+9665XXXXXXXX). |
caller_id_name | — | اسم معرّف المتّصل المعروض للمستقبِل. |
caller_id_number | — | رقم معرّف المتّصل. |
from_queue | — | التحويلة/الطابور المصدر. |
metadata | — | كائن مفتاح/قيمة يُعاد إرساله في الـ webhooks. |
دورة حياة المكالمة
يُنشأ الـ callback بالحالة status: "initiated" ويُعيد 202 فورًا.
اليوم، تبقى الحالة initiated. أمّا الحالات النهائيّة — answered وended وduration — فهي لا تُصدَر بعد. وستصل مع تدفّق الأحداث اللحظيّ (قيد التنفيذ). خطّط لتكاملك على أساس معاملة initiated بوصفها “مقبولة”، لا “مكتملة”.
initiated ──▶ (answered) ──▶ (ended)
سجلّات المكالمات
يُسجَّل كلّ callback. استرجِعها عبر GET /v1/calls — مُقسَّمة بالصفحات باستخدام cursor (cursor، وlimit حتّى 100)، والأرقام مُقنَّعة — أو اعرِضها في صفحة Call Logs في لوحة التحكّم. راجع مرجع الـ API للاطّلاع على الطلب/الاستجابة الكاملين.
إلغاء مكالمة مفردة / استرجاعها
الـ GET /v1/callbacks/:id وDELETE /v1/callbacks/:id قادمان قريبًا — وهما غير فعّالين بعد. وستوثّقهما هذه الصفحة عند إطلاقهما. 
