تكامل n8n

أرسل رسائل WhatsApp من مسارات عمل n8n الخاصة بك. مثلًا، راسل عميلًا محتملًا جديدًا من webhook، أو أكّد طلبًا من متجرك، أو أرسل تنبيهًا عند فشل فحص ما.

هناك طريقتان للربط:

• عقدة Wbiztool المجتمعية (n8n-nodes-wbiztool): عقد جاهزة تحتوي على حقول لكل خيار.
• عقدة HTTP Request المدمجة: تعمل على أي نسخة من n8n وتمنحك الوصول إلى كل نقاط نهاية API. راجع استخدام عقدة HTTP Request.

قبل أن تبدأ#

• حساب Wbiztool مع رقم WhatsApp متصل في WhatsApp settings (إعدادات WhatsApp).
• Client ID (معرّف العميل) وAPI key (مفتاح API) من Settings → API keys (الإعدادات ← مفاتيح API).
• WhatsApp Client ID (معرّف عميل WhatsApp) للرقم الذي سترسل منه، ويظهر في WhatsApp settings.

ثبّت العقدة المجتمعية#

1. افتح العقد المجتمعية

   في n8n، انتقل إلى Settings → Community Nodes وانقر على Install.

2. أدخل اسم الحزمة

   أدخل n8n-nodes-wbiztool، وأكّد وثبّت. أعد تشغيل n8n إذا لم تظهر العقد.

في النسخة المستضافة ذاتيًا يمكنك أيضًا تثبيتها باستخدام npm في مجلد العقد المخصصة في n8n:

npm install n8n-nodes-wbiztool

أنشئ بيانات الاعتماد#

أضف بيانات اعتماد جديدة من النوع WbizTool API:

عند الحفظ، يختبر n8n بيانات الاعتماد مقابل التحقق من بيانات الاعتماد.

العقد#

تضيف الحزمة هذه العقد. تستدعي كل منها نقطة نهاية في Wbiztool API وتُخرج استجابة API.

WbizTool Send Message#

تُخرج العقدة messageId (قيمة msg_id من API). احفظه إذا أردت التحقق من الحالة أو إلغاء الرسالة لاحقًا.

مثال على مسار عمل#

1. تستقبل عقدة Webhook عميلًا محتملًا جديدًا مع phone وname.
2. WbizTool Send Message: اضبط Phone Number على {{ $json.phone }} وMessage Text على Hi {{ $json.name }}, thanks for signing up!.
3. عقدة IF: تحقق من أن {{ $json.messageId }} ليس فارغًا للمتابعة إلى الخطوة التالية، مثل تحديث نظام CRM.

تُخرج WbizTool Send Message الناجحة عنصرًا مثل هذا:

{
  "success": true,
  "messageId": 9817263,
  "status": 1,
  "message": "Created",
  "response": { "status": 1, "message": "Created", "msg_id": 9817263 }
}

يتضمن العنصر أيضًا كائن input بالقيم التي أرسلتها العقدة. إذا أرجعت API خطأ، تتوقف العقدة وتعرض message الخاصة بـ API. فعّل Continue On Fail للحصول على عنصر يحتوي على success: false ونص error بدلًا من ذلك.

مع WbizTool WhatsApp Client Status، استخدم طريقة الفحص General Status. تُرجع طريقة Status by ID خطأ لكل رقم بسبب علّة في نقطة النهاية تلك في API. مع General Status، يوقف الرقم غير المتصل العقدة أيضًا بخطأ Disconnected، لذا فعّل إعداد Continue On Fail في العقدة إذا أردت التفرّع بناءً على النتيجة.

استخدام عقدة HTTP Request#

أضف عقدة HTTP Request واضبطها هكذا:

ثم الصق جسمًا مثل هذا واربط القيم من العقد السابقة باستخدام التعبيرات:

{
  "client_id": 12345,
  "api_key": "YOUR_API_KEY",
  "whatsapp_client": 678,
  "msg_type": 0,
  "country_code": "91",
  "phone": "{{ $json.phone }}",
  "msg": "Hi {{ $json.name }}, thanks for signing up!"
}

يُرجع الاستدعاء الناجح {"status": 1, "message": "Created", "msg_id": 9817263}. كل الحقول ورسائل الخطأ موجودة في إرسال رسالة.

لاستدعاء نقاط نهاية أخرى، غيّر الرابط وجسم الطلب. مثلًا، لجدولة رسالة استخدم https://wbiztool.com/api/v1/schedule_msg/ وأضف date بالصيغة DD/MM/YYYY، وtime بالصيغة HH:MM وtimezone. راجع جدولة رسالة.

لإرسال الرسالة نفسها إلى عدة أرقام أو مجموعات في استدعاء واحد، استخدم https://wbiztool.com/api/v1/send_msg/multi/ وضع المستلمين في phone كسلسلة نصية واحدة مفصولة بفواصل. راجع الإرسال إلى عدة أرقام.

{
  "client_id": 12345,
  "api_key": "YOUR_API_KEY",
  "whatsapp_client": 678,
  "msg_type": 1,
  "country_code": "91",
  "phone": "{{ $json.phones }}",
  "img_url": "https://example.com/offers/diwali-sale.jpg",
  "msg": "Our Diwali sale starts tomorrow!"
}

لا تضع إلا أرقامًا في كل رقم هاتف. أي قيمة ليست عددًا صحيحًا، مثل 98765 43210، تُرسل كاسم مجموعة.

تعمل تعبيرات n8n داخل أي حقل نصي. مثلًا، تحية تعتمد على وقت اليوم، أو نص يعتمد على إجمالي الطلب:

{
  "msg": "Good {{ $now.hour < 12 ? 'morning' : 'evening' }} {{ $json.name }}, your order total is {{ $json.total }}.{{ $json.total > 1000 ? ' Delivery is free.' : '' }}"
}

يستخدم $now المنطقة الزمنية لمسار العمل (Workflow settings → Timezone)، لذا اضبطها لتحديد متى ينتهي «الصباح».

تلقَّ إشعارًا عند إرسال رسالة#

1. أنشئ مسار عمل webhook

   أضف عقدة Webhook بطريقة HTTP ‏POST وانسخ رابط الإنتاج الخاص بها.

2. مرّر الرابط عند الإرسال

   ضع ذلك الرابط في خيار Webhook URL في العقدة، أو في الحقل webhook في جسم طلب HTTP.

3. اقرأ النتيجة

   تستدعي Wbiztool الرابط بمجرد إرسال الرسالة أو فشلها. الجسم مرمّز كنموذج (form-encoded) ولا يحتوي إلا على msg_id وstatus، وقيمته SENT أو FAILED.

راجع Webhook لمعرفة إعادة المحاولات والمهل الزمنية.

استكشاف الأخطاء وإصلاحها#