N8n

وثائق n8n التفصيلية

إضافة n8n هي أداة تكامل قوية تتيح لك ربط منصة برنامجك بسير عمل n8n عبر الـ webhooks.

رابط العرض التجريبي

مقدمة

إضافة n8n هي أداة تكامل قوية تتيح لك ربط منصتك البرمجية بسير عمل n8n عبر webhooks. تمكّن هذه الإضافة من نقل البيانات تلقائيًا من أنشطة النظام المختلفة مثل إنشاء المستخدم، أو إنشاء الفاتورة، أو تسجيل العميل إلى منصة n8n لمزيد من المعالجة والأتمتة. يدعم النظام طرق HTTP متعددة ويمكنه التعامل مع البيانات من أكثر من 75 إضافة مختلفة عبر وظائف أعمال متنوعة بما في ذلك العمليات العامة، والمحاسبة، والموارد البشرية، و CRM، وإضافات الصناعة المتخصصة.

كيفية تمكين هذه الوحدة

لإعداد إضافة n8n، يمكنك اتباع هذا الرابط: إضافة الإعداد.

كيفية استخدام إضافة n8n؟

تكامل n8n

• لإعداد تكامل n8n جديد، انقر زر «إضافة n8n» في صفحة إعدادات تكامل n8n.
• أولًا، اختر الإضافة المناسبة من القائمة المنسدلة. يحتوي حقل الإضافة على خيارات محددة مسبقًا منظَّمة حسب فئات مثل: عام (إنشاء مستخدم، فاتورة جديدة، تحديث حالة الفاتورة، عرض جديد، تحديث حالة العرض)، حساب (عميل جديد، مورد جديد، إيراد جديد)، نقطة البيع (شراء جديد، مستودع جديد)، إدارة الموارد البشرية (جائزة جديدة، إعلان جديد، عطلات جديدة، كشف راتب شهري جديد، حدث جديد، موظف جديد)، التوظيف (وظيفة جديدة، طلب وظيفة جديد، جدولة مقابلة، تحويل إلى موظف)، والعديد من الإضافات المتخصصة الأخرى لمختلف الوظائف التجارية.
• بعد ذلك، اختر طريقة HTTP التي تطابق متطلبات سير عمل n8n الخاص بك. يمكنك الاختيار من بين طرق GET أو HEAD أو POST أو PUT أو PATCH حسب الطريقة التي تريد بها نقل البيانات إلى منصة n8n الخاصة بك.
• أخيرًا، أدخِل عنوان URL الكامل لخطّاف الويب الذي أنشأته ونسخته من منصة n8n الخاصة بك. هذا العنوان هو المكان الذي ستُرسَل إليه جميع بيانات الإضافة المحددة عند حدوث الإجراء المقابل في نظامك.
• سيرسل النظام الآن البيانات تلقائياً على منصة n8n كلما حدث نشاط الإضافة المحدد.
• بعد إنشاء سجل، تعرض القائمة الإجراء، واسم الوحدة، والطريقة، والحالة (نشط/غير نشط). يتوفر مفتاح تبديل لتفعيل أو تعطيل الـ webhook بتبديل حالته بين نشط وغير نشط. عند ضبط الـ webhook على غير نشط، فلن يعمل.
• من عمود الإجراءات، يمكنك النقر على "تعديل" لتعديل أي تكوين webhook موجود، مثل تغيير طريقة HTTP أو تحديث عنوان webhook. يمكنك أيضًا النقر على "حذف" لإزالة تكاملات webhook التي لم تعد بحاجة إليها.

كيف يعمل دمج n8n

