nodejs whatsapp api

وصف المشروع (Node.js WhatsApp API + Session)

الهدف

بناء خدمة Node.js تعمل كـ API للتكامل مع WhatsApp، بحيث:

يمكن للتطبيقات (مثل لوحة تحكم PHP) الاتصال بالـ API لإرسال رسائل WhatsApp من أرقام معيّنة.

يتم إنشاء وحفظ جلسات (Sessions) WhatsApp لكل رقم هاتف.

يتم توليد QR Code عند عدم وجود جلسة لتوثيق الرقم.

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

إدارة الجلسات (Sessions)

كل مستخدم/رقم هاتف يتم تخزينه بجلسة مستقلة.

عند انقطاع الجلسة أو تسجيل الخروج، يمكن إعادة توليد QR.

إرسال الرسائل (Messages)

Endpoint API لإرسال رسالة نصية من رقم مرتبط بجلسة.

التحقق من أن الجلسة مفعلة قبل الإرسال.

توليد QR Code

إذا لم يكن هناك جلسة محفوظة للرقم المطلوب، يتم إرجاع QR Code لتوثيق الرقم من خلال WhatsApp Web.

REST API Endpoints

POST /send-message

باراميترات: number, message

يعيد نجاح أو خطأ.

GET /qr/:sessionId

يعرض QR Code عند الحاجة.

POST /start-session

لإنشاء جلسة جديدة برقم معين.

التقنية المستخدمة

Node.js + Express.js: لبناء API.

whatsapp-web.js: للتعامل مع WhatsApp.

qrcode: لتوليد QR في شكل صورة Base64.

Session Store: يمكن تخزين الجلسات في ملف أو Redis/MySQL (اختياري).

مثال على سير العمل

المستخدم يسجل الدخول في PHP → يتم جلب user_id من الـ Session.

عند محاولة الإرسال:

PHP يرسل user_id, number, message إلى الـ Node.js API.

Node.js API يتحقق:

إذا كان عند الـ user_id جلسة → يرسل الرسالة مباشرة.

إذا لا يوجد جلسة → يرجع QR Code لتوثيق الرقم.

عند مسح QR → الجلسة تُحفظ وتستخدم لاحقًا.