Skip to main content
تتيح لك المكالمات الصادرة تمرير رقم وجهة وإعداد وكيل إلى ThunderPhone ليجري الذكاء الاصطناعي المكالمة نيابةً عنك. حالات الاستخدام المعتادة:
  • تأكيدات المواعيد
  • معاودة الاتصال للاستبيانات
  • متابعات «المحاولة الثانية» بعد مكالمة فائتة
  • إشعارات بأسلوب الإرسال
هل تتصل بقائمة كاملة؟ تتيح ميزة الحملات في لوحة التحكم (/dashboard/campaigns) تحميل ملف CSV لجهات الاتصال، وتتولى نوافذ الاتصال المراعية للمنطقة الزمنية، والتزامن، وسياسة إعادة المحاولة نيابةً عنك. يغطي هذا الدليل المكالمات البرمجية الفردية.

المتطلبات الأساسية

1

أحضر رقم VoIP

تتطلب المكالمات الصادرة أن تمتلك from_number عبر اتصال VoIP. أرقام العرض التوضيحي مخصصة للمكالمات الواردة فقط. راجع أحضر أرقامك الخاصة.
2

أنشئ وكيلاً

يميل الموجّه المخصص للمكالمات الصادرة إلى البدء بتعريف الوكيل بنفسه وبغرضه — «مرحباً، معك Acme للاتصال لتأكيد موعدك غداً الساعة 3 مساءً…». اضبط outbound_speak_order على agent_first (القيمة الافتراضية).
3

حافظ على رصيد موجب

تُرجع المكالمات الصادرة 402 Payment Required إذا كان الرصيد ≤ $0.00. اشحن الرصيد عبر POST /v1/billing/top-up أو فعّل إعادة الشحن التلقائي.

أجرِ مكالمة باستخدام وكيل محفوظ

أبسط طريقة — الإشارة إلى وكيل عبر معرّفه:
الاستجابة:
يعني status: "initiated" فقط أنه تم قبول الطلب — المكالمة لم تتصل بعد. استعلم دورياً عن GET /v1/calls/{call_id} للحصول على الحالة المباشرة (in_progresscompleted / failed).

أجرِ مكالمة بإعداد مضمن

إذا أردت موجّهاً لمرة واحدة لا يستحق الحفظ كوكيل، فمرر config بدلاً من ذلك. يتطابق الشكل مع مخطط الاستجابة لخطاف الويب call.incoming:

تابع المكالمة

بالتوازي، اشترك في خطاف الويب telephony.complete — وهو أسرع طريقة لمعرفة انتهاء المكالمة. إذا لم تتمكن من استقبال خطافات الويب الواردة، فاستعلم دورياً عن GET /v1/calls/{call_id} كل بضع ثوانٍ؛ يتضمن السجل end_reason وduration_seconds ورابط التسجيل عند انتهاء المكالمة.

حالات الفشل التي تستحق المعالجة

التحكم في مدة الانتظار

يمكن تحديد حد أقصى للمكالمات الصادرة التي تطول لأن الطرف المتصل به بطيء في الاستجابة (قوائم IVR، قوائم الانتظار) باستخدام max_hold_seconds:
ينهي الوكيل المكالمة إذا لم يتم تلقي أي صوت بشري خلال آخر N ثانية. القيمة الافتراضية هي 900 (15 دقيقة).

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

مرجع المكالمات الصادرة

كل حقول الطلبات ورموز الأخطاء.

استقبال call.complete

أرسل المكالمات الصادرة المكتملة إلى نظامك بشكل متدفق.

الفوترة

إعادة الشحن تلقائيًا حتى لا تفشل المكالمات الصادرة بسبب الرصيد.

اختبار الوكلاء الصادرين

نفّذ تشغيلًا تجريبيًا لوكيلك الصادر قبل الإنتاج.