استلام مكالمة
يتم تفعيله عند اكتشاف مكالمة صوتية أو مرئية واردة.
توصيات
استخدم متغيرات البيئة لبيانات الاعتماد الحساسة مثل رموز الوصول.
قم بتنفيذ معالجة قوية للأخطاء ومنطق إعادة المحاولة.
جسر "الصوت إلى نص": إتقان ويب هوك استلام المكالمات
في منظومة الدعم الرقمي، غالباً ما تكون المكالمة الواردة إشارة إلى حالة طوارئ عالية أو إحباط لدى المستخدم. وعلى الرغم من أن منصة Wawp لا تدعم استقبال تدفقات الصوت (VoIP) مباشرة، إلا أن ويب هوك [call.received] يعد حدثاً تشغيلياً حيوياً؛ فهو يسمح لبنيتك التحتية بـ "سماع" حالة الرنين وتزويد نظامك بالبيانات الوصفية اللازمة لسد الفجوة بين الطلب الصوتي والحل القائم على النص.
🏗️ الفلسفة المعمارية: المكالمة كإشارة تصعيد
يجب إدراك أن مكالمة واتساب هي "طلب للتفاعل المتزامن". في سياق سير العمل الذي يقوده البوت، يعد هذا غالباً إشارة إلى أن المستخدم يجد القوائم النصية غير كافية لاحتياجاته الحالية.
1. البيانات الوصفية للمحاولة
يوفر حدث [call.received] الهوية الأساسية للتفاعل:
- الهوية (from): معرف واتساب للمتصل، مما يتيح البحث الفوري في الـ CRM.
- النوع (isVideo): التمييز بين المكالمة الصوتية والمرئية. محاولة الاتصال المرئي تشير غالباً إلى رغبة في "عرض" المشكلة (منتج مكسور مثلاً) بدلاً من مجرد "شرحها".
2. الحدود التشغيلية
من الضروري معمارياً معاملة Wawp كـ حساس (Sensor) وليس كمستقبل (Receiver). لا يمكن لنظامك "الرد" على المكالمة، وبدلاً من ذلك، يجب معاملة الحدث كـ محفز لسير عمل احتياطي مؤتمت.
🚀 حالات الاستخدام الاستراتيجي: التحويل التلقائي للمكالمات
1. استراتيجية إعادة التوجيه الفوري
بمجرد انطلاق حدث [call.received]، يمكن للبوت إرسال رسالة خاصة للمتصل فوراً: "أهلاً بك! رأينا محاولتك للاتصال. نحن نقدم الدعم حالياً عبر الدردشة فقط لضمان التعامل مع جميع الطلبات بكفاءة. كيف يمكنني مساعدتك اليوم؟". هذا ينقل المستخدم من حالة "عدم الرد" المحبطة إلى حالة "الدردشة النشطة" في ثوانٍ.
2. تنبيه الوكلاء للحالات الطارئة
بالنسبة للحسابات المميزة (VIP)، يجب أن يتجاوز الاتصال الوارد البوت القياسي ويحفز تنبيهاً داخلياً لوكيل بشري: "العميل [الاسم] يتصل حالياً عبر واتساب! يرجى التواصل معه عبر الدردشة فوراً". حتى لو لم يرد الوكيل على المكالمة (وهو ما لا يمكنه فعله عبر الواجهة)، يمكنه بدء دردشة استباقية بينما لا يزال المستخدم يمسك بهاتفه.
🛡️ أفضل الممارسات التشغيلية والهندسية
- تجنب رسائل التكرار: طبق قاعدة "Call Debounce"؛ فإذا أرسلت رسالة إعادة توجيه لمستخدم، فلا ترسلها مرة أخرى لنفس المستخدم خلال دقيقتين حتى لو تكرر الرنين.
- المزامنة مع الأجهزة المادية: إذا كان لديك هاتف مادي مرتبط بالأرقام، فسوف يرن ذلك الهاتف. يتيح لك هذا الويب هوك معرفة ما يراه الشخص الذي يمسك بالهاتف، مما يوفر رؤية موحدة للعميل.
- المعالجة منخفضة التأخير: تهدف معالجة هذا الويب هوك لإرسال رسالة إعادة التوجيه في أقل من 500 ملّي ثانية لتبقى ذات صلة بسياق المتصل.
الردود المتوقعة
استكشف كافة الردود والنتائج المحتملة من الخادم. قمنا بتوثيق كل كود حالة (Status Code) مع أمثلة للبيانات لتسهيل معالجة الأخطاء والنجاح.
Example
{
"id": "evt_01...",
"timestamp": 1634567890123,
"session": "default",
"metadata": {
"user.id": "123",
"user.email": "email@example.com"
},
"engine": "WEBJS",
"event": "call.received",
"payload": {
"id": "call_12345",
"from": "11111111111@c.us",
"isVideo": false
},
"me": {
"id": "11111111111@c.us",
"lid": "123@lid",
"pushName": "Instance"
}
}Command Palette
Search for a command to run...