پرش به متن
محاسب ۳۶۵ نرم‌افزار حسابداری، انبار و فروش
مردی که دست به سمت صفحه‌ی لپ‌تاپ برده و خطی آبی می‌کشد تا دو کارت را به هم وصل کند؛ روی کارت اول یک صفحه‌ی ساعت ساده دیده می‌شود.

شروع کار با n8n: ساختن اولین گردش کار

چهار مفهوم پایه، شش گام تا یک گردش کار زنده، و کاری که اگر نشود زمان‌بندی هیچ‌وقت اجرا نمی‌شود

در پایان این راهنما یک گردش کار زنده خواهید داشت که هر روز سر ساعت مشخصی خودش اجرا می‌شود، داده‌ای را می‌خواند و نتیجه را جایی می‌فرستد — بدون اینکه کسی دکمه‌ای بزند. ساختن اولین گردش کار حدود بیست دقیقه طول می‌کشد و به هیچ خط برنامه‌نویسی احتیاج ندارد.

این نوشته ادامه‌ی نصب n8n روی سرور ایران است. اگر هنوز نصبش نکرده‌اید، اول آن را انجام دهید.

چهار واژه که باید بدانید

کل این ابزار روی چهار مفهوم ساده ایستاده است. اگر این چهار تا را بفهمید، بقیه‌اش فقط کلیک است.

واژهیعنی چهمثال
گردش کار (Workflow)کل یک کار خودکار، از اول تا آخر«هر صبح گزارش فروش دیروز را بفرست»
گره (Node)یک قدم داخل آن کار«از پایگاه داده بخوان»، «ایمیل بفرست»
محرک (Trigger)اولین گره؛ تعیین می‌کند کار کی شروع شودساعت هفت صبح، یا رسیدن یک درخواست
اجرا (Execution)یک بار دویدن کامل گردش کاراجرای امروز صبح، با نتیجه‌اش

هر گردش کار دقیقاً یک محرک دارد و بعد از آن هر تعداد گره. گره‌ها با خط به هم وصل می‌شوند و داده از چپ به راست در آن‌ها جریان پیدا می‌کند.

شکل اولین گردش کار: محرک زمانی، خواندن داده، تصمیم، و گزارش محرک زمانی هر روز سر ساعت مشخصی گردش کار را شروع می‌کند، داده از سرویس خوانده می‌شود، و اگر ردیف تازه‌ای بود گزارش فرستاده می‌شود؛ وگرنه کار بدون اقدام تمام می‌شود. شکل اولین گردش کار محرک: هر روز سر ساعت خواندن داده از سرویس ردیف تازه هست؟ فرستادن گزارش پایان بدون اقدام بله نه سبز: نتیجه‌ی کار · قرمز: پایانی که اقدامی ندارد شکل اولین گردش کار: محرک زمانی، خواندن داده، تصمیم، و گزارش محرک زمانی هر روز سر ساعت مشخصی گردش کار را شروع می‌کند، داده از سرویس خوانده می‌شود، و اگر ردیف تازه‌ای بود گزارش فرستاده می‌شود؛ وگرنه کار بدون اقدام تمام می‌شود. شکل اولین گردش کار محرک: هر روز سر ساعت خواندن داده از سرویس ردیف تازه هست؟ فرستادن گزارش پایان بدون اقدام بله نه سبز: نتیجه‌ی کار · قرمز: پایانی که اقدامی ندارد
از راست بخوانید. هر جعبه یک گره است و پیکان‌ها مسیر داده را نشان می‌دهند.

گام ۱: گردش کار تازه بسازید

کجا: صفحه‌ی اصلی n8n، بخش گردش کارها.
چه کنید: دکمه‌ی ساختن گردش کار تازه را بزنید.
چه می‌بینید: بوم خالی باز می‌شود با یک مربع نقطه‌چین وسطش که از شما اولین قدم را می‌خواهد.
اگر نه: اگر دکمه هیچ کاری نکرد، صفحه را دوباره بار کنید و بلافاصله بزنید. این یک ایراد شناخته‌شده‌ی رابط است: روی صفحه‌ای که مدتی باز مانده، دکمه بی‌صدا کار نمی‌کند و در کنسول مرورگر خطایی درباره‌ی بارگذاری نشدن بوم ثبت می‌شود.

