تفاصيل العمل
admin.html
صفحة لوحة تحكم الأدمن → الأدمن يقدر:
يشوف الـ QR Code لعمل جلسة (session) جديدة.
يتابع حالة الاتصال.
يرسل رسائل واتساب من الرقم المرتبط.
client.html
واجهة للـ مستخدم عادي/عميل → يقدر يدخل يرسل رسالة عبر الـ API أو يتابع Session موجودة.
ممكن كمان تستعمل كـ Demo علشان توري إن الخدمة شغالة.
so-proud-notification.mp3
صوت تنبيه عند استلام رسالة واتساب جديدة.
(مثلاً زي إشعار واتساب الرسمي).
style.css
التنسيقات الخاصة بـ admin.html و client.html.
بتدي شكل أبسط للـ Dashboard.
️ .gitignore
مستبعد منه حاجات زي node_modules، ملفات الـ session اللي بتتولد أو أي أسرار (tokens).
app.js
ده هو قلب المشروع:
بيعمل import لـ Express.
يربط مكتبة whatsapp-web.js.
يعمل API Endpoints:
/start-session → يبدأ جلسة جديدة ويولّد QR.
/qr/:sessionId → يجيب QR للماسحة.
/send-message → يرسل رسالة واتساب.
يخدم (serve) الملفات الاستاتيكية من public.
يشغّل السيرفر.
package-lock.json
يوثّق نسخ المكتبات اللي مستخدمها المشروع (زي express, qrcode, whatsapp-web.js).
package.json
اسم المشروع (مثلاً: whatsapp-api).
الـ scripts (npm start, npm run dev).
الـ dependencies (express, whatsapp-web.js, qrcode, socket.io … إلخ).
الوصف العام
المشروع ده عبارة عن WhatsApp Web API Service يخلّي أي تطبيق خارجي (لوحة تحكم، CRM، أو موقع) يقدر:
يعمل جلسة WhatsApp عن طريق QR Code.
يرسل رسائل من رقم واتساب معيّن.
يستقبل رسائل ويرجع إشعارات (مع تشغيل صوت mp3).
عنده صفحتين واجهة (Admin + Client) علشان تجرب أو تدير الجلسات.