WA Bot لأتمتة WhatsApp

WA Bot مشروع خاص لأتمتة محادثات WhatsApp ومجموعاته من حساب متصل واحد. يجمع أوامر المحادثة وضوابط المجموعات والرسائل المجدولة ولوحة إدارة في المتصفح وAPI لإرسال النصوص.

المشكلة

تتراكم في الحساب الواحد مهام الإشراف على المجموعات والرسائل المتكررة وطلبات الوسائط. إدارة كل مهمة يدويًا تستهلك وقت المشغل. يوجه البوت الأحداث الواردة إلى الأوامر والخدمات المناسبة، ويوفر لوحة لربط الحساب وضبط الإعدادات.

الميزات الرئيسية

• الاتصال بـWhatsApp عبر Baileys، مع حفظ بيانات المصادقة في MongoDB.
• إدارة المجموعات بأوامر منع الروابط ومكافحة الرسائل المزعجة والتحذير والقوائم السوداء.
• جدولة الرسائل والتنبيهات المتكررة باستخدام node-cron.
• تشغيل محادثات تعتمد على Gemini وإعداد اختيار النماذج داخل أوامر البوت.
• تمرير رسائل مختارة بين WhatsApp وTelegram عبر خدمة مخصصة.
• إنشاء الملصقات وتشغيل أوامر تحويل الصوت إلى نص والنص إلى صوت.
• حفظ سجلات الديون الشخصية وديون المجموعات في MongoDB.
• عرض رمز QR للربط ومعلومات النظام في لوحة مبنية باستخدام EJS.
• إرسال النصوص عبر مسار API محمي بمفتاح وصول.

البنية التقنية

يفتح تطبيق Node.js اتصال Baileys، ثم تمر الأحداث الواردة عبر الوسائط البرمجية وموجّه الأوامر. يحفظ Mongoose سجلات البوت وبيانات مصادقة WhatsApp في MongoDB. يقدم Express صفحات الإدارة ومسار الإرسال، ويحدّث Socket.IO واجهة الربط. يعرض EJS الصفحات من الخادم. تتولى node-cron المهام المجدولة، وتنفذ وحدات مستقلة اتصالات Telegram وخدمات الذكاء الاصطناعي. مسار API نقطة دخول موثقة لإرسال النصوص.

أبرز الجوانب الهندسية

• يحفظ موائم المصادقة مفاتيح Baileys وبيانات الجلسة في MongoDB بدل ملفات محلية.
• يجزئ وسيط API المفتاح المهيأ والمفتاح الوارد، ثم يقارن الناتجين بطول ثابت باستخدام timingSafeEqual.
• تفك أداة تعديل الرسائل بعض الأغلفة المشفرة باستخدام HKDF وAES-GCM.
• يستعيد المجدول المهام ويبلغ عن إخفاق إرسال الرسائل المجدولة.
• يحد وسيط المصادقة من تكرار تنبيهات Telegram عند رفض طلبات API.