بوم خالی گردش کار با مربع نقطه‌چین و نوشته‌ی افزودن اولین قدم در میانه‌ی صفحه
همین مربع نقطه‌چین وسط بوم را بزنید؛ از این‌جا فهرست محرک‌ها باز می‌شود.

گام ۲: محرک را انتخاب کنید

کجا: همان مربع وسط بوم.
چه کنید: رویش بزنید و از فهرستی که باز می‌شود محرک زمانی را انتخاب کنید. برای شروع، زمان‌بندی ساده‌ترین است چون برای آزمودنش به هیچ سرویس بیرونی احتیاج ندارید.

چه می‌بینید: گره‌ای روی بوم می‌نشیند و پنجره‌ای باز می‌شود که می‌پرسد هر چند وقت یک بار اجرا شود.
اگر نه: اگر فهرست خالی آمد، صفحه را دوباره بار کنید.

فهرست محرک‌ها در ستون سمت چپ: اجرای دستی، رویداد یک برنامه، زمان‌بندی، درخواست وب، ارسال فرم، فراخوانی از گردش کار دیگر و پیام گفت‌وگو
هشت محرک ممکن. برای اولین بار گزینه‌ی سوم، یعنی زمان‌بندی، ساده‌ترین است.
تنظیمات محرک زمانی: بازه‌ی اجرا روی روز، فاصله‌ی یک روز، ساعت نیمه‌شب و دقیقه‌ی صفر
چهار قلم سمت راست را پر کنید. هشدار نارنجی بالا همان چیزی را می‌گوید که در گام ۶ می‌آید: تا منتشر نشود، زمان‌بندی اجرا نمی‌شود.

برای آزمودن، فاصله‌ی زمانی را کوتاه نگذارید. وسوسه می‌شوید هر دقیقه بگذارید تا زود نتیجه ببینید؛ ولی بعد یادتان می‌رود و گردش کار ناقص هر دقیقه روی سرور می‌دود. آزمون دستی گام ۵ همین کار را بدون زمان‌بندی می‌کند.

گام ۳: گره کار را اضافه کنید

کجا: علامت مثبت کنار گره محرک.
چه کنید: رویش بزنید و سرویسی را که می‌خواهید انتخاب کنید. برای اولین بار یک گره ساده بردارید که چیزی را از جایی می‌خواند — مثلاً یک درخواست وب ساده یا یک برگه.

چه می‌بینید: گره دوم با یک خط به محرک وصل می‌شود.
اگر نه: اگر گره وصل نشد، خط را دستی از گوشه‌ی گره اول به گره دوم بکشید.

گره محرک زمانی روی بوم، با علامت مثبت کنارش برای افزودن گره بعدی و دکمه‌ی انتشار در گوشه‌ی بالا
علامت مثبت سمت چپ گره را بزنید. دکمه‌ی انتشار گوشه‌ی بالا همان چیزی است که در گام ۶ لازم می‌شود.
ستون جست‌وجوی گره با عنوان بعدش چه می‌شود، و یک نتیجه‌ی پیداشده برای ویرایش مقدارها
نام گره را در همین کادر بنویسید. نتیجه‌ها همان لحظه فیلتر می‌شوند.

زیر هر گره که به یک سرویس بیرونی وصل می‌شود، از شما شناسه‌ی ورود می‌خواهد. آن شناسه در خود n8n رمز می‌شود و با همان کلیدی که هنگام نصب ساختید نگه داشته می‌شود.

گام ۴: تصمیم را اضافه کنید

کجا: باز هم علامت مثبت، این بار بعد از گره دوم.
چه کنید: گره شرط را اضافه کنید و شرطتان را بنویسید. مثلاً «اگر شمار ردیف‌های تازه بیشتر از صفر بود».

چه می‌بینید: گره شرط دو خروجی دارد، یکی برای درست و یکی برای نادرست.
اگر نه: اگر هر دو خروجی خالی ماندند، یعنی گره قبلی هنوز داده‌ای ندیده است. اول گام ۵ را بزنید و بعد برگردید.

این گره همان چیزی است که گردش کار را از یک زنجیره‌ی کور به یک کار هوشمند تبدیل می‌کند. بدون آن، هر روز گزارشی می‌گیرید حتی وقتی هیچ اتفاقی نیفتاده است.

گام ۵: دستی اجرایش کنید

