تكامل WOZTELL وn8n: كيفية الاتصال وأتمتة سير العمل

تكامل n8n

في هذا المقال ستتعلم كيفية ربط WOZTELL مع n8n باستخدام حزمة العقد الرسمية (Community Node). تتيح لك هذه التكاملات أتمتة العمليات وربط قنوات الاتصال الخاصة بك (WhatsApp، Messenger، Instagram، Webchat) مع تطبيقات وخدمات أخرى، دون الحاجة إلى تطوير مخصص.
​
مع n8n يمكنك إنشاء تدفقات عمل مثل:

  • حفظ كل عميل (lead) جديد من WhatsApp في Google Sheets.

  • إرسال رسالة تلقائية عندما يتغير وضع سجل في نظام CRM.

  • إعادة توجيه مستخدم داخل بوت WOZTELL بناءً على شروط محددة.

ملاحظات

ملاحظة: هذه الإضافة متاحة حالياً ضمن برنامج الوصول المبكر (EAP) الخاص بـ n8n WOZTELL. لا ينبغي استخدامها في بيئات الإنتاج أو مع بيانات حساسة.



ما هو n8n

n8n هو أداة مفتوحة المصدر لأتمتة سير العمل، تتيح لك ربط التطبيقات والخدمات وقواعد البيانات من خلال واجهة مرئية. وبفضل منهجية "الرمز القليل" (low-code)، يمكنك إنشاء تكاملات معقدة دون الحاجة إلى كتابة الكود من الصفر. كما يوفر إمكانية الاستضافة الذاتية، مما يمنحك مزيدًا من التحكم في بياناتك وعملياتك.
n8n مثالي للشركات التي تسعى لأتمتة المهام المتكررة، وتحسين الكفاءة التشغيلية، وربط منصات مثل WOZTELL، أنظمة CRM، جداول البيانات، أدوات التسويق وغيرها الكثير.

أهم مميزات استخدام n8n مع WOZTELL

  • أتمتة بدون كود: أنشئ سير عمل مرئي دون الحاجة إلى معرفة بالبرمجة.

  • المرونة: يمكنك ربط WOZTELL مع أي نظام أو واجهة API متوافقة مع n8n.

  • توفير الوقت: أتمت المهام المتكررة مثل جمع العملاء المحتملين أو متابعة العملاء.

  • قابلية التوسع: وسّع منطق الأتمتة بسهولة مع نمو عملك.

  • التحكم في البيانات: يمكنك تشغيل n8n على البنية التحتية الخاصة بك للحفاظ على الخصوصية والامتثال.


المتطلبات

قبل البدء، تأكد من توفر ما يلي:

  • حساب WOZTELL نشط.

  • وجود قناة واحدة على الأقل متصلة (WhatsApp Cloud API، Messenger، Instagram أو Webchat).

  • الوصول إلى مثيل n8n (سحابي أو مستضاف ذاتيًا).

  • صلاحيات مسؤول في WOZTELL لإنشاء رمز وصول (Access Token).


تثبيت الحزمة

لتثبيت حزمة عقد WOZTELL المجتمعية في n8n:

Info N8N + WOZTELL  يمكنك الوصول مباشرةً إلى https://www.npmjs.com/package/@woztell-sanuker/n8n-nodes-woztell-sanuker-eap

1. سجّل الدخول إلى n8n باستخدام حساب إداري.

2. اذهب إلى Settings > Community Nodes.

3. اضغط على Install.

4. انسخ والصق اسم الحزمة التالي: @woztell-sanuker/n8n-nodes-woztell-sanuker.



5. اضغط على Install. سيقوم n8n بتنزيل الحزمة وإتاحة العقد للاستخدام.

لمزيد من المعلومات، اطلع على دليل تثبيت عقد المجتمع في n8n.


إعداد بيانات الاعتماد

قبل استخدام الإضافة، تحتاج إلى الحصول على بيانات اعتماد API من منصة WOZTELL. تعمل هذه البيانات كمفاتيح مصادقة للوصول إلى WOZTELL Product API. تأكد من تفعيل الصلاحيات المطلوبة لحالتك واستخدام هذه البيانات في تكوين الاعتماد داخل n8n.

1. في n8n، انتقل إلى Credentials وابحث عن WOZTELL.




2. سجّل الدخول إلى حسابك في WOZTELL واذهب إلى Access Tokens.

3. فعّل الأذونات التالية:
  1. channel:list
  2. botapi:sendResponses
  3. bot:redirectMemberToNode
4. أنشئ رمز وصول جديد (Access Token).



5. انسخ الرمز وأضفه إلى بيانات اعتماد WOZTELL في n8n.


لمزيد من التفاصيل، اطلع على دليل رموز الوصول الخاصة بـ WOZTELL.

