أي نشاط للرسائل (Catch-all)

حدث شامل يلتقط أي نشاط يتعلق بالرسائل في الجلسة.

توصيات

  • أضف تأخيرات عشوائية بين الرسائل لمحاكاة السلوك البشري.

  • تحقق من أرقام الهواتف قبل الإرسال لضمان التسليم.

المستمع الشامل: إتقان ويب هوك "أي رسالة" (Message Any)

في هندسة منصات الاتصال الحساسة، الفجوات في البيانات غير مقبولة. بينما توفر ويب هوكات محددة مثل استلام الرسائل أو حذفها إشارات مستهدفة، يعد حدث أي رسالة (Message Any) هو اللاقط العام — "المستمع الشامل" لمنصة Wawp. يتم تفعيله لكل حركة تتعلق بالرسائل، بما في ذلك الرسائل الواردة، الصادرة عبر واجهة البرمجيات، والردود اليدوية من الهاتف.


🏗️ الفلسفة المعمارية: تدفق الوعي

Mastering the Message Any API يعني الانتقال من "فلترة الأحداث" إلى "تجميع الأحداث". يمثل هذا الويب هوك النبض الخام وغير المصفى لجلسة واتساب.

  • بث ثنائي الاتجاه: يلتقط الرسائل الصادرة (fromMe: true) والواردة، مما يتيح إعادة بناء "خط زمن المحادثة" بشكل خطي ودقيق.
  • القيمة التنظيمية: بما أن هذا الويب هوك "فائض عن الحاجة بطبعه"، فإن قيمته تكمن في كونه سجلاً موحداً. غالباً ما تستخدم الأنظمة الاحترافية الويب هوكات المتخصصة لـ "منطق العمل" (مثل الرد الآلي) وتستخدم [message.any] لـ "الامتثال والأرشفة" (مثل تغذية مستودع البيانات).

🚀 حالات الاستخدام الاستراتيجي: تمكين الأعمال القابلة للتدقيق

1. سجلات تدقيق عالية الدقة للامتثال

في القطاعات المالية والقانونية، يجب تسجيل كل تفاعل للمراجعة القانونية. وبما أن هذا الويب هوك يلتقط حتى الرسائل اليدوية من الهاتف، فإنه يوفر "حقيقة كاملة" لا يمكن تجاوزها، مما يضمن بقاء مؤسستك ممتثلة لمعايير الشفافية والمساءلة.

2. تغذية مستودعات البيانات للذكاء الاصطناعي والتحليلات

من خلال تحليل التدفق الكامل للبيانات عبر [message.any]، يمكنك تحديد "ساعات الذروة"، "كلمات النزاع الشائعة"، و "درجات جهد العميل" عبر كامل الجلسة. ينقل هذا مؤسستك من "الدعم القائم على رد الفعل" إلى العمليات الاستباقية، حيث تُبنى القرارات على الإشارة الإجمالية لكل تفاعل.


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

  • هندسة الإنتاجية العالية: يمكن لمثيل واحد توليد آلاف الأحداث. لا تحاول معالجة [message.any] بشكل متزامن؛ بل استخدم وسيط رسائل (مثل Kafka أو RabbitMQ). اجعل معالج الويب هوك يدفع البيانات للحاوية ويرد بـ 200 OK فوراً، ثم دع "عمال الأرشفة" يعالجون البيانات بوتيرتهم الخاصة.
  • منطق عدم التكرار: تأكد من أن قاعدة بياناتك تستخدم "معرف الرسالة" كقيد فريد لمنع "الحساب المزدوج" في التحليلات إذا وصل نفس الحدث عبر قناتين مختلفين.
  • مراقبة "الوكلاء الظل": راقب الرسائل الصادرة (fromMe: true) لتتبع إنتاجية الوكلاء البشريين والتأكد من عدم تجاوهم لنظام الـ CRM الرسمي عبر الهاتف الخاص.

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

استكشف كافة الردود والنتائج المحتملة من الخادم. قمنا بتوثيق كل كود حالة (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": "message.any",
"payload": {
  "id": "true_11111111111@c.us_...",
  "body": "Catching everything!",
  "from": "11111111111@c.us",
  "to": "22222222222@c.us"
  },
"me": {
  "id": "11111111111@c.us",
  "lid": "123@lid",
  "pushName": "Instance"
  }
}

Command Palette

Search for a command to run...