Skip to main content
عند وصول مكالمة هاتفية واردة إلى رقم من دون وكيل مُعيّن، أو عند بدء جلسة عنصر واجهة ويب على مفتاح قابل للنشر في mode="webhook"، يرسل ThunderPhone طلب telephony.incoming / web.incoming حاجبًا إلى عنوان URL القديم لخطاف الويب وينتظر مدة تصل إلى 10 ثوانٍ للحصول على استجابة إعداد. استخدم هذا التبادل لاختيار موجّه وصوت وأدوات ديناميكيًا لكل مكالمة — راجع دليل الإعداد الديناميكي للمكالمات للاطلاع على النمط المتكامل.
تتلقى نقاط نهاية خطاف الويب المشتركة أيضًا telephony.incoming / web.incoming — لكل مكالمة واردة وجلسة ويب على الإطلاق، سواء كانت مُعدّة لوكيل أم لا — لكن عمليات التسليم هذه إشعارات تُرسل دون انتظار وتتضمن event_id، وليست حاجبة أبدًا. لا يحمل تبادل الإعدادات في هذه الصفحة سوى خطاف الويب القديم ذي عنوان URL الواحد. تتوفر أشكال إشعارات نقاط النهاية في كتالوج الأحداث.
ليس للتبادل الحاجب بديل احتياطي: إذا أعاد معالجك حالة غير 2xx، أو انتهت مهلته، أو أعاد إعدادًا يفشل التحقق منه، تُرفض المكالمة (لا تتصل المكالمة الهاتفية؛ ويفشل طلب جلسة عنصر الواجهة بالحالتين 502/422). استجب بسرعة — يسمع المتصل نغمة الرنين أثناء اتخاذك للقرار.

حمولة الطلب

للمكالمات الهاتفية (telephony.incoming):
بالنسبة إلى جلسات عنصر واجهة الويب (web.incoming)، يعرّف data الصفحة المُضمِّنة بدلًا من أرقام الهاتف:
ترسل عناصر الواجهة في وضع خطاف الويب هذا الطلب إلى webhook_url الخاص بالمفتاح القابل للنشر عند تعيينه، مع الرجوع إلى عنوان URL لخطاف الويب على مستوى المؤسسة. وفي كلتا الحالتين، يُوقَّع باستخدام secret خطاف الويب الخاص بالمؤسسة.

مخطط الاستجابة

أعد كائن JSON يصف إعدادات الوكيل لهذه المكالمة. الحقلان prompt وvoice مطلوبان؛ وكل الحقول الأخرى اختيارية.
يتم تجاهل المفاتيح غير المعروفة في المستوى الأعلى بصمت — لا يؤدي اسم الحقل الذي يحتوي على خطأ مطبعي إلى رفض الإعداد، لكنه ببساطة لا يُطبّق. لا يُقبل ترتيب التحدث وmax_hold_seconds هنا؛ ولا يمكن ضبطهما إلا في الوكيل نفسه.
لأن prompt وvoice مطلوبان، فإن إرجاع {} أو أي استجابة تفشل في التحقق يؤدي إلى رفض المكالمة برمز 422 — لا توجد آلية رجوع إلى وكيل ثابت في هذا المسار (لا يكون لرقم أو مفتاح في وضع webhook وكيل معيّن).

مثال على معالج


استجابة باستخدام أدوات الدوال

أرفق الأدوات لكي يتمكن الذكاء الاصطناعي من استدعاء واجهات API الخاصة بك أثناء المحادثة:
تُوقَّع طلبات نقاط نهاية الأدوات باستخدام سر webhook الخاص بالمؤسسة نفسه الذي وقّع هذا التبادل. راجع أدوات الدوال للاطلاع على البنية الدقيقة وتنسيق الطلب الموقّع.

مرجع سريع لمستويات المنتج


ذو صلة

telephony.complete / web.complete

حدث نهاية المكالمة غير الحاجب.

أدوات الدوال

مخطط JSON الكامل لـ tools[] وعقد نقطة النهاية الموقّع.

نقاط نهاية Webhook

اشترك بعدة عناوين URL في telephony.incoming / web.incoming.

إعداد المكالمات الديناميكي

أنماط للموجّهات والأدوات واختبارات A/B لكل متصل.