رمز واجهة برمجة التطبيقات للقناة الخاصة بقوالب WhatsApp: كل قناة في WOZTELL لها رمز API خاص بها يُستخدم في إرسال رسائل WhatsApp باستخدام القوالب. أدخل هذا الرمز في الحقل الثاني لرمز WOZTELL داخل الاعتماد. نوصي بإنشاء بيانات اعتماد منفصلة لكل قناة. مزيد من المعلومات: واجهة API العامة لـ WhatsApp Cloud.


إنشاء أول سير عمل لك

1. افتح لوحة Workflows في n8n.

2. أنشئ سير عمل جديد.

3. ابحث عن WOZTELL في لوحة العقد.

4. اسحب عقدة WOZTELL وأسقطها في سير العمل.
​
مثال: أنشئ تدفقًا يقوم بحفظ كل رسالة واردة من WhatsApp في Google Sheets ويرسل ردًا تلقائيًا.

المحفزات والعُقد

نظرة عامة

عند البحث عن "WOZTELL" في الشريط الجانبي، ستجد العُقد والمحفزات المتاحة. يمكنك سحبها وإفلاتها داخل سير العمل.

  • Triggers (المحفزات): تتلقى بيانات Webhook من قنوات WOZTELL.

  • Bot API Actions: إرسال رسائل وتنفيذ عمليات عبر WOZTELL.

  • Member Actions: إدارة معلومات جهات الاتصال (الاستعلام، التحديث، الوسم) المخزنة في WOZTELL.


Webhook: عند استلام رسالة من WOZTELL

يستقبل هذا المحفز رسائل Webhook من أي قناة WOZTELL، بما في ذلك الرسائل الواردة، الصادرة، وأحداث تحديث العضو. يتم تسليم الرسائل بتنسيق JSON مع تفاصيل الحدث.

يمكنك تكوين مسار Webhook وتصفية النتائج حسب معرّف القناة أو نوع الحدث.


لمزيد من المعلومات: وثائق Webhooks الخاصة بـ WOZTELL.

العقدة: إرسال الرد

ترسل هذه العقدة رسالة من رقم WhatsApp Business الخاص بك إلى حساب العميل عبر BotAPI الخاص بـ WOZTELL. يتم تحديد محتوى الرسالة مباشرةً ضمن بيانات Response.

بمجرد إرسال الرسالة، تكون استجابة API متاحة للعُقد التالية من أجل مواصلة المعالجة.

لمزيد من المعلومات: مرجع API لإرسال الردود.


العقدة: إعادة توجيه العضو إلى عقدة

تُستخدم هذه العقدة الخاصة لتحويل مسار التدفق الحالي إلى نقطة معينة داخل شجرة روبوت المحادثة (Chatbot Tree) الخاصة بك في WOZTELL.

بدلاً من إنشاء حمولة JSON يدويًا لإرسال رسائل WhatsApp أو تشغيل التدفقات، يمكنك ببساطة استخدام هذه العقدة وإدخال بعض المعلمات الأساسية. يقوم روبوت WOZTELL بمعالجة المنطق تلقائيًا.

تعمل هذه العقدة كمؤشر — حيث تُعيد التحكم إلى البنية الحالية لروبوت المحادثة ليتولى تنفيذ الخطوات التالية.

مثالية للمستخدمين الذين يدمجون n8n مع روبوتات WOZTELL.

لمزيد من المعلومات: مرجع API: إعادة توجيه العضو إلى عقدة.


العقدة: إرسال رسالة قالب WhatsApp

وفقًا لقواعد المراسلة الرسمية من WhatsApp، إذا كنت ترغب في التواصل مع مستخدم خارج جلسة الـ 24 ساعة — أو مع شخص لم يسبق له التواصل معك — يجب عليك استخدام رسالة قالب (Template Message) معتمدة مسبقًا.

تُبسط هذه العقدة في n8n العملية. بدلاً من إنشاء الرسالة يدويًا، تتيح لك اختيار قالب معتمد مسبقًا وملء الحقول المطلوبة. يتم إنشاء الرسالة تلقائيًا وإرسالها بالتنسيق الصحيح.

مزيد من المعلومات:
العقدة: الحصول على الأعضاء حسب الوسوم

تُستخدم هذه العقدة لاسترجاع جهات الاتصال من قناة معينة استنادًا إلى وسم أو أكثر. وتستند إلى نقطة النهاية "الحصول على معلومات العضو" في WOZTELL Open API.

يعيد كل استعلام ما يصل إلى 100 سجل. إذا تجاوز عدد النتائج هذا الحد، يمكنك استخدام حقل "Cursor" للترقيم اليدوي أو تفعيل خيار "Return All" لاسترجاع جميع السجلات تلقائيًا.

لاستخدام هذه العقدة:
  1. اختر بيانات الاعتماد المرتبطة بحساب WOZTELL الخاص بك.
  2. اختر قناة المحادثة التي توجد بها جهات الاتصال.
  3. أدخل وسمًا واحدًا أو أكثر، مفصولة بفواصل. سيتم إرجاع الأعضاء المرتبطين فقط بهذه الوسوم.
  4. استخدم حقل Cursor أو فعّل Return All لاسترجاع جميع النتائج إذا لزم الأمر.
