واجهة WhatsApp للقنوات والمحادثات

هذا مشروع مفتوح المصدر بترخيص MIT، يقدّم API ذاتية الاستضافة للمطورين الذين يريدون إرسال منشورات إلى قنوات WhatsApp أو رسائل إلى محادثات خاصة من خوادمهم. يصل Baileys الحساب بالخدمة، وتتيح المسارات اكتشاف القنوات وفحص الدور وتحديد المستلم وإرسال النصوص والوسائط.

المشكلة

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

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

• اكتشاف القنوات المشترك فيها الحساب المتصل.
• تحديد القناة من المعرفات المدعومة والتحقق من دور الحساب فيها.
• نشر النصوص والوسائط بعد التأكد من حق النشر.
• تحديد مستلمي المحادثات الخاصة وإرسال النصوص أو الملفات إليهم.
• إنشاء صور مصغرة وبيانات وصفية للصوت والفيديو عند الحاجة.
• طلب مفتاح Idempotency-Key لعمليات الإرسال وإعادة النتيجة المحفوظة عند تكرار الطلب.
• تنظيم الإرسال في طابور محدود السعة مع فاصل بين الرسائل.
• توفير مسارات فحص صحي تعرض حالة اتصال WhatsApp.

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

يستقبل Express طلبات HTTP، ثم يطبق مصادقة مفتاح API وحدود الطلبات وفحص الملفات والتحقق من المدخلات. يدير Baileys اتصال WhatsApp. تحفظ SQLite المدمجة في Node.js بيانات الجلسة وسجلًا مستقلًا لمنع تكرار الطلبات، مع تشغيل نمط WAL. ينظم طابور داخل العملية تسليم الرسائل. يستقبل Multer الملفات، وتفحص file-type توقيعها، وتجهز sharp وأدوات الوسائط المعاينات. تستخدم وسائط القنوات مسار رفع وإرسال خاصًا يضبط بيانات الوسائط المطلوبة.

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

• تحجز معاملات SQLite مفتاح منع التكرار وتثبت النتيجة؛ وتشترك الطلبات المتزامنة في النتيجة الجارية.
• تعيد الخدمة فحص حق النشر داخل طابور الإرسال، قبل تسليم رسالة القناة مباشرة.
• تقارن مفاتيح API بعد تجزئتها باستخدام timingSafeEqual.
• تتحقق من محتوى ملفات الوسائط وتقيّد الوصول إلى الملفات المؤقتة.
• ترفع API وسائط القنوات بنفسها وتضيف خاصية mediatype المطلوبة في نشرات WhatsApp، لتُنشر الصور ومقاطع الفيديو والرسائل الصوتية في القنوات بصورة صحيحة.