GuideinstagramOct 11, 20262 min read

دليل OpenWA — واتساب API مجاني ومفتوح المصدر

واجهة برمجة لواتساب بتركّبها على سيرفرك — بوتات وأتمتات وكذا رقم مع بعض، بدون وسيط وبدون اشتراك.

OpenWA واجهة برمجة (API) لواتساب مجانية ومفتوحة المصدر برخصة MIT. بتبعت وبتستقبل رسائل، بتبني بوتات وأتمتات، وبتشغّل كذا رقم مع بعض. الدليل: التركيب بـDocker، أفكار تبنيها، وتنبيهات مهمة عن خطر الحظر.

شو هو؟

واتساب API على سيرفرك

— شو هو؟

OpenWA
واجهة برمجة (API) لواتساب، مجانية ومفتوحة المصدر، بتركّبها على سيرفرك. بتبعت وبتستقبل رسائل، بتبني بوتات وأتمتات، وبتشغّل كذا رقم مع بعض، بدون وسيط وبدون اشتراك شهري.

OpenWA على GitHub

المصدر الرسمي. في نسخ كثيرة منسوخة (forks)، استعمل هالرابط بس.

github.com

موقع OpenWA

الموقع الرسمي للمشروع.

open-wa.org

شو بيعطيك

المزايا الأساسية

إرسال واستقبال رسائل وملفات بالوقت الحقيقي (Webhooks)
عدة أرقام واتساب على نفس السيرفر بنفس الوقت
لوحة تحكم جاهزة لإدارة الجلسات والـWebhooks ومفاتيح الـAPI
توثيق API جاهز (Swagger)
مكتبات جاهزة لـJavaScript/TypeScript وPython وPHP، وربط مع n8n للأتمتة بدون كود
رخصة MIT، يعني مجاني حتى للاستخدام التجاري

شو بتحتاج

تلات أشياء

سيرفر (VPS) بسيط، أو جهازك للتجربة
Docker منزّل عليه
رقم واتساب مخصص للبوت (يفضّل مش رقمك الشخصي)

التركيب السريع

من التنزيل لأول جلسة

Step 1

نزّل المشروع

استنسخ المستودع وادخل عليه. بعدين اتبع تعليمات Docker الموجودة بالـREADME (فيه ملفات Docker جاهزة) وشغّل المشروع.

git clone https://github.com/rmyndharis/OpenWA.git
cd OpenWA
docker compose -f docker-compose.dev.yml up -d

Step 2

اربط رقمك

افتح لوحة التحكم، أنشئ جلسة جديدة، وامسح كود الـQR من واتساب على الموبايل (الأجهزة المرتبطة). توثيق الـAPI بيكون على المسار /api/docs.

العناوين الافتراضية (البورت 2785)

“لوحة التحكم على localhost:2785، والـAPI على localhost:2785/api، والـSwagger على localhost:2785/api/docs.”

الطريقة الأسهل

خلّي Claude يركّبه عنك

برومبت التركيب

افتح المستودع بـClaude Code وانسخ هالجملة.

ساعدني أركّب OpenWA على سيرفري بـDocker خطوة بخطوة، وأربط رقم واتساب

أفكار تبنيها فيه

من بسيط لمتقدم

بوت دعم فني بيرد على أسئلة العملاء المتكررة
تذكيرات تلقائية لمواعيد أو فواتير
ربط مع n8n: كل طلب جديد بمتجرك بيوصل كرسالة واتساب
رد ذكي بالذكاء الاصطناعي: الرسالة بتروح لـClaude أو ChatGPT والرد بيرجع على واتساب

انتبه

قبل ما تربط رقمك

— انتبه

المشروع غير رسمي
OpenWA مش API رسمي من Meta، بيتصل بواتساب عبر مكتبات معمولة بالهندسة العكسية. فدايماً في احتمال إنه الرقم يتقيّد أو ينحظر، حتى لو استعملته بشكل عادي. للأشياء الحساسة أو اللي بتجيب دخل، احتفظ بطريقة بديلة رسمية (واتساب Cloud API الرسمي أو SMS أو إيميل).
لا تبعت رسائل جماعية مزعجة
واتساب ممكن يحظر الأرقام اللي بتبعت spam. استعمله للرد على اللي بيراسلوك، أو بشكل معقول.
النسخ الاحتياطي
اعمل نسخة احتياطية لبيانات الجلسات، وخصوصاً إذا بتستعمل تخزين S3.