Skip to main content
يتم تشغيل حدث إكمال بعد انتهاء كل مكالمة — الاتصالات الهاتفية الواردة، والاتصالات الهاتفية الصادرة، أو مكالمة الويب، أو مكالمة اختبار (جلسة ميكروفون أداة الإنشاء). وهو غير حاجب: استجب بأي رمز 2xx. يتم تسليم الحدث عبر كلا المسارين:

حمولة الطلب (عمليات التسليم إلى نقاط النهاية)

أسباب الإنهاء

تنسيق النص المفرغ

يمثل كل إدخال في 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 للملء اللاحق أو إعادة التشغيل.