رفض المكالمة

يتم تفعيله عند رفض مكالمة واردة.

توصيات

  • Mark the call as 'Declined' in your communication history database.

إغلاق حلقة الصوت: إتقان ويب هوك رفض المكالمات

في منظومة الاتصالات الرقمية، يعد إنهاء التفاعل بنفس أهمية بدئه. يعد ويب هوك [call.rejected] الحدث النهائي لـ "نهاية الإشارة" لمحاولة صوتية أو مرئية. سواء تم رفض المكالمة يدوياً بواسطة وكيل بشري عبر الهاتف، أو تم إنهاؤها تلقائياً بناءً على سياسة النظام، فإن هذا الحدث يزود بنيتك التحتية بالإغلاق اللازم للحفاظ على سجل تدقيق دقيق لتفاعل العملاء.


🏗️ الفلسفة المعمارية: المكالمة كجلسة محدودة

تعمل مكالمة واتساب كحالة متزامنة تستهلك الموارد والاهتمام. يعمل حدث [call.rejected] كمنظف للمنطق البرمجي الخاص بك.

  • إعادة مطابقة الحالة: المعرف [id] في الحمولة هو "المفتاح الأساسي" الذي يربط حدث استلام المكالمة بحدث رفضها. يجب على نظامك استخدام هذا المعرف لنقل سجل المكالمة من "رنين" إلى "منتهي".
  • الشفافية في الأداء: في مراكز الدعم، يعد "معدل الرفض" مؤشراً حيوياً للأداء (KPI). يتيح لك ربط هذا الويب هوك بالوكيل المكلف بالأرقام تحديد أنماط تجنب التفاعلات، مما يساعد في الإدارة القائمة على البيانات التقنية.

🚀 حالات الاستخدام الاستراتيجي: الدردشة الاستباقية الفورية

إذا تم رفض مكالمة، فمن المرجح أن المستخدم يمسك بهاتفه الآن. هذه هي اللحظة المثالية لمتابعة نصية. فبمجرد استلام الويب هوك، يمكن للنظام إرسال رسالة: "نعتذر عن عدم قدرتنا على الرد الآن! نحن نساعد عملاء آخرين عبر الدردشة حالياً. كيف يمكننا مساعدتك هنا؟". هذا يحول التفاعل السلبي (مكالمة مرفوضة) إلى مشاركة إيجابية (دردشة استباقية).


🛡️ أفضل الممارسات الهندسية والتشغيلية

  • قاعدة الـ 500 ملّي ثانية: كبقية أحداث المكالمات، يعد الرفض حساساً جداً للوقت. إذا وصلت رسالة المتابعة متأخرة بـ 10 دقائق، فمن المحتمل أن يكون العميل قد انتقل إلى منافس آخر.
  • تنظيف الحالة المؤقتة: إذا كنت تستخدم ذاكرة مؤقتة (مثل Redis) لتتبع "المكالمات النشطة"، استخدم هذا الحدث لمسح المدخل الخاص بمعرف المكالمة فوراً، مما يحافظ على كفاءة الذاكرة.
  • المزامنة مع الواقع المادي: إذا قام شخص بحمل الهاتف المادي والضغط على "رفض"، فإن هذا الويب هوك هو وسيلة الباك-إند الوحيدة لمعرفة ما فعله المشغل البشري، مما يبقي لوحة التحكم الرقمية متزامنة مع الواقع.

الردود المتوقعة

استكشف كافة الردود والنتائج المحتملة من الخادم. قمنا بتوثيق كل كود حالة (Status Code) مع أمثلة للبيانات لتسهيل معالجة الأخطاء والنجاح.

Webhook Payload Example
application/json
string *
number *
string *
object *
string *
string *
object *
object *

Example

{
"id": "evt_01...",
"timestamp": 1634567890123,
"session": "default",
"metadata": {
  "user.id": "123",
  "user.email": "email@example.com"
  },
"engine": "WEBJS",
"event": "call.rejected",
"payload": {
  "id": "call_12345"
  },
"me": {
  "id": "11111111111@c.us",
  "lid": "123@lid",
  "pushName": "Instance"
  }
}

Command Palette

Search for a command to run...