- تستقبل نقاط نهاية Webhook
telephony.complete(المكالمات الهاتفية) أوweb.complete(مكالمات الويب ومكالمات اختبار ميكروفون أداة الإنشاء) بالحمولة المستقرة الموضحة أدناه، وevent_idلكل عملية تسليم، ومهلة قدرها 30 ثانية، و إعادات محاولة لمدة تصل إلى 24 ساعة. - يستقبل Webhook القديم أحادي الرابط محاولة متزامنة واحدة (مهلة قدرها 10 ثوانٍ، دون إعادة محاولة) بحمولة مختلفة قليلًا — راجع اختلافات الحمولة القديمة.
حمولة الطلب (عمليات التسليم إلى نقاط النهاية)
أسباب الإنهاء
تنسيق النص المفرغ
كل إدخال في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 للاستكمال أو إعادة التشغيل.
