عميل WhatsApp API الذي يتصل عبر تطبيق متصفح WhatsApp Web
تعمل المكتبة من خلال تشغيل تطبيق متصفح WhatsApp Web وإدارته باستخدام Puppeteer لإنشاء نسخة من WhatsApp Web، وبالتالي التخفيف من مخاطر الحظر. يتصل عميل WhatsApp API من خلال تطبيق متصفح WhatsApp Web، ويصل إلى وظائفه الداخلية. ويمنحك هذا الوصول إلى جميع الميزات المتوفرة على WhatsApp Web تقريبًا، مما يتيح لك التعامل الديناميكي المماثل لأي تطبيق Node.js آخر.
مهم
ليس من المضمون أنه لن يتم حظرك باستخدام هذه الطريقة. لا يسمح تطبيق WhatsApp بالروبوتات أو العملاء غير الرسميين على نظامهم الأساسي، لذلك لا ينبغي اعتبار هذا آمنًا تمامًا.
الوحدة متاحة الآن على npm! npm i whatsapp-web.js
ملحوظة
العقدة v18+
مطلوبة.
ما عليك سوى الحصول على أحدث LTS من موقع العقدة الرسمي.
sudo npm install - g n
sudo n stable
choco install nodejs - lts
winget install OpenJS.NodeJS.LTS
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash - &&
sudo apt-get install -y nodejs
const { Client } = require ( 'whatsapp-web.js' ) ;
const client = new Client ( ) ;
client . on ( 'qr' , ( qr ) => {
// Generate and scan this code with your phone
console . log ( 'QR RECEIVED' , qr ) ;
} ) ;
client . on ( 'ready' , ( ) => {
console . log ( 'Client is ready!' ) ;
} ) ;
client . on ( 'message' , msg => {
if ( msg . body == '!ping' ) {
msg . reply ( 'pong' ) ;
}
} ) ;
client . initialize ( ) ;
قم بإلقاء نظرة على example.js للحصول على أمثلة أخرى مع حالات استخدام إضافية.
لمزيد من التفاصيل حول حفظ الجلسات واستعادتها، استكشف استراتيجيات المصادقة المتوفرة.
ميزة | حالة |
---|---|
جهاز متعدد | ✅ |
إرسال الرسائل | ✅ |
تلقي الرسائل | ✅ |
إرسال الوسائط (الصور/الصوت/المستندات) | ✅ |
إرسال الوسائط (فيديو) | ✅ (يتطلب جوجل كروم) |
إرسال الملصقات | ✅ |
تلقي الوسائط (الصور/الصوت/الفيديو/المستندات) | ✅ |
إرسال بطاقات الاتصال | ✅ |
إرسال الموقع | ✅ |
إرسال الأزرار | ❌ (موقوف) |
إرسال القوائم | ❌ (موقوف) |
تلقي الموقع | ✅ |
ردود الرسالة | ✅ |
الانضمام إلى المجموعات عن طريق الدعوة | ✅ |
الحصول على دعوة للمجموعة | ✅ |
تعديل معلومات المجموعة (الموضوع والوصف) | ✅ |
تعديل إعدادات المجموعة (إرسال الرسائل، تعديل المعلومات) | ✅ |
إضافة مشاركين في المجموعة | ✅ |
المشاركون في مجموعة الركلة | ✅ |
ترقية/خفض مستوى المشاركين في المجموعة | ✅ |
اذكر المستخدمين | ✅ |
أذكر المجموعات | ✅ |
كتم/إلغاء كتم صوت الدردشات | ✅ |
حظر/إلغاء حظر جهات الاتصال | ✅ |
الحصول على معلومات الاتصال | ✅ |
الحصول على صور الملف الشخصي | ✅ |
ضبط رسالة حالة المستخدم | ✅ |
الرد على الرسائل | ✅ |
إنشاء استطلاعات الرأي | ✅ |
التصويت في صناديق الاقتراع | |
المجتمعات | |
القنوات |
شيء مفقود؟ اصنع مشكلة وأخبرنا!
لا تتردد في فتح طلبات السحب؛ نحن نرحب بالمساهمات! ومع ذلك، بالنسبة للتغييرات المهمة، فمن الأفضل فتح مشكلة مسبقًا. تأكد من مراجعة إرشادات المساهمة الخاصة بنا قبل إنشاء طلب سحب. قبل إنشاء مشكلتك الخاصة أو طلب السحب، تحقق دائمًا لمعرفة ما إذا كان هناك طلب موجود بالفعل!
يمكنك دعم القائم على هذا المشروع من خلال الروابط أدناه
هذا المشروع ليس تابعًا أو مرتبطًا أو مصرحًا به أو معتمدًا أو مرتبطًا رسميًا بأي شكل من الأشكال بـ WhatsApp أو أي من الشركات التابعة لها أو الشركات التابعة لها. يمكن العثور على موقع WhatsApp الرسمي على whatsapp.com. "WhatsApp" بالإضافة إلى الأسماء والعلامات والشعارات والصور ذات الصلة هي علامات تجارية مسجلة لأصحابها. كما أنه ليس مضمونًا أنه لن يتم حظرك باستخدام هذه الطريقة. لا يسمح تطبيق WhatsApp بالروبوتات أو العملاء غير الرسميين على نظامهم الأساسي، لذلك لا ينبغي اعتبار هذا آمنًا تمامًا.
حقوق الطبع والنشر 2019 بيدرو إس لوبيز
مرخص بموجب ترخيص Apache، الإصدار 2.0 ("الترخيص")؛
لا يجوز لك استخدام هذا المشروع إلا وفقًا للترخيص.
يمكنك الحصول على نسخة من الترخيص على http://www.apache.org/licenses/LICENSE-2.0.
ما لم يكن ذلك مطلوبًا بموجب القانون المعمول به أو تم الاتفاق عليه كتابيًا، البرمجيات
الموزعة بموجب الترخيص يتم توزيعها على أساس "كما هي"،
دون ضمانات أو شروط من أي نوع، سواء كانت صريحة أو ضمنية.
راجع الترخيص لمعرفة الأذونات التي تحكم اللغة المحددة و
القيود بموجب الترخيص.