کجا: دکمه‌ی اجرای آزمایشی، پایین بوم.
چه کنید: بزنیدش. گردش کار همان لحظه یک بار می‌دود، بدون اینکه منتظر ساعت زمان‌بندی بماند.

چه می‌بینید: هر گره که تمام شد یک علامت سبز می‌گیرد و شمار ردیف‌هایی که از آن رد شده‌اند کنارش می‌آید. روی هر گره بزنید تا داده‌ی واقعی‌اش را ببینید.
اگر نه: گره قرمز یعنی خطا. رویش بزنید؛ پیام خطا داخل خودش نوشته شده است.

دو گره با قاب سبز و علامت تیک، و روی خط میانشان نوشته‌ی یک ردیف که نشان می‌دهد داده رد شده است
قاب سبز و تیک یعنی گره تمام شد. عدد روی خط می‌گوید چند ردیف از آن رد شده؛ اگر صفر بود، گره بعدی چیزی برای کار کردن ندارد.

همین صفحه‌ی داده‌ی هر گره مهم‌ترین ابزار عیب‌یابی شماست. پیش از اینکه دنبال علت بگردید، ببینید گره قبلی واقعاً چه چیزی تحویل داده است. بیشتر خطاها از این می‌آیند که گره دوم انتظار داشته چیزی بگیرد که گره اول نفرستاده.

گام ۶: منتشرش کنید

کجا: دکمه‌ی `Publish` گوشه‌ی بالای صفحه.
چه کنید: بزنیدش.
چه می‌بینید: پیامی می‌آید که گردش کار از این به بعد خودش اجرا می‌شود.
اگر نه: اگر نشد، معمولاً یعنی یکی از گره‌ها تنظیم ناقص دارد. همان گره علامت می‌گیرد.

تا وقتی این دکمه زده نشده، زمان‌بندی اجرا نمی‌شود. اجرای دستی گام ۵ کار می‌کند و آدم خیال می‌کند همه چیز روبه‌راه است، ولی گردش کار منتشرنشده سر ساعت نمی‌دود. خود n8n هم همین را در هشدار نارنجی تنظیمات محرک نوشته است.

⚠ در نسخه‌های قدیمی‌تر این دکمه «فعال‌سازی» نام داشت. اگر راهنمای دیگری دیدید که از آن واژه استفاده کرده، منظورش همین دکمه است.

مثال دوم: وقتی کار از بیرون شروع می‌شود

محرک زمانی برای کارهای دوره‌ای خوب است. ولی خیلی وقت‌ها می‌خواهید کار وقتی شروع شود که اتفاقی بیفتد — سفارشی ثبت شود، فرمی پر شود، پیامی برسد.

برای این حالت محرک را روی دریافت درخواست وب بگذارید. n8n یک نشانی یکتا به شما می‌دهد که هر کسی آن را صدا بزند، گردش کار یک بار می‌دود. نشانی به این شکل است:

https://<نشانی n8n شما>/webhook/<نام مسیر>

همان نشانی را در تنظیمات فروشگاه یا فرم یا هر سامانه‌ی دیگری می‌گذارید. ⚠ این نشانی عمومی است، پس نامش را حدس‌نزدنی بگذارید و هر داده‌ای که می‌رسد را پیش از استفاده بسنجید.

از کجا بفهمید درست شد

  1. اجرای دستی سبز شد و روی هر گره داده‌ی واقعی دیدید، نه خالی.
  2. گردش کار منتشر شده است و صفحه‌ی گردش کارها آن را فعال نشان می‌دهد.
  3. صبح روز بعد، صفحه‌ی اجراها ردیف دارد. این تنها سنجشی است که ثابت می‌کند زمان‌بندی هم کار می‌کند، و بقیه‌ی سنجش‌ها جایش را نمی‌گیرند.

آن صفحه‌ی اجراها را روز اول دو بار نگاه کنید. گردش کاری که خطا می‌دهد بی‌صدا خطا می‌دهد و خودش به کسی خبر نمی‌دهد.

عیب‌یابی

