- تستقبل نقاط نهاية Webhook
telephony.complete(المكالمات الهاتفية) أوweb.complete(مكالمات الويب ومكالمات اختبار الميكروفون في أداة الإنشاء) بحمولة ثابتة موثقة أدناه، وevent_idلكل عملية تسليم، ومهلة قدرها 30 ثانية، و إعادات محاولة لمدة تصل إلى 24 ساعة. - يستقبل Webhook أحادي الرابط القديم محاولة متزامنة واحدة (مهلة 10 ثوانٍ، دون إعادات محاولة) بحمولة مختلفة قليلًا — راجع اختلافات الحمولة القديمة.
حمولة الطلب (عمليات التسليم إلى نقاط النهاية)
أسباب الإنهاء
تنسيق النص المفرغ
يمثل كل إدخال فيtranscripts دورًا واحدًا في المحادثة. الأدوار هي
user (كلام المتصل)، وmodel (كلام الوكيل واستدعاءات الأدوات)،
وtool (نتائج الأدوات)، وsystem (أحداث المكالمة مثل تبديل
اللغة).
لاستخدام سجل الأدوار المنظم بالكامل (بما في ذلك علامات المقاطعة،
وموجّهات الإقرار، والمواضع الأولية)، استخدم
GET /v1/calls/{call_id}/history.
اختلافات الحمولة القديمة
غلاف webhook القديم ذو عنوان URL الواحد هو{"type": "telephony.complete" | "web.complete", "data": {…}} من دون
event_id، وتختلف data فيه عن حمولة نقطة النهاية:
- توجد مصفوفة الأدوار ضمن
history، وليسtranscripts(بنفس مخطط الأدوار الموضح أعلاه). - مجموعة الحقول هي تقرير نهاية المكالمة الأولي، وقد تتضمن حقولًا داخلية إضافية تتجاوز الجدول أعلاه — تعامل مع الحقول غير المعروفة على أنها معلومات.
- مكالمات الويب (
direction: "web") تحذفfrom_number/to_numberوتضيفorigin_domain. - تُبلّغ مكالمات اختبار الميكروفون في Builder بصيغة
telephony.completeعلى المسار القديم (يعيّنها نظام نقطة النهاية إلىweb.complete). - تنسيق التحويل: عندما تنتهي مكالمة بتحويل، يُستدعى webhook
القديم بصورة متزامنة، ويمكنه إرجاع
{"transfer_ready": false}للإشارة إلى أن هدف التسليم غير جاهز. يسمح أي رد آخر (أو عدم وجود webhook قديم) بمتابعة التحويل. ولا تتم استشارة عمليات تسليم نقطة النهاية لهذا الغرض.
مثال على معالج
حالات الاستخدام الشائعة
تكامل CRM
احفظ النص المفرغ لكل مكالمة ورابط التسجيل إلى جانب
سجلات العملاء.
التحليلات
دفق النصوص المفرغة إلى مسار معالجة لنمذجة الموضوعات، أو استخراج
مؤشرات CSAT، أو مراقبة معدل التحويل.
مراجعة الجودة
افتح المكالمات في أداة QA لمراجعة بشرية، أو مررها عبر
نموذج التقييم الخاص بك.
الإشعارات
نبّه زميلاً بشرياً عند التحويل أو الفشل.
ذو صلة
telephony.incoming / web.incoming
النظير الحاجب الذي يعمل عند بدء المكالمة.
كتالوج الأحداث
أنواع أحداث أخرى يمكنك الاشتراك فيها.
واجهة برمجة تطبيقات سجل المكالمات
البيانات نفسها متاحة عبر REST للملء اللاحق أو إعادة التشغيل.