mode="webhook"، يرسل ThunderPhone طلب
telephony.incoming / web.incoming حاجبًا إلى
عنوان URL القديم لخطاف الويب
وينتظر مدة تصل إلى 10 ثوانٍ للحصول على استجابة إعداد. استخدم هذا
التبادل لاختيار موجّه وصوت وأدوات ديناميكيًا لكل مكالمة —
راجع دليل الإعداد الديناميكي للمكالمات
للاطلاع على النمط المتكامل.
تتلقى نقاط نهاية خطاف الويب المشتركة أيضًا
telephony.incoming / web.incoming — لكل مكالمة واردة
وجلسة ويب على الإطلاق، سواء كانت مُعدّة لوكيل أم لا — لكن عمليات
التسليم هذه إشعارات تُرسل دون انتظار وتتضمن event_id، وليست حاجبة
أبدًا. لا يحمل تبادل الإعدادات في هذه الصفحة سوى خطاف الويب القديم ذي
عنوان URL الواحد. تتوفر أشكال إشعارات نقاط النهاية في
كتالوج الأحداث.502/422). استجب بسرعة —
يسمع المتصل نغمة الرنين أثناء اتخاذك للقرار.
حمولة الطلب
للمكالمات الهاتفية (telephony.incoming):
بالنسبة إلى جلسات عنصر واجهة الويب (
web.incoming)، يعرّف data
الصفحة المُضمِّنة بدلًا من أرقام الهاتف:
ترسل عناصر الواجهة في وضع خطاف الويب هذا الطلب إلى
webhook_url
الخاص بالمفتاح القابل للنشر عند تعيينه، مع الرجوع إلى عنوان URL لخطاف
الويب على مستوى المؤسسة. وفي كلتا الحالتين، يُوقَّع باستخدام secret
خطاف الويب الخاص بالمؤسسة.مخطط الاستجابة
أعد كائن JSON يصف إعدادات الوكيل لهذه المكالمة. الحقلانprompt وvoice مطلوبان؛ وكل الحقول الأخرى اختيارية.
يتم تجاهل المفاتيح غير المعروفة في المستوى الأعلى بصمت — لا يؤدي اسم
الحقل الذي يحتوي على خطأ مطبعي إلى رفض الإعداد، لكنه ببساطة لا يُطبّق. لا يُقبل
ترتيب التحدث و
max_hold_seconds هنا؛ ولا يمكن ضبطهما إلا في
الوكيل نفسه.prompt وvoice مطلوبان، فإن إرجاع {} أو أي استجابة
تفشل في التحقق يؤدي إلى رفض المكالمة برمز 422 — لا توجد
آلية رجوع إلى وكيل ثابت في هذا المسار (لا يكون لرقم أو مفتاح في وضع webhook
وكيل معيّن).
مثال على معالج
استجابة باستخدام أدوات الدوال
أرفق الأدوات لكي يتمكن الذكاء الاصطناعي من استدعاء واجهات API الخاصة بك أثناء المحادثة:مرجع سريع لمستويات المنتج
ذو صلة
telephony.complete / web.complete
حدث نهاية المكالمة غير الحاجب.
أدوات الدوال
مخطط JSON الكامل لـ
tools[] وعقد نقطة النهاية الموقّع.نقاط نهاية Webhook
اشترك بعدة عناوين URL في
telephony.incoming / web.incoming.إعداد المكالمات الديناميكي
أنماط للموجّهات والأدوات واختبارات A/B لكل متصل.