الناتج يتضمن قائمة كائنات تحتوي على معلومات الاتصال والبيانات الوصفية.

لمزيد من المعلومات: WOZTELL Open API.


العقدة: تعيين وسوم العضو

تتيح لك هذه العقدة تعيين وسم أو أكثر لجهة اتصال في قناة معينة باستخدام واجهة WOZTELL Open API.

تُستخدم الوسوم في العديد من ميزات WOZTELL مثل الحملات، وإدارة جهات الاتصال، وبناء الشات بوت. تتيح لك الوسوم تقسيم المستخدمين وتتبع حالات العمل وتخصيص سير العمل استنادًا إلى ملفات تعريف المستخدمين أو سلوكهم.

يمكن وضع هذه العقدة في أي نقطة داخل سير العمل لتطبيق منطق مخصص بناءً على الوسوم.

لاستخدام هذه العقدة:

  1. حدد بيانات الاعتماد المرتبطة بحساب WOZTELL الخاص بك.
  2. اختر القناة التي يتواجد فيها جهة الاتصال.
  3. أدخل معرف العضو الخارجي (مثل رقم الهاتف لقناة WhatsApp).
  4. أضف وسمًا واحدًا أو أكثر، مفصولة بفواصل.

بمجرد تنفيذ العقدة، سيتم تحديث جهة الاتصال بالوسوم المحددة. يمكن استخدام هذه الوسوم لتصفية المستخدمين، أو إطلاق الحملات، أو تنفيذ تدفقات شرطية.

لمزيد من المعلومات: WOZTELL Open API.

العقدة: الحصول على معلومات العضو عبر ID

تسترجع هذه العقدة الملف الشخصي لعضو باستخدام معرفه الخارجي في قناة محددة. بالنسبة إلى WhatsApp، يكون هذا المعرف هو رقم الهاتف.

تعيد العقدة كافة بيانات الاتصال، بما في ذلك البيانات التعريفية وموقع المحادثة الحالي داخل صندوق الوارد (Inbox) في أحدث نسخة.

لاستخدام هذه العقدة:
  1. حدد بيانات الاعتماد المرتبطة بحساب WOZTELL الخاص بك.
  2. اختر القناة المعنية.
  3. أدخل المعرف الخارجي لجهة الاتصال.
هذا مفيد في حال كانت سير العمل تتطلب الوصول إلى بيانات محدثة أو عند الحاجة إلى مزامنة المعلومات بين أنظمة متعددة.

مزيد من المعلومات: WOZTELL Open API · نظرة عامة على صندوق الوارد.


العقدة: الحصول على سجل المحادثات عبر ID

تسترجع هذه العقدة سجل المحادثات الخاص بجهة اتصال باستخدام المعرف الخارجي ونطاق زمني محدد.

يُعد ذلك مفيدًا بشكل خاص للتدقيق، أو سير العمل الخاص بالدعم الفني، أو لتحسين تدريب الشات بوت من خلال مراجعة التفاعلات السابقة.

لاستخدام هذه العقدة:
  1. حدد بيانات الاعتماد المرتبطة بحساب WOZTELL.
  2. اختر القناة.
  3. أدخل معرف جهة الاتصال الخارجي.
  4. حدد النطاق الزمني (بداية ونهاية).
ملاحظة
ملاحظة:
يجب تحديد النطاق الزمني. في حال عدم تحديده، قد تفشل الاستعلامات بسبب حجم البيانات الكبير.

إذا كنت تتوقع أكثر من 100 نتيجة، استخدم حقل Cursor أو فعّل خيار Return All.

لمزيد من المعلومات: WOZTELL Open API.


حالات الاستخدام

  • جمع العملاء المحتملين: حفظ عملاء WhatsApp المحتملين في Google Sheets مع إرسال رسالة تأكيد تلقائية.

  • تكامل CRM: تحديث سجل في نظام CRM وإرسال إشعار WhatsApp باستخدام WOZTELL.

  • توجيه المحادثات: إعادة توجيه العملاء من سير دعم إلى سير مبيعات باستخدام عقدة إعادة توجيه العضو.


أفضل الممارسات

  • بيئات منفصلة: استخدم بيئة اختبار مخصصة قبل نشر أي سير عمل في بيئة الإنتاج.

  • إدارة الرموز (Tokens): احرص على حماية رموز الوصول، وقم بتحديد صلاحياتها، واستبدالها بشكل دوري.

  • معالجة الأخطاء: أضف فروع أخطاء ومنطق تكرار المحاولة لضمان استمرار التدفق عند وجود مشكلات مؤقتة.

  • المراقبة والسجلات: راجع سجلات التنفيذ داخل n8n لتحليل الأداء وحل المشاكل.

  • قابلية التوسع: ابدأ بسير عمل بسيط ووسّعه تدريجيًا حسب احتياجات عملك.


إذا كانت لديك أسئلة أثناء التنفيذ، تواصل مع فريق دعم WOZTELL عبر بوابة الدعم الرسمية.