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

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

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

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

كل إدخال في transcripts هو دور واحد في المحادثة. الأدوار هي user (كلام المتصل)، وmodel (كلام الوكيل واستدعاءات الأدوات)، وtool (نتائج الأدوات)، وsystem (أحداث المكالمة مثل تبديل اللغة).
لاستخدام سجل الأدوار المنظّم بالكامل (مع علامات المقاطعة، وموجّهات الإقرار، والمواضع الأولية)، استخدم GET /v1/calls/{call_id}/history.

اختلافات الحمولة القديمة

غلاف خطاف الويب القديم ذي عنوان URL الواحد هو {"type": "telephony.complete" | "web.complete", "data": {…}} من دون event_id، وتختلف قيمة data فيه عن حمولة نقطة النهاية:
  • توجد مصفوفة الأدوار ضمن history، وليس transcripts (وبنفس مخطط الأدوار أعلاه).
  • مجموعة الحقول هي تقرير نهاية المكالمة الأولي، وقد تتضمن حقولًا داخلية إضافية غير المذكورة في الجدول أعلاه — تعامل مع الحقول غير المعروفة على أنها معلوماتية.
  • مكالمات الويب (direction: "web") لا تتضمن from_number / to_number وتضيف origin_domain.
  • تُبلّغ مكالمات اختبار الميكروفون في أداة الإنشاء على أنها telephony.complete عبر المسار القديم (يحوّلها نظام نقطة النهاية إلى web.complete).
  • تنسيق التحويل: عند انتهاء مكالمة بتحويل، يُستدعى خطاف الويب القديم بشكل متزامن، وقد يجيب بـ {"transfer_ready": false} للإشارة إلى أن هدف التسليم غير جاهز. يسمح أي رد آخر (أو عدم وجود خطاف ويب قديم) بمتابعة التحويل. لا تتم استشارة عمليات التسليم عبر نقطة النهاية لهذا الغرض.

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


حالات الاستخدام الشائعة

تكامل CRM

احفظ النص المفرغ لكل مكالمة ورابط التسجيل إلى جانب سجلات عملائك.

التحليلات

أرسل النصوص المفرغة إلى مسار معالجة لنمذجة الموضوعات، أو استخراج مؤشرات CSAT، أو مراقبة معدل التحويل.

مراجعة الجودة

افتح المكالمات في أداة ضمان الجودة لمراجعتها بشريًا، أو مررها عبر نموذج التقييم الخاص بك.

الإشعارات

نبّه زميلًا بشريًا عند التحويل أو الإخفاق.

ذو صلة

telephony.incoming / web.incoming

النظير الحاجب الذي يعمل عند بدء المكالمة.

كتالوج الأحداث

أنواع الأحداث الأخرى التي يمكنك الاشتراك فيها.

واجهة برمجة تطبيقات سجل المكالمات

البيانات نفسها متاحة عبر REST للاستكمال أو إعادة التشغيل.