• يعمل تكامل n8n من خلال نظام قائم على webhook مباشر ينقل البيانات تلقائيًا من منصتك إلى سير عمل n8n. عند إنشاء تكامل webhook جديد، فإنك أساسًا تنشئ جسر تواصل بين برنامجك ومنصة n8n.
• على سبيل المثال، إذا أردت التقاط جميع تسجيلات المستخدمين الجدد في سير عمل n8n الخاص بك، فستنشئ أولاً webhook على منصة n8n مصمم خصيصًا لاستقبال بيانات المستخدم. بعد نسخ عنوان URL الخاص بالـ webhook من n8n، ستقوم بتكوينه في نظامك عن طريق اختيار “إنشاء مستخدم” من القائمة المنسدلة للإضافات، واختيار “POST” كطريقة، ولصق عنوان URL الخاص بالـ webhook.
• بمجرد التكوين، عندما يسجّل مستخدم جديد أو يُنشأ في نظامك، يُطلَق الويب هوك تلقائيًا ويرسل جميع بيانات المستخدم ذات الصلة (مثل الاسم والبريد الإلكتروني ورقم الجوال والعنوان ومعلومات الملف الشخصي الأخرى) إلى منصة n8n الخاصة بك عبر رابط الويب هوك.
• تصل البيانات إلى سير عمل n8n الخاص بك تمامًا كما التُقطت في نظامك، مما يتيح لك معالجتها أكثر وفقًا لمتطلبات الأتمتة لديك.
• يحدث نقل البيانات السلس هذا في الوقت الفعلي، مما يضمن أن تتمكن سير عمل n8n لديك دائماً من الوصول إلى أحدث المعلومات من منصتك. يمكنك بعد ذلك استخدام هذه البيانات داخل n8n لتشغيل عمليات إضافية، أو إرسال إشعارات، أو تحديث الأنظمة الخارجية، أو تنفيذ أي مهام آلية أخرى بناءً على احتياجات عملك المحددة.

• قم بالوصول إلى منصة n8n، وانتقل إلى قسم مشروعي، وانقر على زر إنشاء سير العمل.
• بعد النقر على ذلك الزر، ستُفتح أمامك واجهة مستخدم، وفي أعلى تلك الصفحة يوجد زر «+»، وابحث عن خطاف الويب ضمن تلك العلامة.

• انتقل إلى قائمة إعدادات n8n ضمن “الإعدادات”. انقر على خيار n8n من الشريط الجانبي الأيسر للوصول إلى واجهة إدارة n8n.
• تعرض صفحة إعدادات n8n قائمة بالـwebhooks المُكوَّنة مع أعمدة تظهر الإضافة، والطريقة، وعنوان URL، والحالة (نشط/غير نشط)، وخيارات الإجراء. يمكنك عرض تكوينات webhook الخاصة بـ n8n الحالية وإدارتها من هذه الواجهة.
• انقر على زر “إضافة n8n” لبدء إعداد تكامل ويب هوك جديد مع n8n.
• في صفحة إنشاء n8n Webhook، حدد الإضافة المناسبة من القائمة المنسدلة. اختر الوحدة أو الوظيفة المحددة التي تريد دمجها مع n8n مثل "إنشاء مستخدم" لأحداث تسجيل المستخدمين.
• اختر طريقة HTTP من قائمة الطريقة المنسدلة. اختر “POST” لإرسال البيانات إلى n8n، أو اختر الطريقة المناسبة بناءً على متطلبات سير عملك.
• الصق رابط خطاف الويب الذي نسخته من n8n في حقل الرابط. هذا يُنشئ نقطة نهاية الاتصال التي ستُرسَل البيانات إليها.
• انقر على "إنشاء" لحفظ تهيئة خطاف الويب لـ n8 وتفعيل التكامل.
• بعد إنشاء خطّاف الويب، سيظهر في قائمة خطافات ويب n8n مبيّنًا الإضافة المهيّأة والطريقة وعنوان URL. يتضمن إدخال خطّاف الويب أزرار إجراءات لتعديل التهيئة أو حذفها. يُتاح مفتاح تبديل لتمكين خطّاف الويب أو تعطيله بتغيير حالته بين نشِط وغير نشط. عندما يكون خطّاف الويب غير نشط، لن يعمل.

• الويبهوك الآن نشط وسيُطلَق تلقائياً كلما وقع الحدث المحدد في منصتك. على سبيل المثال، إذا هيّأته لـ «إنشاء مستخدم»، فسيُطلَق في كل مرة يُسجَّل فيها أو يُنشأ مستخدم جديد.
• يمكنك إنشاء عدة خطافات ويب n8n لأحداث مختلفة عن طريق تكرار العملية واختيار خيارات إضافة مختلفة من القائمة المنسدلة.
• أنشأنا أعلاه webhook لإنشاء المستخدمين. والآن. لننشئ المستخدم.

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

• الآن بمجرد النقر على زر الإنشاء، يحدث حدث مكوّن في منصتك مثل تسجيل مستخدم، ويرسل webhook تلقائيًا جميع البيانات ذات الصلة إلى سير عمل n8n الخاص بك. تتضمن البيانات جميع المعلومات الملتقطة مثل الاسم والبريد الإلكتروني ورقم الجوال والعنوان وتفاصيل الملف الشخصي الأخرى.
• تصل البيانات إلى سير عمل n8n في الوقت الفعلي، محافظة على نفس البنية والتنسيق كما التُقطت في منصتك. يمكنك بعد ذلك معالجة هذه البيانات داخل n8n لإطلاق أتمتة إضافية، أو إرسال إشعارات، أو تحديث أنظمة خارجية.
• راقب سير عمل n8n الخاص بك للتأكد من استقبال البيانات بشكل صحيح ومن أن خطوات الأتمتة اللاحقة تُنفّذ كما هو متوقع. يوفر التكامل مزامنة بيانات سلسة وفورية بين منصتك وسير عمل n8n.

• الآن بمجرد النقر على زر الإنشاء، يحدث الحدث المكوّن في منصتك

(مثل تسجيل المستخدم)، يرسل webhook تلقائيًا جميع البيانات ذات الصلة إلى سير عمل n8n الخاص بك. تتضمن البيانات جميع المعلومات الملتقطة مثل الاسم والبريد الإلكتروني ورقم الهاتف المحمول والعنوان وتفاصيل الملف الشخصي الأخرى.

• تصل البيانات إلى سير عمل n8n الخاص بك في الوقت الفعلي، محافظة على نفس

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

• راقب سير عمل n8n الخاص بك للتأكد من استقبال البيانات بشكل صحيح ومن أن

تُنفَّذ خطوات الأتمتة اللاحقة كما هو متوقع. يوفّر التكامل مزامنة بيانات سلسة وفورية بين منصتك وسير عمل n8n.

ملاحظة: إليك قائمة ببعض الإضافات التي يمكننا الاتصال بها بسهولة عبر إضافة Webhook.

الإضافات المتاحة حسب الفئة

عام

• مستخدم جديد
• فاتورة مبيعات جديدة
• تم تحديث حالة فاتورة المبيعات
• عرض مبيعات جديد
• تم تحديث حالة العرض
• فاتورة شراء جديدة
• مستودع جديد

الحساب

• عميل جديد
• مورّد جديد
• إيرادات جديدة

موعد

• موعد جديد
• حالة الموعد

نظام إدارة الصيانة المحوسب

• طلب أمر عمل
• مورّد جديد
• أوامر شراء جديدة
• مكوّن جديد
• موقع جديد
• إدارة موارد بشرية جديدة
• أمر عمل جديد

العقد

• عقد جديد

الموارد البشرية

• جائزة جديدة
• فعالية جديدة
• إعلان جديد
• إجازات جديدة

عميل محتمل

• عميل محتمل جديد
• تحويل العميل المحتمل إلى صفقة
• صفقة جديدة
• تم نقل العميل المحتمل
• تم نقل الصفقة

التوظيف

• مرشّح جديد
• جدول المقابلات
• تحويل إلى موظف
• إعلان وظيفة جديد

الأتعاب

• إنشاء عقد استبقاء
• دفعة عقد احتجاز جديدة

المبيعات

• عرض سعر جديد
• طلب مبيعات جديد
• اجتماع جديد

Mewayz المهام

• مشروع جديد
• مهمة جديدة
• خطأ جديد
• معلَم جديد
• تحديث مرحلة المهمة
• تعليق مهمة جديد

التدريب

• مدرب جديد
• تدريب جديد

ZoomMeeting

• اجتماع Zoom جديد

المحفظة

• محفظة جديدة
• فئة محفظة أعمال جديدة

جدول بيانات

• جدول بيانات جديد

إصلاح المعدات

• ملحقات جديدة
• الأصول الجديدة
• تدقيق جديد
• مكوّن إصلاح معدات جديد
• مستهلكات جديدة
• ترخيص جديد
• موقع معدات ثابت جديد
• صيانة جديدة
• فئة جديدة
• إهلاك جديد
• مُصنّع جديد
• مجموعة محددة مسبقًا جديدة
• حالة جديدة

إدارة الزوار

• زائر جديد
• سبب زيارة جديد

WordPress (WooCommerce)

• منتج جديد
• فئة منتج جديدة
• ضريبة جديدة

ملاحظات

• قالب جديد
• تقييم ملاحظات جديد
• تقييم جديد

إدارة المدرسة والمعهد

• التسجيلات الجديدة
• أولياء أمور جدد
• طلاب جدد
• واجب منزلي جديد
• مادة جديدة
• جدول زمني جديد
• موظف جديد
• فصل دراسي جديد

إدارة التنظيف

• فريق تنظيف جديد
• حجز تنظيف جديد
• فاتورة تنظيف جديدة

متتبّع الوقت

• متتبّع جديد

إدارة إصلاح الآلات

• آلة جديدة
• طلب إصلاح جديد

إدارة المستشفيات

• طبيب جديد
• مريض جديد
• موعد مستشفى جديد
• طب المستشفيات الجديد
• تخصص جديد
• فئة دواء جديدة
• نوع سرير جديد
• جناح جديد
• سرير مستشفى جديد
• سجلات طبية جديدة

المعرفة الداخلية (قاعدة المعرفة)

• كتاب جديد
• مقالة جديدة

مركز الابتكار

• إبداع جديد
• تحدٍّ جديد
• فئة جديدة
• تحدّيات جديدة
• مرحلة جديدة

قائمة المهام

• مهمة جديدة
• مرحلة مهمة جديدة

المستندات

• مستند جديد
• نوع مستند جديد

إدارة الزراعة

• أسطول زراعي جديد
• عملية زراعة جديدة
• دورة زراعية جديدة
• مكتب زراعة جديد
• نشاط زراعي جديد
• خدمة زراعية جديدة
• زراعة جديدة
• معدات زراعية جديدة
• نوع مطالبة زراعية جديد
• قسم زراعة جديد
• قناة زراعية جديدة
• نوع موسم زراعي جديد
• منتج خدمة زراعية جديد
• مستخدم زراعة جديد

إدارة العقارات

• عقار جديد
• وحدات عقارية جديدة
• مستأجر جديد
• فاتورة عقار جديدة
• دفعة فاتورة عقار جديدة

نظام إدارة التعلم

• دورة جديدة
• طلب دورة جديد
• صفحة مخصصة جديدة
• مدونة جديدة

إدارة المشروبات

• تصنيع جديد
• مادة خام جديدة
• تغليف جديد
• مركز تجميع جديد
• قائمة مواد جديدة
• مادة بند فاتورة جديدة

إدارة شركات التوصيل

• فرع جديد
• نوع خدمة جديد
• حالة تتبع جديدة
• فئة حزمة جديدة
• ساعي بريد جديد
• دفعة جديدة

نظام إدارة الإصلاح

• طلب أمر إصلاح جديد
• قطعة إصلاح جديدة
• فاتورة إصلاح جديدة

نظام إدارة الشحن

• طلب حجز شحن جديد
• حاوية شحن جديدة
• عميل شحن جديد
• سعر شحن جديد
• خدمة شحن جديدة
• مسار شحن جديد
• فاتورة شحن جديدة
• تحديث طلب شحن البضائع
• تحديث خدمة شحن الشحنات
• تحديث حاوية الشحن البري

قالب العقد

• قالب عقد جديد
• تكرار قالب العقد

مشاركة الملفات

• ملف جديد

إدارة الورش والكراجات

• نوع وقود جديد
• فئة كراج جديدة
• مركبة كراج جديدة
• خدمة جديدة
• علامة مركبة جديدة
• لون مركبة جديد
• نوع مركبة جديد
• بطاقة عمل جديدة

إدارة منتجع التجميل الصحي

• خدمة تجميل جديدة
• حجز الجمال الجديد
• تحديث ساعات العمل

إدارة التأمين

• تأمين جديد
• سياسة جديدة
• نوع وثيقة تأمين جديد
• فاتورة تأمين جديدة
• مطالبة تأمين جديدة
• دفعة مطالبة تأمين جديدة

قالب المستند

• قالب مستند جديد
• تكرار قالب مستند
• تحويل قالب المستند

مركز الفيديو

• فيديو جديد

مركز الاجتماعات

• اجتماع جديد
• مهمة اجتماع جديدة
• محضر اجتماع جديد
• ملاحظة اجتماع جديدة