بدء سريع · n8n

تثبيت عقدة n8n لواتساب وإرسال أول رسالة

توجد الآن عقدة n8n مجتمعية مخصصة لـ Wasaas، منشورة على GitHub. لم تصل بعد إلى سجل عقد n8n المجتمعية (npm)، لذا تثبيتها اليوم يكون من المصدر مباشرة، وليس عبر بحث العقد داخل n8n.

الحالة: على GitHub، وليست على سجل npm بعد

الكود موجود ومكتمل في n8n-nodes-wasaas — عقدتان: Wasaas للإرسال والجلسات والتحقق من الأرقام، وWasaas Trigger مُعدّة لاستقبال أحداث مستقبلية. لم يُنشر الحزمة بعد على npm ولم تخضع لمراجعة n8n الرسمية للعقد المجتمعية، فلن تجدها اليوم في خانة بحث العقد داخل واجهة n8n — التثبيت يكون يدويًا من المستودع، كما بالأسفل. سيُحدَّث هذا القسم فور نشرها على npm.

١. ركّب العقدة من GitHub

لأي n8n ذاتي الاستضافة (self-hosted)، استنسخ المستودع وابنِه ثم اربطه بمجلد العقد المخصصة:

bash
git clone https://github.com/moatazkhaled93-prog/n8n-nodes-wasaas.git
cd n8n-nodes-wasaas
npm install
npm run build

# انسخ المخرجات إلى مجلد العقد المخصصة في n8n
mkdir -p ~/.n8n/custom
cp -r dist/* ~/.n8n/custom/

# أعد تشغيل n8n بعدها

أو استخدم npm link أثناء التطوير المحلي بدل النسخ اليدوي. التفاصيل الكاملة في قسم Installation بملف README الخاص بالمستودع.

٢. أضف بيانات اعتماد Wasaas في n8n

  1. أنشئ مفتاح API من لوحة تحكم Wasaas تحت مفاتيح API (يبدأ بـ wsa_).
  2. في n8n، أنشئ بيانات اعتماد من نوع Wasaas API: الصق المفتاح في حقل API Key، واترك Base URL على قيمته الافتراضية https://wasaas.org/api/v1 ما لم تُشغّل نسخة ذاتية الاستضافة.
  3. اضغط Test. العقدة تستدعي GET /sessions — استدعاء مجاني لا يستهلك حصة — فنجاحه يؤكد أن المفتاح صالح.

٣. أرسل أول رسالة

أضف عقدة Wasaas إلى التدفق، واختر Resource Message وOperation Send Text. الحقول المطلوبة: معرّف الجلسة (من عملية Session → List Sessions أو لوحة التحكم)، رقم المستلم بصيغة دولية بدون +، ونص الرسالة.

وهذا الطلب المكافئ الذي ترسله العقدة فعليًا خلف الكواليس:

bash
curl -X POST https://wasaas.org/api/v1/messages \
  -H "Authorization: Bearer wsa_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "session_id": "customer-5-1",
    "to": "966501234567",
    "message": "مرحبًا من تدفق n8n 👋"
  }'

حدود حقيقية

هذا ربط غير رسمي ومبني على الجلسات عبر رمز QR، وليس منصة واتساب الرسمية لمنتجات الأعمال. عقدة Wasaas Trigger المُضمّنة لا تستقبل شيئًا من Wasaas حتى اليوم — إرسال أحداث (webhooks) من Wasaas إلى رابط تتحكم فيه غير متاح حاليًا، فالتدفق يستطيع إرسال رسائل واتساب لكنه لا يستطيع البدء تلقائيًا عند وصول رسالة. أنواع الرسائل المدعومة هي النص والصورة والمستند فقط.

لا تريد تثبيت عقدة بعد؟

عقدة HTTP Request المدمجة في n8n تصل إلى نفس نقاط النهاية بدون تثبيت أي شيء — راجع دليل ربط واتساب مع n8n عبر HTTP Request للإعداد الكامل بهذه الطريقة.

إلى أين تذهب بعد ذلك

بدء سريع: عقدة n8n لواتساب | Wasaas