🤖 WhatsApp Number Checker Bot

Professional WhatsApp Number Checker via Telegram Bot

بوت احترافي لفحص أرقام WhatsApp عبر Telegram

---

⚠️ PROJECT STATUS | حالة المشروع

🚧 INCOMPLETE PROJECT - UNDER DEVELOPMENT

مشروع غير مكتمل - قيد التطوير

This project is currently in development and NOT fully completed. Users who clone this repository may encounter the following issues:

هذا المشروع حالياً قيد التطوير ولم يكتمل بالكامل. المستخدمون الذين يستنسخون هذا المستودع قد يواجهون المشاكل التالية:

Known Issues | المشاكل المعروفة:

1. Configuration Required | يتطلب إعداد يدوي

   • Bot token and developer ID must be manually configured in bot.js
   • يجب إعداد توكن البوت ومعرف المطور يدوياً في ملف bot.js

2. No Environment Variables | لا يوجد متغيرات بيئة

   • Project doesn't use .env file yet (planned for future)
   • المشروع لا يستخدم ملف .env حالياً (مخطط للمستقبل)

3. Session Management | إدارة الجلسات

   • Sessions may accumulate and require manual cleanup
   • الجلسات قد تتراكم وتحتاج تنظيف يدوي
   • No automatic session cleanup implemented yet
   • لا يوجد تنظيف تلقائي للجلسات حتى الآن

4. Error Handling | معالجة الأخطاء

   • Some edge cases may not be properly handled
   • بعض الحالات الاستثنائية قد لا تُعالج بشكل صحيح
   • Bot may crash on unexpected errors
   • البوت قد يتوقف عند حدوث أخطاء غير متوقعة

5. Baileys Library Updates | تحديثات مكتبة Baileys

   • Baileys API changes frequently and may break compatibility
   • واجهة Baileys تتغير بشكل متكرر وقد تكسر التوافق
   • Regular updates required to maintain functionality
   • تحتاج تحديثات منتظمة للحفاظ على الوظائف

6. Rate Limiting | حدود المعدل

   • No rate limiting implemented for WhatsApp API calls
   • لا يوجد حد للمعدل لاستدعاءات WhatsApp API
   • May trigger WhatsApp anti-spam measures
   • قد يؤدي لتفعيل إجراءات WhatsApp ضد السبام

7. Multi-User Scalability | قابلية التوسع متعدد المستخدمين

   • Not tested with large number of concurrent users
   • لم يتم اختباره مع عدد كبير من المستخدمين المتزامنين
   • May have performance issues under heavy load
   • قد يواجه مشاكل أداء تحت الضغط الكبير

8. Documentation | التوثيق

   • Some features may not be fully documented
   • بعض المميزات قد لا تكون موثقة بالكامل
   • Advanced configuration options not explained
   • خيارات الإعداد المتقدمة غير موضحة

Recommendations | التوصيات:

• ✅ Use for testing and development purposes only
• ✅ استخدمه لأغراض الاختبار والتطوير فقط
• ✅ Monitor the bot closely when running
• ✅ راقب البوت عن كثب عند التشغيل
• ✅ Keep backups of session data
• ✅ احتفظ بنسخ احتياطية من بيانات الجلسات
• ✅ Check for updates regularly
• ✅ تحقق من التحديثات بانتظام
• ⚠️ NOT recommended for production use yet
• ⚠️ غير موصى به للاستخدام الإنتاجي حالياً

---

🌐 Language | اللغة

🇬🇧 English | 🇸🇦 العربية

---

🇬🇧 ENGLISH VERSION

✨ Features

• ✅ Multi-User Support - Each user has their own WhatsApp session
• ✅ Baileys Integration - Latest and most powerful WhatsApp library
• ✅ High Stability - No Puppeteer issues
• ✅ Fast Checking - 3 seconds per number instead of 5
• ✅ Lightweight - No Chrome/Chromium required
• ✅ Individual QR Codes - Each user gets their own QR
• ✅ Time-Limited QR - QR Code valid for 2 minutes
• ✅ Real-time Progress - Live updates during checking

📋 Requirements

• Node.js v16 or higher
• Telegram Bot Token (from @BotFather)
• Your Telegram User ID

🚀 Installation

1. Clone the Repository

git clone https://github.com/YOUR_USERNAME/whatsapp-checker-bot.git
cd whatsapp-checker-bot

2. Install Dependencies

npm install

3. Configure the Bot

Edit bot.js and add your credentials:

const TELEGRAM_TOKEN = 'YOUR_TELEGRAM_BOT_TOKEN';
const DEVELOPER_ID = YOUR_TELEGRAM_ID;

4. Run the Bot

Windows:

start.bat

Linux/Mac:

node bot.js

📖 Usage

1. Start the bot
2. Open the bot on Telegram
3. Click "ربط WhatsApp" (Connect WhatsApp)
4. Scan the QR Code
5. Click "فحص الأرقام" (Check Numbers)
6. Send numbers (one per line)

📝 Number Format

201234567890
966512345678
971501234567

Without + or spaces

🎯 How It Works

1. Connection: Each user connects their WhatsApp independently
2. Session Management: Sessions are stored in auth_info_baileys/user_CHATID
3. Number Checking: Uses Baileys onWhatsApp() method
4. Results: Returns active/inactive numbers with detailed status

🔒 Security

• Each user has isolated WhatsApp session
• QR Codes expire after 2 minutes
• No credentials stored in code
• Secure session management

📊 Admin Features

