دليل كامل خطوة بخطوة لتثبيت عقدة (Node) Wawp عبر npm وربط بيانات اعتماد الجلسة داخل حساب n8n الخاص بك.
4 دقائق للقراءة·تم التحديث في ١٨ مايو ٢٠٢٦
هل أنت مستعد لفتح إمكانيات الأتمتة القوية لتواصلك عبر واتساب؟ الخطوة الأولى هي تثبيت عقدة مجتمع Wawp (Community Node) على منصة n8n وربط حساب Wawp الخاص بك. سيرشدك هذا الدليل خطوة بخطوة خلال العملية بأكملها، بدءاً من التثبيت وحتى بناء وربط أول سير عمل أتمتة لك.
المتطلبات الأساسية
قبل أن تبدأ، تأكد من توفر هذه المتطلبات المسبقة لديك:
n8n بنسخة سحابية أو مستضافة ذاتياً: تتطلب أداة تشغيل الويب هوك (Webhook Trigger) الخاصة بـ Wawp وجود رابط URL متاح بشكل عام وآمن للإنترنت، وهي ميزة متوفرة في نسخة n8n Cloud أو السيرفرات الخاصة العامة. يمكنك بدء تجربة مجانية من هنا.
حساب Wawp مع رقم متصل: تحتاج إلى جلسة (رقم) نشطة في Wawp مرتبطة برقم واتساب الفعلي الخاص بك. إذا لم تقم بهذه الخطوة بعد، فيرجى مراجعة دليلنا حول كيفية ربط رقم واتساب الخاص بك بـ Wawp.
لمستخدمي الاستضافة الذاتية (Self-Hosted n8n): إذا كنت تشغل n8n على خادمك الخاص (Docker، VM، إلخ)، فإن خيار تثبيت العقد المجتمعية يكون معطلاً بشكل افتراضي. لتفعيله وتثبيت العقدة، يجب عليك إضافة المتغير البيئي التالي إلى تهيئة خادم n8n الخاص بك قبل البدء:
N8N_COMMUNITY_PACKAGES_ENABLED=true
الخطوة 1: تثبيت عقدة مجتمع Wawp
عقدة Wawp متاحة رسمياً كحزمة يقدمها مجتمع المطورين (Community Node). إليك طريقة تثبيتها في نسخة n8n الخاصة بك ببساطة:
1
الذهاب للإعدادات من لوحة تحكم n8n الرئيسية، توجه إلى زر الإعدادات Settings الموجود في الزاوية اليسرى السفلية.
2
عقد المجتمع اختر تبويب Community nodes من القائمة الجانبية.
3
بدء التثبيت انقر فوق الزر الأخضر المسمى Install لبدء إضافة حزمة جديدة.
4
إدخال اسم الحزمة في حقل npm Package Name، قم بنسخ ولصق النص التالي بالضبط: @wawp/n8n-nodes-wawp
5
تأكيد التثبيت انقر فوق الزر Install مرة أخرى لتأكيد التحميل والانتظار لثوانٍ حتى اكتمال التثبيت.
مثبت عقد مجتمع n8n
واجهة إعدادات n8n لتثبيت العقد التي يقدمها المجتمع عبر أسماء حزم npm.
Keywords: عقد مجتمع n8n, تثبيت حزمة npm, تثبيت عقدة wawp
🎉 ممتاز! تم الآن تثبيت العقدة بنجاح. يمكنك العثور عليها في أي وقت من خلال البحث عن كلمة "Wawp" في قائمة سحب وإضافة العقد الجديدة داخل مساحة العمل.
الخطوة 2: ربط بيانات اعتماد حساب Wawp الخاص بك
الآن بعد التثبيت، تحتاج لتعريف n8n بحسابك الشخصي في Wawp عبر مفتاح الـ API و الـ Instance ID.
1
فتح لوحة تحكم Wawp افتح حسابك في Wawp في تبويب متصفح جديد لتتمكن من نسخ بيانات الاعتماد الخاصة بك.
2
إضافة العقدة في n8n داخل مساحة عمل n8n، قم بسحب عقدة Wawp Main Action وإلقائها داخل المشروع.
3
إضافة بيانات جديدة اضغط مرتين على العقدة لفتح إعداداتها، ثم اختر من خيار Credentials الأمر Create New.
4
نسخ المعرفات قم بنسخ API Key وأيضاً Instance ID الخاص بجلسة واتساب الخاصة بك من لوحة تحكم Wawp.
5
لصق التفاصيل الصق هذه البيانات في الخانات المقابلة لها بدقة داخل نافذة الـ credentials في n8n.
6
حفظ والانتهاء أعطِ هذه البيانات اسماً تذكره (مثل: Wawp Main) ثم اضغط على Save ليتم حفظ المفتاح الآمن واستخدامه دائماً.
إعداد بيانات اعتماد Wawp
الواجهة الآمنة في n8n لربط مفتاح API و Instance ID الخاص بـ Wawp بالعقدة المثبتة.
Keywords: بيانات اعتماد n8n, ربط مفتاح api, تفويض آمن
🔑 تلميح المطورين - أين تجد بيانات الاعتماد الخاصة بك؟
معرف الرقم (Instance ID): اذهب إلى لوحة تحكم Wawp. ستجد الـ Instance ID معروضاً بوضوح مباشرة على بطاقة رقم هاتف واتساب النشط المربوط الخاص بك.
مفتاح الـ API (Access Token): هو مفتاح العبور الآمن الخاص بك. يمكنك العثور عليه مدرجاً بجوار الـ Instance ID مباشرة على بطاقة رقمك النشط، أو تحت إعدادات الأمان في ملفك الشخصي على Wawp.
🔒 تنبيه أمني هام: يمنح مفتاح الـ API (أو رمز الوصول) صلاحيات كاملة لإرسال وإدارة الرسائل من خلال رقم واتساب الخاص بك. احرص على عدم مشاركته مع أي شخص، أو نشره في المنتديات العامة، أو رفعه على مستودعات الأكواد المفتوحة (مثل GitHub).
استكشاف وحل المشكلات الشائعة
هل واجهتك صعوبة في الإعداد؟ إليك الحلول لأكثر المشاكل تكراراً:
عقدة Wawp لا تظهر في البحث: إذا لم تجد العقدة بعد التثبيت الناجح، فتأكد أنك قمت بكتابة اسم حزمة الـ npm بشكل كامل وصحيح متضمناً علامة @. قد يتطلب الأمر أيضاً إعادة تنشيط (Refresh) لصفحة متصفحك.
فشل في الاتصال بالـ API: راجع مفتاح الـ API والـ Instance ID وتأكد من عدم وجود مسافات فارغة تم نسخها بالخطأ قبل أو بعد الرمز. تأكد كذلك من أن الرقم الخاص بك نشط ويظهر باللون الأخضر (Connected) داخل لوحة تحكم Wawp.
🚀 الخطوات التالية لبناء البوت الأول الخاص بك
الآن بعد أن قمت بتثبيت عقدة مجتمع Wawp وتوثيق حسابك بنجاح، أنت جاهز تماماً لبناء وإطلاق مسارات العمل الخاصة بك:
