إنشاء سير عملك الأول باستخدام n8n: دليل المبتدئين

n8n أول سير عمل إنشاء أول سير عمل في n8n بسيط كاختيار مشغّل، وإضافة عقد إجراءات، وتشغيل اختبار. يأخذك هذا الدليل عبر العملية بأكملها — من الاختيار بين Cloud والاستضافة الذاتية وصولاً إلى إطلاق أتمتتك الأولى في بيئة الإنتاج.

قبل البدء: Cloud أم الاستضافة الذاتية؟

أسرع طريقة للبدء مع n8n هي إنشاء حساب على n8n Cloud؛ ومن يفضّل الاستضافة الذاتية يمكنه التشغيل باستخدام Docker في دقائق معدودة. يعتمد الاختيار على متطلبات خصوصية البيانات وقدرة الفريق التقني.

إذا كنت قد استكشفت بالفعل ما هو n8n، فقد حان وقت الانتقال إلى الخطوة العملية. تأتي المنصة بنموذجَي نشر رئيسيَّين: n8n Cloud والاستضافة الذاتية. في خيار Cloud، يمكنك بدء إنشاء سير الأعمال في المتصفح فور إنشاء الحساب دون الحاجة إلى إدارة أي بنية تحتية. تغطّي خطة التجربة المجانية جميع الميزات الأساسية وتتيح لك اختبار سيناريو جاهز للإنتاج بسرعة.

في نموذج الاستضافة الذاتية، تبقى بياناتك كلياً على خوادمك — وهي ميزة حاسمة للمؤسسات في القطاعَين المالي والصحي. يغطّي دليلنا الخاص بـ تثبيت n8n باستخدام Docker بالتفصيل كيفية تشغيله بأمر واحد وكيفية ضبط متغيرات البيئة. بصرف النظر عن المسار الذي تختاره، تكون الواجهة ومنطق سير العمل متطابقَين؛ والخطوات الواردة في هذا الدليل تنطبق على كلتا البيئتَين.

الواجهة والمفاهيم الأساسية

تتكوّن واجهة n8n من لوحة سير العمل (Canvas) وقائمة العقد وسجل التنفيذ. تمثّل العقد الخطوات الفردية في سير العمل؛ والمشغّل هو نقطة البداية؛ وتنقل الوصلات البيانات بين العقد.

عند فتح n8n لأول مرة، تستقبلك لوحة فارغة. يؤدّي النقر على زر 'Add First Step' في الزاوية العلوية اليسرى إلى فتح مكتبة العقد. تحتوي هذه المكتبة على أكثر من 400 تكامل؛ استخدم مربع البحث للعثور على التطبيق الذي تحتاجه في ثوانٍ.

يمكنك وضع عقدة بسحبها على اللوحة وإنشاء وصلة بالسحب من مقبض الإخراج الخاص بها. يؤدّي النقر المزدوج على عقدة إلى فتح معاملاتها في اللوحة اليمنى. تعرض علامة التبويب 'Executions' في القائمة العلوية سجلاً بجميع عمليات التشغيل السابقة — وهذه الشاشة هي الأكثر استخداماً أثناء التصحيح.

سير عملك الأول: خطوة بخطوة

لسير العمل الأول، تُعدّ سلسلة Schedule Trigger → HTTP Request → إرسال Gmail نقطة البداية المثالية. تُعلّم هذه البنية الثلاثية الخطوات الجدولة والاستدعاءات الخارجية لـ API وإرسال الإشعارات في آنٍ واحد.

افتح سير عمل جديداً وانقر على 'Add First Step' لفتح شاشة اختيار المشغّل. اختر مشغّل 'Schedule' واضبطه ليعمل يومياً في الساعة 09:00؛ يمكنك استخدام تعبير cron '0 9 * * *'. بعد ضبط المشغّل، تظهر أيقونة ساعة صغيرة عليه.

إضافة عقدة HTTP Request

اسحب من مقبض الإخراج الأيمن للمشغّل لإضافة عقدة 'HTTP Request'. في حقل URL، أدخل على سبيل المثال 'https://jsonplaceholder.typicode.com/todos/1'؛ واختر GET كطريقة. هذا العنوان خدمة اختبار مجانية تحاكي نقطة نهاية API حقيقية ولا تتطلب أي بيانات اعتماد.

إرسال إشعار باستخدام عقدة Gmail

صل عقدة 'Gmail' بمخرج عقدة HTTP Request. اختر عملية 'Send Message'. أدخل عنوان البريد الإلكتروني للمستلم في حقل 'To'. اكتب 'تقرير API اليومي' في حقل الموضوع. في حقل النص، ستستخدم صياغة التعبيرات التي سنتناولها في القسم التالي لسحب البيانات من استجابة HTTP. في الوقت الحالي، يمكنك إدخال نص ثابت.

1. أنشئ سير عمل جديداً (زر '+' أو 'New Workflow' في أعلى اليسار).
2. أضف Schedule Trigger واضبط تكراره.
3. صل عقدة HTTP Request وأدخل URL والطريقة.
4. صل عقدة Gmail واختر بيانات اعتماد Gmail.
5. انقر على زر 'Test Workflow' في أعلى اليمين.
6. انتظر ظهور علامة الصح الخضراء على كل عقدة.
7. افحص بيانات الاستجابة في سجل التنفيذ.

إضافة بيانات الاعتماد والاختبار

في n8n، بيانات الاعتماد (Credentials) هي نظام إدارة هوية مركزي يخزّن مفاتيح API ورموز OAuth المميزة بشكل مشفّر. بعد إنشاء تعريف لبيانات الاعتماد، يمكن إعادة استخدامه في جميع العقد من النوع نفسه.

أثناء ضبط عقدة Gmail، انقر على زر '+ Add' بجانب حقل 'Credential for Gmail'. على الشاشة التي تفتح، استخدم خيار 'Sign in with Google' لبدء تدفق OAuth. تفتح صفحة تفويض حساب Google في متصفحك؛ بعد منح الإذن، يقوم n8n تلقائياً بتخزين الرمز المميز. يُخزَّن هذا الرمز بتشفير AES-256 ولا يُعرض مطلقاً بنص عادي.

بعد إضافة بيانات الاعتماد بنجاح، تظهر محدّدةً في معاملات العقدة. انقر على زر 'Test Workflow' في أعلى اليمين لإجراء تشغيل اختباري عند الطلب. بعد التنفيذ، تُظهر كل عقدة علامة صح خضراء للنجاح أو علامة تعجب حمراء للخطأ. في حالة الخطأ، انقر على العقدة لقراءة رسالة الخطأ التفصيلية وفحص بنية بيانات الإدخال/الإخراج.

• يمكنك أيضاً الوصول إلى شاشة إعدادات بيانات الاعتماد من 'Settings > Credentials' في القائمة اليسرى.
• يمكن مشاركة بيانات الاعتماد نفسها عبر سير أعمال متعددة؛ وتحديثها يُحدِّث جميع سير الأعمال.
• في بيئات العمل الجماعي، يمكن مشاركة بيانات الاعتماد باستخدام التحكم في الوصول المستند إلى الأدوار.
• يدعم n8n آليات التحديث التلقائي للرموز المميزة OAuth المنتهية الصلاحية.

التعبيرات وتدفق البيانات

تتيح تعبيرات n8n الوصول إلى بيانات JSON من العقد السابقة باستخدام الصياغة {{ $json.fieldName }}. يُتيح ذلك لكل عقدة استخدام مخرجات الخطوة السابقة بشكل ديناميكي.

عند البدء في الكتابة في أي حقل نص لعقدة، تظهر أيقونة '/' أو '{{ }}' صغيرة على اليمين. النقر عليها يفتح محرّر التعبيرات. في المحرّر، يمكنك عرض جميع البيانات التي تلقّتها العقدة الحالية في هيكل شجري وإكمال أسماء الحقول تلقائياً بالنقر عليها.

لنفترض أن عقدة HTTP Request تُرجع استجابة JSON بالبنية التالية: { "id": 1, "title": "عنوان المهمة", "completed": false }. إذا كتبت '{{ $json.title }}' في حقل Subject لعقدة Gmail، سيُعيَّن موضوع البريد الإلكتروني تلقائياً إلى 'عنوان المهمة'. في تدفق يحتوي على عقد متعددة، استخدم الصياغة '{{ $node["HTTP Request"].json.title }}' للوصول إلى البيانات من عقدة سابقة محددة.

• {{ $json.fieldName }} — حقل من البيانات التي تصل إلى العقدة الحالية
• {{ $node["NodeName"].json.fieldName }} — حقل من مخرجات عقدة محددة
• {{ $now.toISO() }} — الطابع الزمني الحالي (ISO 8601)
• {{ $workflow.name }} — اسم سير العمل الحالي
• {{ $itemIndex }} — فهرس العنصر الحالي في حلقة

يمكن استخدام التعبيرات ليس فقط في حقول النص، بل أيضاً في الحقول الرقمية والمنطقية. على سبيل المثال، في عقدة شرط، يُجري '{{ $json.completed }}' مقارنة منطقية مباشرة. يُظلَّل التعبير غير الصالح باللون الأحمر، ويمكنك الضغط على زر 'Test' لعرض بنية البيانات المتوقعة.

التصحيح والنشر الفعلي

يُظهر سجل التنفيذ بيانات الإدخال والإخراج لكل عقدة ورسائل الخطأ والمدة لكل تشغيل. لتفعيل سير العمل، ما عليك سوى تبديل زر 'Inactive' في أعلى اليمين إلى 'Active'.

عند التبديل إلى علامة التبويب 'Executions' في القائمة العلوية، ترى قائمة بجميع عمليات التشغيل السابقة. تُظهر كل صف وقت التشغيل والحالة (نجاح/فشل) والمدة الإجمالية. النقر على تشغيل يفتح عرض سير العمل في تلك اللحظة، مع عرض عدد عناصر البيانات المدخلة والمخرجة على كل عقدة. تُعرض العقدة الفاشلة بحدود حمراء؛ والنقر عليها يتيح قراءة رسالة الخطأ الكاملة وتتبّع المكدّس.

تُعدّ ميزة 'Pin Data' مفيدة جداً أثناء التصحيح: عند تثبيت مخرجات عقدة، لا تُشغَّل هذه العقدة مجدداً في عمليات التشغيل التجريبية اللاحقة، وتُختبر العقد التالية بالبيانات الثابتة. يتيح لك ذلك التطوير دون استنفاد حدود معدّل طلبات API.

لنشر سير عملك، انقر على زر التبديل 'Inactive' في أعلى اليمين؛ سيتحوّل إلى 'Active'، وسيبدأ Schedule Trigger تلقائياً في الوقت المحدد. بالنسبة للمشغّلات القائمة على Webhook، يُنشئ n8n عنوان URL فور التفعيل ويبدأ الاستماع للطلبات الواردة إليه.

• احرص دائماً على إجراء تشغيل اختباري قبل تفعيل سير العمل.
• بالنسبة لسير الأعمال الإنتاجية الحرجة، أنشئ تدفق إشعارات أخطاء باستخدام عقدة Error Trigger.
• أدِر مدة الاحتفاظ بسجل التنفيذ بضبط الإعدادات في 'Settings > Executions'.
• في تدفقات البيانات عالية الحجم، استخدم عقدة 'Split In Batches' لتحسين استخدام الذاكرة.

الخطوات التالية: تكامل الذكاء الاصطناعي والـ Webhooks

بعد إتمام سير العمل الأساسي، يمكنك بناء سيناريوهات أتمتة أكثر قوة باستخدام دعم وكلاء الذكاء الاصطناعي وقدرات Webhook في n8n — المجالان اللذان يُحقّقان أعلى قيمة في الأتمتة المؤسسية.

يتكامل n8n بشكل أصلي مع نماذج اللغة الكبيرة (LLM). يشرح دليلنا الخاص بـ إعداد وكلاء الذكاء الاصطناعي باستخدام n8n خطوة بخطوة كيفية بناء نظام أتمتة يستدل على بياناتك الخاصة باستخدام OpenAI أو نموذج محلي. سير الأعمال الذكية التي تصنّف طلبات العملاء أو تُلخّص التقارير أو تكشف الشذوذات يمكن الآن بناؤها في n8n دون كتابة سطر كود واحد.

