إجراء مكالمة
POST /v1/callback مع رقم to على الأقلّ. راجع البدء السريع ومرجع الـ API.
دورة حياة المكالمة
يُنشأ الـ 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/:id وDELETE /v1/callbacks/:id قادمان قريبًا — وهما غير فعّالين بعد. وستوثّقهما هذه الصفحة عند إطلاقهما.