الانتقال إلى المحتوى الرئيسي
يُجري Web Callback اتصالًا بنقرة واحدة من الـ backend الخاصّ بك: تحدّد وجهة، فتطلبها Wave عبر الـ telephony backend الخاصّ بها وتجسر المكالمة.

​
إجراء مكالمة

POST /v1/callback مع رقم to على الأقلّ. راجع البدء السريع ومرجع الـ API.

​
توصيل المكالمة بعد الرد

عندما يردّ العميل على مكالمة رد اتصال في الإنتاج، يجب أن يعرف Wave أين يوصل المكالمة. نفّذ ما يلي قبل الانتقال إلى الإنتاج:
  • اربط قائمة رد صوتي تفاعلي برقمك. القائمة المربوطة تأتي أوّلًا دائمًا.
  • أو عيّن رقم توصيل: في لوحة التحكّم، افتح الإعدادات ← رقم التوصيل (للمالك أو المشرف فقط). يتّصل Wave بهذا الرقم السعوديّ (جوال أو هاتف ثابت) ويوصل العميل به، ويرى من يردّ رقم مشروعك. إذا لم يردّ أحد، يسمع العميل رسالة قصيرة ثم تنتهي المكالمة.
إذا لم يُعدّ أيّ خيار، يسمع العميل رسالة قصيرة بأنّ الرقم غير متاح، ثم تنتهي المكالمة. لا تتغيّر مكالمة رد الاتصال في وضع الاختبار: تُشغّل رسالة الاختبار.

​
دورة حياة المكالمة

يُنشأ الـ callback بالحالة status: "initiated" ويُعيد 202 فورًا. ثمّ تتقدّم المكالمة عبر دورة حياتها حسبما يُبلغ الـ telephony backend — answered (مع answered_at)، ثمّ ended (مع duration). ويُطلق كلّ انتقال الـ webhook المقابل (call.answered وcall.ended)، وتُكتب الحالة النهائيّة والمدّة في سجلّ المكالمة.
عامِل الرمز 202 بوصفه “مقبولًا”، لا “مكتملًا”. اشترِك في الـ webhooks — أو استعلِم عن GET /v1/calls — لتتابع المكالمة حتّى answered / ended.

​
سجلّات المكالمات

يُسجَّل كلّ callback. استرجِعها عبر GET /v1/calls — مُقسَّمة بالصفحات باستخدام cursor (cursor، وlimit حتّى 100)، والأرقام مُقنَّعة — أو اعرِضها في صفحة Call Logs في لوحة التحكّم. راجع مرجع الـ API للاطّلاع على الطلب/الاستجابة الكاملين.

​
إلغاء مكالمة مفردة / استرجاعها

  • GET /v1/callbacks
  • GET /v1/callbacks/:id
  • DELETE /v1/callbacks/:id
يرى المفتاح الـ callbacks الخاصّة ببيئته فقط: تقبل القائمة environment (أرسل قيمة بيئة المفتاح نفسه فقط؛ أيّ قيمة أخرى تُعيد 400 VALIDATION_ERROR)، وقراءة أو إلغاء callback من البيئة الأخرى يُعيد 404 CALLBACK_NOT_FOUND. راجع وضع الـ Sandbox.