يتيح تكامل Webhook للأنظمة الخارجية تشغيل n8n؛ فأحداث مثل إرسال النماذج أو إشعارات الدفع أو تحديثات CRM يمكن أن تبدأ سير عمل فوراً. يغطّي محتوانا المعمّق حول تكامل n8n Webhook وAPI جميع قدرات عقدة HTTP وتصميم Webhooks الآمنة.

كنقطة انطلاق، نوصي بتصفّح مكتبة n8n التي تحتوي على أكثر من 1700 قالب من إعداد المجتمع. تحتوي القوالب على تكوينات عقد جاهزة لتكاملات أو سيناريوهات محددة ويمكن استيرادها إلى سير عملك بنقرة واحدة، مما يتيح لك دراسة مثال عملي وتكييفه مع سيناريوك الخاص.

الأسئلة الشائعة

كيف أبدأ مع n8n؟

أسرع طريقة هي فتح حساب Cloud على n8n.io؛ بعد التسجيل بالبريد الإلكتروني يمكنك البدء فوراً في إنشاء سير الأعمال في المتصفح. لمن يفضّل الاستضافة الذاتية، التثبيت ممكن بأمر Docker واحد.

هل أحتاج إلى معرفة البرمجة لاستخدام n8n؟

لا. تتيح الواجهة المرئية في n8n إنشاء معظم سيناريوهات الأتمتة دون كتابة أي كود. عقدة Code بدعم JavaScript متاحة للحالات المتقدمة، لكنها ليست ضرورية للمبتدئين.

كيف أنشئ أول سير عمل؟

افتح سير عمل جديداً، أضف عقدة مشغّل (Schedule أو Webhook أو Manual)، ثم اربط عقد الإجراءات في سلسلة. استخدم زر 'Test Workflow' للتشغيل الفوري، افحص النتائج في سجل التنفيذ، وفعّله إذا لم تكن هناك أخطاء.

كيف أختبر سير العمل دون نشره؟

زر 'Test Workflow' في أعلى اليمين يُشغّل سير العمل مرة واحدة دون تفعيله. يمكنك عرض الإدخال والإخراج لكل عقدة على اللوحة، وفحص الأخطاء، واستخدام ميزة Pin Data لتثبيت مخرجات عقدة محددة لاختبار العقد التالية.

هل توجد قوالب جاهزة في n8n؟

نعم. تحتوي مكتبة قوالب n8n على أكثر من 1700 سير عمل أعدّها المجتمع. يمكن البحث حسب الفئة من علامة التبويب 'Templates' في القائمة اليسرى أو على n8n.io/workflows.

كيف أُفعّل سير العمل؟

ما عليك سوى النقر على زر التبديل 'Inactive' في الزاوية العلوية اليمنى من محرّر سير العمل. سيتحوّل إلى 'Active'، وبحسب نوع المشغّل، تبدأ الجدولة أو الاستماع للـ Webhook تلقائياً. يُنصح بإجراء تشغيل اختباري ناجح قبل التفعيل.

ما الموارد التي يمكنني استخدامها لتعلّم n8n؟

التوثيق الرسمي على docs.n8n.io ومنتدى المجتمع على community.n8n.io والدروس المرئية على قناة YouTube هي أفضل نقاط البداية. كذلك تُعدّ الأمثلة في مكتبة القوالب الطريقة الأكثر عملية لدراسة هياكل سير العمل الحقيقية.

الخلاصة

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

إن كنت ترغب في الانتقال إلى سيناريوهات أكثر تعقيداً أو تخطّط لدمج n8n مع أنظمتك المؤسسية القائمة، فإن فريق أتمتة Sora مستعد بمستشارين متمرّسين لجلسة استكشافية مجانية. تواصل معنا اليوم للحصول على دعم في معماريات الأتمتة المصمّمة للقطاع المالي أو الصناعي أو الحكومي.