• View user statistics
• Monitor active connections
• Track total checks performed
• User management dashboard

🆚 Comparison with Old Version

Old Project	New Project
whatsapp-web.js	Baileys
Requires Puppeteer	No Puppeteer
Needs Chrome	No Chrome
Slow (5 sec/number)	Fast (3 sec/number)
Many issues	Stable
Single session	Multi-User

🛠️ Troubleshooting

QR Code Not Appearing

• Wait a few seconds
• Click "تجديد QR Code" (Refresh QR)
• Check internet connection

Connection Issues

• Restart the bot
• Delete session folder: auth_info_baileys/user_CHATID
• Try connecting again

Numbers Not Checking

• Ensure WhatsApp is connected
• Check number format (no + or spaces)
• Verify internet connection

📞 Support

Need help? Contact the developer:

• Telegram: @P_X_24
• Channel: Raven_xx24
• Group: Raven_26

---

🇸🇦 النسخة العربية

✨ المميزات

• ✅ دعم متعدد المستخدمين - كل مستخدم له جلسة WhatsApp منفصلة
• ✅ استخدام Baileys - أحدث وأقوى مكتبة WhatsApp
• ✅ استقرار عالي - لا يعاني من مشاكل Puppeteer
• ✅ فحص سريع - 3 ثواني لكل رقم بدلاً من 5
• ✅ خفيف الوزن - لا يحتاج Chrome/Chromium
• ✅ QR Code فردي - كل مستخدم له QR منفصل
• ✅ صلاحية محددة - QR Code صالح لمدة دقيقتين
• ✅ تحديثات فورية - متابعة مباشرة أثناء الفحص

📋 المتطلبات

• Node.js الإصدار 16 أو أحدث
• توكن بوت Telegram (من @BotFather)
• معرف Telegram الخاص بك

🚀 التثبيت

1. استنساخ المستودع

git clone https://github.com/YOUR_USERNAME/whatsapp-checker-bot.git
cd whatsapp-checker-bot

2. تثبيت المكتبات

npm install

3. إعداد البوت

عدل ملف bot.js وأضف بياناتك:

const TELEGRAM_TOKEN = 'YOUR_TELEGRAM_BOT_TOKEN';
const DEVELOPER_ID = YOUR_TELEGRAM_ID;

4. تشغيل البوت

Windows:

start.bat

Linux/Mac:

node bot.js

📖 طريقة الاستخدام

1. شغل البوت
2. افتح البوت على Telegram
3. اضغط "ربط WhatsApp"
4. اسكن QR Code
5. اضغط "فحص الأرقام"
6. أرسل الأرقام (رقم في كل سطر)

📝 صيغة الأرقام

201234567890
966512345678
971501234567

بدون + أو مسافات

🎯 كيف يعمل

1. الاتصال: كل مستخدم يربط WhatsApp الخاص به بشكل مستقل
2. إدارة الجلسات: الجلسات تُحفظ في auth_info_baileys/user_CHATID
3. فحص الأرقام: يستخدم طريقة onWhatsApp() من Baileys
4. النتائج: يعرض الأرقام النشطة/غير النشطة مع التفاصيل

🔒 الأمان

• كل مستخدم له جلسة WhatsApp معزولة
• QR Codes تنتهي صلاحيتها بعد دقيقتين
• لا يتم تخزين بيانات اعتماد في الكود
• إدارة آمنة للجلسات

📊 مميزات الأدمن

• عرض إحصائيات المستخدمين
• مراقبة الاتصالات النشطة
• تتبع إجمالي الفحوصات
• لوحة تحكم المستخدمين

🆚 المقارنة مع النسخة القديمة

المشروع القديم	المشروع الجديد
whatsapp-web.js	Baileys
يحتاج Puppeteer	لا يحتاج
يحتاج Chrome	لا يحتاج
بطيء (5 ثواني/رقم)	سريع (3 ثواني/رقم)
مشاكل كثيرة	مستقر
جلسة واحدة	Multi-User

🛠️ حل المشاكل

QR Code لا يظهر

• انتظر بضع ثوانٍ
• اضغط "تجديد QR Code"
• تحقق من اتصال الإنترنت

مشاكل الاتصال

• أعد تشغيل البوت
• احذف مجلد الجلسة: auth_info_baileys/user_CHATID
• حاول الاتصال مرة أخرى

الأرقام لا تُفحص

• تأكد من اتصال WhatsApp
• تحقق من صيغة الأرقام (بدون + أو مسافات)
• تحقق من اتصال الإنترنت

📞 الدعم

تحتاج مساعدة؟ تواصل مع المطور:

• تيليجرام: @P_X_24
• القناة: Raven_xx24
• المجموعة: Raven_26

---

📄 License | الترخيص

All Rights Reserved © 2026 ✘ 𝙍𝘼𝙑𝙀𝙉

جميع الحقوق محفوظة © 2026 ✘ 𝙍𝘼𝙑𝙀𝙉

---

⚠️ Disclaimer | إخلاء المسؤولية

English: This bot is for educational purposes only. Users are responsible for complying with WhatsApp's Terms of Service. The developer is not responsible for any misuse.

العربية: هذا البوت لأغراض تعليمية فقط. المستخدمون مسؤولون عن الامتثال لشروط خدمة WhatsApp. المطور غير مسؤول عن أي إساءة استخدام.

---

Made with ❤️ by ✘ 𝙍𝘼𝙑𝙀𝙉

صُنع بـ ❤️ بواسطة ✘ 𝙍𝘼𝙑𝙀𝙉