حذف الرسالة (للجميع)
يتم تفعيله عندما يقوم المستخدم بحذف رسالة للجميع.
توصيات
أضف تأخيرات عشوائية بين الرسائل لمحاكاة السلوك البشري.
تحقق من أرقام الهواتف قبل الإرسال لضمان التسليم.
حدث المحو: إتقان التراجع عن الرسائل (السيادة على المحتوى)
في اتصالات الوقت الفعلي، البيانات ليست دائمة دائماً. توفر ميزة "الحذف للجميع" — والمعروفة تقنياً بـ النقض (Revocation) — للمستخدمين القدرة على سحب رسالة بعد إرسالها. يوفر ويب هوك [message.revoked] إشعاراً فورياً بأن تفاعلاً معيناً قد تم إبطاله من قبل المرسل، وهو ركن أساسي لـ سلامة المحادثة والامتثال للخصوصية.
🏗️ الفلسفة المعمارية: طبيعة النص المتطايرة
يجب الاعتراف بالتحول الفلسفي من "الأرشفة أولاً" إلى "سيادة المستخدم على بياناته". النقض هو أمر صريح من المستخدم لتطهير نقطة بيانات معينة من سجل المحادثة المشترك.
- استراتيجية ربط الهوية: لا تحتوي حمولة [
message.revoked] على نص الرسالة الأصلي؛ بل تحتوي على معرف الرسالة الفريد و معرف الشخص (JID) الذي قام بالحذف. - النقض في المجموعات: في المجموعات، يعد حقل [
revokedBy] حاسماً؛ فهو يوضح ما إذا كان المرسل الأصلي قد حذف رسالته، أو إذا استخدم مسؤول المجموعة صلاحياته لإزالة رسالة أحد المشاركين للمجموعة بأكملها.
🚀 حالات الاستخدام الاستراتيجي
1. الحفاظ على "حقيقة الخدمة" (منع التفاعل مع الأشباح)
من غير المهني أن يقوم بوت أو وكيل بشري بالرد على رسالة قام المستخدم بحذفها بالفعل. عندما يصل الويب هوك، يجب على النظام فوراً إيقاف توليد أي رد تلقائي مرتبط بتلك الرسالة، مما يمنع ظهور البوت كأنه "يسمع أصواتاً" أو يرد على أسئلة لم تعد موجودة.
2. الامتثال والخصوصية (الحق في النسيان)
في العديد من التشريعات (مثل GDPR في أوروبا)، يعد طلب المستخدم حذف بياناته أمراً قانونياً ملزماً. يجب على نظامك معاملة حدث [message.revoked] كـ طلب حذف مخول. بدلاً من مجرد إخفاء الرسالة، يجب على نظامك "تطهير" نص الرسالة الأصلي من قاعدة بياناتك واستبداله بعلامة وصفية: [تم حذف المحتوى بواسطة المستخدم].
🛡️ أفضل الممارسات التشغيلية والهندسية
- إشارات واجهة المستخدم: في لوحة تحكم الوكلاء، لا تحذف السطر تماماً، بل استبدله بنص باهت "تم حذف هذه الرسالة". هذا يوفر سياقاً للوكيل: "لقد قال العميل شيئاً ثم تراجع عنه"، مما يسمح للوكيل بتعديل أسلوبه.
- إيقاف تحميل الوسائط: إذا تم نقض رسالة وسائط (صورة/فيديو) بينما يقوم نظامك بتحميلها حالياً، فأوقف عملية التحميل فوراً لتوفير البث الأرضي وضمان عدم تخزين صور حساسة على خوادمك.
- تحقق من صلاحية الناقض: في المجموعات، تأكد من هوية الشخص الذي حذف الرسالة. إذا قام مسؤول بحذفها، يمكنك تسجيل ذلك كـ "إجراء إشرافي" لتحليل نشاط المشرفين في الحفاظ على نظافة المجتمع.
الردود المتوقعة
استكشف كافة الردود والنتائج المحتملة من الخادم. قمنا بتوثيق كل كود حالة (Status Code) مع أمثلة للبيانات لتسهيل معالجة الأخطاء والنجاح.
Example
{
"id": "evt_01...",
"timestamp": 1634567890123,
"session": "default",
"metadata": {
"user.id": "123",
"user.email": "email@example.com"
},
"engine": "WEBJS",
"event": "message.revoked",
"payload": {
"id": "false_11111111111@c.us_...",
"revokedBy": "11111111111@c.us"
},
"me": {
"id": "11111111111@c.us",
"lid": "123@lid",
"pushName": "Instance"
}
}Command Palette
Search for a command to run...