نشانهعلتچاره
اجرای دستی کار می‌کند ولی خودکار نهگردش کار منتشر نشده استدکمه‌ی Publish گوشه‌ی بالا را بزنید
گره قرمز با پیام دسترسیشناسه‌ی ورود سرویس غلط یا منقضی استدر بخش شناسه‌ها دوباره واردش کنید و همان‌جا بسنجیدش
گره سبز است ولی هیچ ردیفی رد نشدهگره قبلی داده‌ای نفرستادهروی گره قبلی بزنید و خروجی واقعی‌اش را ببینید
نتیجه‌ی اجرا روی صفحه زنده نمی‌شودمسیر وب‌سوکت از وب‌سرور رد نشدهپیکربندی پروکسی را بسنجید؛ در راهنمای نصب آمده است
گردش کار روی سرور کند استسقف پردازنده پایین است یا سرور یک هسته داردسقف را بالا ببرید یا هسته اضافه کنید
درخواست وب جواب نمی‌گیردگردش کار منتشر نشده، یا نام مسیر فرق داردنشانی را از خود گره محرک کپی کنید، دستی ننویسید

محدودیت‌ها

  • سرویس‌های بسته همچنان بسته‌اند. اگر سرور شما به سرویسی نمی‌رسد، گردش کار هم نمی‌رسد.
  • هر اجرا روی دیسک می‌ماند. تاریخچه‌ی اجراها بزرگ می‌شود؛ در راهنمای نصب تنظیمی هست که اجراهای کهنه را خودش پاک می‌کند.
  • یک هسته یعنی یکی در لحظه. گردش کارهای هم‌زمان پشت هم صف می‌کشند.
  • دستیار هوش مصنوعی اختیاری است و کلید جدا و پولی می‌خواهد. همه‌ی کارهای این نوشته بدون آن انجام می‌شوند.

و یک عادت که از روز اول ارزش دارد: هر گردش کار را با نامی بسازید که بگوید چه می‌کند و هر چند وقت یک بار. شش ماه بعد که بیست گردش کار دارید، نام «گردش کار ۳» هیچ چیزی به شما نمی‌گوید.

پرسش‌های پرتکرار

گردش کار در n8n یعنی چه؟
کل یک کار خودکار از اول تا آخر. هر گردش کار از یک محرک شروع می‌شود و بعد هر تعداد گره دارد که با خط به هم وصل‌اند و داده در آن‌ها جریان پیدا می‌کند.
تفاوت محرک و گره چیست؟
محرک اولین گره است و تعیین می‌کند کار کی شروع شود، مثلاً ساعت هفت صبح یا رسیدن یک درخواست. بقیه‌ی گره‌ها کارها را انجام می‌دهند. هر گردش کار دقیقاً یک محرک دارد.
ساختن اولین گردش کار چقدر طول می‌کشد؟
حدود بیست دقیقه، و به هیچ خط برنامه‌نویسی احتیاج ندارد.
چرا گردش کار من سر ساعت اجرا نمی‌شود؟
به احتمال زیاد منتشر نشده است. اجرای دستی روی گردش کار منتشرنشده هم کار می‌کند و همین گمراه‌کننده است. دکمه‌ی Publish گوشه‌ی بالای صفحه را بزنید.
دکمه‌ی ساختن گردش کار کار نمی‌کند، چه کنم؟
صفحه را دوباره بار کنید و بلافاصله بزنید. روی صفحه‌ای که مدتی باز مانده، دکمه بی‌صدا کار نمی‌کند و در کنسول مرورگر خطایی درباره‌ی بارگذاری نشدن بوم ثبت می‌شود.
چطور بفهمم گردش کار واقعاً کار می‌کند؟
سه سنجش: اجرای دستی سبز شود و روی هر گره داده‌ی واقعی ببینید، گردش کار منتشر شده باشد، و روز بعد صفحه‌ی اجراها ردیف داشته باشد. فقط سومی ثابت می‌کند زمان‌بندی هم کار می‌کند.
گره سبز است ولی هیچ ردیفی رد نشده، یعنی چه؟
یعنی گره قبلی داده‌ای نفرستاده است. روی گره قبلی بزنید و خروجی واقعی‌اش را ببینید؛ بیشتر خطاها از همین می‌آیند که گره دوم انتظار چیزی را دارد که گره اول نفرستاده.
برای شروع کار با n8n به دستیار هوش مصنوعی احتیاج هست؟
نه. دستیار اختیاری است و کلید جدا و پولی می‌خواهد. همه‌ی کارهای این راهنما بدون آن انجام می‌شوند.

نظرها

نظرها در حالِ بار شدن است…

مطلب‌های دیگر