مرجع کامل نودهای n8n
نرمافزار n8n یکی از قدرتمندترین ابزارهای متنباز برای طراحی و اجرای اتوماسیونهای بدون کدنویسی و کمکدنویسی است که امکان اتصال صدها سرویس، API و سیستم مختلف را فراهم میکند. هسته اصلی n8n را «نودها (Nodes)» تشکیل میدهند؛ هر نود یک وظیفه مشخص مانند دریافت داده، پردازش اطلاعات، ارسال درخواست یا کنترل جریان اجرای ورکفلو را بر عهده دارد.
درک صحیح نودهای n8n نقش کلیدی در طراحی ورکفلوهای پایدار، قابل توسعه و حرفهای دارد. بدون شناخت دقیق عملکرد هر نود، اتوماسیونها بهسرعت پیچیده، خطاپذیر و غیرقابل نگهداری میشوند. به همین دلیل داشتن یک مرجع کامل، ساختیافته و بهروز از نودهای n8n برای توسعهدهندگان، متخصصان اتوماسیون و تیمهای فنی ضروری است.
این مقاله با هدف ارائه مرجع کامل نودهای Built-in نرمافزار n8n تهیه شده است. در این راهنما، تمام نودهای اصلی n8n بهصورت دستهبندیشده معرفی شدهاند و در کنار هر نود، توضیحی کوتاه، دقیق و کاربردی از وظیفه آن ارائه شده است. این محتوا بهگونهای طراحی شده که هم برای یادگیری سریع مناسب باشد و هم بهعنوان یک منبع مرجع دائمی در پروژههای واقعی مورد استفاده قرار گیرد.
نود (Node) در n8n چیست؟
در نرمافزار n8n، نود (Node) کوچکترین واحد اجرایی یک ورکفلو محسوب میشود. هر نود نماینده یک عمل مشخص است؛ عملی مانند دریافت داده از یک منبع، پردازش اطلاعات، ارسال درخواست به یک سرویس خارجی، ذخیره داده در پایگاهداده یا کنترل مسیر اجرای ورکفلو.
هر نود دارای ورودی (Input) و خروجی (Output) داده است و دادهها بهصورت آیتم (Item) بین نودها جریان پیدا میکنند. n8n این دادهها را معمولاً در قالب JSON مدیریت میکند، به همین دلیل نودها میتوانند بهراحتی با یکدیگر ترکیب شوند و زنجیرههای پیچیده اتوماسیون را شکل دهند.
نودها در n8n به دو دسته کلی تقسیم میشوند:
Trigger Nodes: نودهایی که آغازکننده اجرای ورکفلو هستند (مانند Webhook یا Schedule Trigger)
Action / Processing Nodes: نودهایی که پس از شروع ورکفلو اجرا میشوند و وظیفه پردازش، انتقال یا ذخیره داده را دارند
درک صحیح عملکرد نودها و نحوه اتصال آنها به یکدیگر، پایه طراحی ورکفلوهای پایدار، مقیاسپذیر و قابل نگهداری در n8n است. هرچه انتخاب نودها آگاهانهتر باشد، اتوماسیون نهایی سادهتر، سریعتر و کمخطاتر اجرا خواهد شد.
ساختار و منطق دستهبندی نودهای n8n
در نرمافزار n8n، نودها بر اساس نقش عملکردی آنها در اجرای ورکفلو قابل دستهبندی هستند، نه صرفاً بر اساس نام سرویس یا ابزار. در این مقاله، دستهبندی نودهای n8n با هدف درک سریع، استفاده عملی و توسعهپذیری بلندمدت انجام شده است.
منطق این دستهبندی بر سه اصل اصلی استوار است:
نقش نود در چرخه اجرای Workflow
- شروعکننده اجرا (Trigger)
- پردازش و تغییر داده
- کنترل مسیر اجرا
- ارتباط با سیستمها و سرویسهای خارجی
- انجام عملیات کمکی یا سیستمی
- به همین دلیل نودهایی که از نظر فنی متفاوت هستند، اما نقش مشابهی در جریان اجرا دارند، در یک دسته قرار گرفتهاند.
استقلال از سرویس و تمرکز بر کاربرد
- نودها بر اساس «چه کاری انجام میدهند» دستهبندی شدهاند
- نه صرفاً بر اساس نام سرویس (مثل Google یا Slack)
- این موضوع باعث میشود کاربر:
- سریعتر نود مناسب را پیدا کند
- منطق طراحی ورکفلو را بهتر درک کند
سازگاری با رشد و نسخههای آینده n8n
- وابسته به نسخه خاصی از n8n نیست
- با اضافهشدن نودهای جدید، بهراحتی قابل توسعه است
- بدون تغییر ساختار اصلی، میتوان دستهها را بهروزرسانی کرد
دسته بندی نودهای N8N
Core & Trigger Nodes (نودهای پایه و شروع Workflow)
نودهای این دسته مسئول شروع، زمانبندی و مدیریت اولیه اجرای Workflow در n8n هستند. هر Workflow حداقل به یک Trigger Node نیاز دارد تا فرآیند اجرا آغاز شود.
| نام نود | توضیح کوتاه و کاربردی |
|---|---|
| Start | نقطه شروع گرافیکی ورکفلو برای اتصال نودها؛ در اجرای واقعی نقشی ندارد |
| Manual Trigger | اجرای دستی ورکفلو توسط کاربر از داخل پنل n8n |
| Webhook | دریافت درخواست HTTP از سرویسهای خارجی و شروع ورکفلو |
| Respond to Webhook | ارسال پاسخ HTTP به درخواست دریافتشده توسط Webhook |
| Schedule Trigger | اجرای خودکار ورکفلو بر اساس زمانبندی مشخص (Cron) |
| Interval Trigger | اجرای ورکفلو در بازههای زمانی ثابت (مثلاً هر چند دقیقه) |
| Error Trigger | اجرای یک ورکفلو در صورت بروز خطا در Workflow دیگر |
| Execute Workflow | اجرای یک Workflow دیگر از داخل این Workflow |
| Wait | متوقفکردن اجرای ورکفلو تا زمان مشخص یا وقوع رویداد |
- هر Workflow فعال حداقل یک Trigger Node دارد
- Webhook و Schedule Trigger پرکاربردترین نودهای شروع هستند
- Start فقط برای طراحی بصری است و در اجرای واقعی استفاده نمیشود
Data Manipulation Nodes (پردازش و ویرایش دادهها)
نودهای این دسته مسئول دستکاری، فیلتر، ترکیب یا منطقگذاری روی دادهها هستند. معمولاً بعد از Triggerها اجرا میشوند و دادههای دریافتی را برای مرحله بعد آماده میکنند.
| نام نود | توضیح کوتاه و کاربردی |
|---|---|
| Set | ایجاد یا ویرایش فیلدهای داده برای آیتمهای Workflow |
| Edit Fields | تغییر یا حذف فیلدهای موجود در دادهها |
| Merge | ترکیب دادهها از چند مسیر مختلف Workflow |
| IF | بررسی شرط و مسیر دهی دادهها بر اساس نتیجه شرط |
| Switch | هدایت دادهها به مسیرهای مختلف بر اساس چند شرط |
| Filter | فیلتر کردن آیتمها بر اساس معیارهای مشخص |
| Remove Duplicates | حذف دادههای تکراری از مجموعه آیتمها |
| Split In Batches | تقسیم مجموعه داده به بخشهای کوچک برای پردازش مرحلهای |
| Item Lists | ایجاد یا مدیریت لیست آیتمها برای Workflow |
| Code (JavaScript / Python) | اجرای کد دلخواه برای پردازش پیشرفته دادهها |
- این نودها برای پردازش دادههای دریافتی از Triggerها ضروریاند
- ترکیب درست نودهای Data Manipulation باعث کاهش پیچیدگی Workflow میشود
- نودهای مثل Code قدرت انعطاف کامل را به توسعهدهنده میدهند ولی استفاده درست از آنها نیاز به دانش برنامهنویسی دارد
Flow Control Nodes (کنترل مسیر اجرای Workflow)
نودهای این دسته مسئول کنترل جریان دادهها و مسیر اجرای Workflow هستند. با این نودها میتوان مسیرهای شرطی، توقف، تکرار و تقسیم دادهها را مدیریت کرد.
| نام نود | توضیح کوتاه و کاربردی |
|---|---|
| IF | بررسی شرط و تعیین مسیر اجرای Workflow بر اساس نتیجه |
| Switch | هدایت دادهها به مسیرهای مختلف بر اساس چند شرط |
| Wait | توقف موقت اجرای Workflow تا زمان مشخص یا رویداد خاص |
| Loop Over Items | اجرای یک نود یا مجموعه نودها روی تکتک آیتمها |
| Split In Batches | تقسیم مجموعه دادهها به بخشهای کوچک برای پردازش مرحلهای |
| Error Trigger | اجرای Workflow دیگری در صورت بروز خطا در Workflow جاری |
- Flow Control Nodes باعث منطقگذاری و انعطاف در Workflow میشوند
- ترکیب درست IF و Switch مسیرهای پیچیده را قابل مدیریت میکند
- نودهای Wait و Split In Batches برای کنترل زمان و حجم پردازش دادهها کاربرد دارند
HTTP & API Nodes (ارتباط با API و وبسرویسها)
این نودها برای ارسال و دریافت داده از سرویسها و APIهای خارجی استفاده میشوند. با استفاده از آنها میتوان اطلاعات را از وبسایتها، اپلیکیشنها و سرویسهای مختلف دریافت کرد یا به آنها ارسال نمود.
| نام نود | توضیح کوتاه و کاربردی |
|---|---|
| HTTP Request | ارسال درخواست GET، POST، PUT، DELETE به یک API و دریافت پاسخ |
| Webhook | دریافت درخواست HTTP از سرویس خارجی و شروع Workflow |
| Respond to Webhook | ارسال پاسخ HTTP به درخواست دریافتی از Webhook |
| GraphQL | ارسال درخواست به APIهای GraphQL و دریافت داده |
| OAuth2 API | اتصال و احراز هویت خودکار به سرویسهای خارجی با پروتکل OAuth2 |
| API Credential | مدیریت اطلاعات احراز هویت برای اتصال امن به APIها |
- HTTP & API Nodes ستون فقرات اتوماسیونهای مبتنی بر داده خارجی هستند
- Webhook و Respond to Webhook معمولاً با هم استفاده میشوند تا دریافت و پاسخدهی همزمان داشته باشیم
- GraphQL و OAuth2 API برای پروژههای حرفهای و سرویسهای مدرن کاربرد فراوان دارند
Database Nodes (کار با پایگاههای داده)
این نودها امکان اتصال، خواندن، نوشتن و مدیریت دادهها در پایگاههای داده مختلف را فراهم میکنند. با استفاده از آنها میتوان دادهها را ذخیره، بروزرسانی یا حذف کرد و گزارشهای سفارشی ایجاد نمود.
| نام نود | توضیح کوتاه و کاربردی |
|---|---|
| MySQL | اجرای Query، Insert، Update و Delete در پایگاه داده MySQL |
| PostgreSQL | اجرای Query و عملیات مدیریت دادهها در PostgreSQL |
| SQLite | کار با پایگاه داده SQLite در محیط محلی یا Workflow |
| MongoDB | اتصال و مدیریت دادهها در پایگاه MongoDB |
| Redis | ذخیره و بازیابی دادههای کلیدی (Key-Value) با سرعت بالا |
| MSSQL | اجرای Query و عملیات CRUD در Microsoft SQL Server |
- Database Nodes برای نگهداری دادههای دائمی و اتوماسیونهای پیچیده ضروری هستند
- هر نود امکان اجرای Query سفارشی را دارد و میتواند با دادههای دریافتی از Workflow ترکیب شود
- استفاده درست از این نودها، سرعت و پایداری Workflow را افزایش میدهد
File & Binary Data Nodes (مدیریت فایل و دادههای باینری)
این نودها برای خواندن، نوشتن، انتقال و تبدیل فایلها و دادههای باینری کاربرد دارند. در اتوماسیونهایی که با تصاویر، PDF، اسناد یا دادههای غیرمتنی سروکار دارند، این نودها ضروری هستند.
| نام نود | توضیح کوتاه و کاربردی |
|---|---|
| Read Binary File | خواندن فایلهای باینری از مسیر مشخص در سیستم یا سرور |
| Write Binary File | ذخیره دادههای باینری به فایل در مسیر مشخص |
| Move Binary Data | انتقال دادههای باینری بین آیتمها یا Workflowها |
| Convert Binary Data | تبدیل دادههای باینری بین فرمتهای مختلف (مثلاً تصویر به Base64) |
| FTP / SFTP | آپلود یا دانلود فایلها از سرورهای FTP یا SFTP |
| Google Drive | بارگذاری، دانلود و مدیریت فایلها در Google Drive |
| Dropbox | بارگذاری، دانلود و مدیریت فایلها در Dropbox |
- File & Binary Nodes برای اتوماسیونهای پردازش فایل، تصاویر و اسناد حیاتی هستند
- دادهها معمولاً به صورت Binary بین نودها منتقل میشوند
- ترکیب درست نودهای خواندن، تبدیل و آپلود فایلها، امکان ساخت Workflowهای کاملاً خودکار مدیریت فایل را فراهم میکند
Communication & Messaging Nodes (ارسال پیام و نوتیفیکیشن)
این نودها برای ارتباط با کاربران یا سیستمها از طریق پیامک، ایمیل یا سرویسهای چت استفاده میشوند. در اتوماسیونهای مارکتینگ، اطلاعرسانی و اعلانهای داخلی بسیار کاربرد دارند.
| نام نود | توضیح کوتاه و کاربردی |
|---|---|
| Email (SMTP / Send Email) | ارسال ایمیل از طریق سرور SMTP یا سرویس داخلی n8n |
| Telegram | ارسال پیام به کانالها یا کاربران تلگرام |
| Slack | ارسال پیام، اعلان یا فایل به کانالها و کاربران Slack |
| Discord | ارسال پیام به کانالها و کاربران Discord |
| ارسال پیام متنی یا رسانهای از طریق WhatsApp | |
| SMS | ارسال پیامک متنی به شمارههای موبایل |
- این نودها برای ارتباط با کاربران و سیستمها ضروری هستند
- ترکیب این نودها با Triggerها باعث ایجاد اتوماسیونهای اطلاعرسانی خودکار میشود
- اکثر سرویسها نیاز به Credential یا Token دارند تا اتصال امن برقرار شود
Productivity & App Integration Nodes (اتصال به ابزارها و سرویسها)
این نودها برای یکپارچهسازی Workflow با سرویسها و ابزارهای کاربردی استفاده میشوند. با آنها میتوان دادهها را بین نرمافزارها منتقل کرد و اتوماسیونهای عملیاتی و مدیریتی ساخت.
| نام نود | توضیح کوتاه و کاربردی |
|---|---|
| Google Sheets | خواندن، نوشتن و بروزرسانی دادهها در Google Sheets |
| Google Docs | ایجاد و مدیریت اسناد در Google Docs |
| Notion | ایجاد، بروزرسانی و خواندن صفحات و دیتابیسهای Notion |
| Airtable | مدیریت رکوردها و دیتابیسهای Airtable |
| Trello | مدیریت کارتها، لیستها و تختههای Trello |
| ClickUp | ایجاد و مدیریت وظایف و پروژهها در ClickUp |
| Asana | مدیریت پروژه و تسکها در Asana |
| Monday | اتصال و مدیریت پروژهها و دادهها در Monday.com |
- این نودها باعث یکپارچهسازی و اتوماسیون ابزارهای کاری روزمره میشوند
- استفاده درست از آنها باعث صرفهجویی زمان و کاهش خطای انسانی میگردد
- اکثر نودها نیاز به Credential یا Token دارند تا اتصال امن برقرار شود
AI & Advanced Automation Nodes (هوش مصنوعی و اتوماسیون پیشرفته)
این نودها برای ادغام هوش مصنوعی و الگوریتمهای پیشرفته در Workflow استفاده میشوند. با آنها میتوان متن تولید کرد، تحلیل دادههای پیچیده انجام داد، پاسخ هوشمند به کاربر داد و اتوماسیونهای هوشمند ساخت.
| نام نود | توضیح کوتاه و کاربردی |
|---|---|
| OpenAI | اتصال به مدلهای OpenAI برای تولید متن، پاسخ هوشمند و پردازش زبان طبیعی |
| ChatGPT | استفاده از مدل ChatGPT برای مکالمه، تحلیل یا تولید محتوا |
| Hugging Face | اتصال به مدلهای ML و NLP در پلتفرم Hugging Face |
| AI Agent | ساخت دستیار هوشمند و اجرای خودکار تصمیمات بر اساس دادهها |
| Vector Store | ذخیره و بازیابی دادهها با قابلیت جستجوی معنایی و پردازش هوشمند |
- این نودها امکان اتوماسیون هوشمند و پیشرفته را فراهم میکنند
- معمولاً برای پروژههای حرفهای، با ترکیب دادهها و Workflowهای دیگر استفاده میشوند
- نیاز به Credential و اتصال امن دارند و بعضی از آنها API Key مخصوص سرویسهای خارجی را میطلبند
Utility & System Nodes (نودهای کمکی و سیستمی)
این نودها برای کارهای کمکی، پردازش دادهها و انجام عملیات سیستمی استفاده میشوند. معمولاً این نودها به Workflow انعطاف و قابلیت پردازش پیشرفته اضافه میکنند.
| نام نود | توضیح کوتاه و کاربردی |
|---|---|
| Date & Time | محاسبه تاریخ و زمان، افزودن یا کم کردن روز/ساعت و فرمتبندی تاریخها |
| Crypto | رمزنگاری و هشگذاری دادهها با الگوریتمهای مختلف |
| UUID | تولید شناسههای یکتا برای آیتمها یا رکوردها |
| No Operation (NoOp) | نود خالی برای نگه داشتن جریان Workflow بدون تغییر داده |
| Execute Command | اجرای دستورهای سیستم عامل یا اسکریپتها از داخل Workflow |
| Function | اجرای کد دلخواه JavaScript برای پردازش دادهها |
| Function Item | اجرای کد JavaScript روی هر آیتم به صورت جداگانه |
- این نودها باعث افزایش انعطاف و قدرت Workflow میشوند
- اکثر نودهای Utility برای پردازش دادهها، مدیریت زمان و اجرای کد استفاده میشوند
- استفاده هوشمندانه از نودهای Execute Command و Function، امکان اتوماسیون پیشرفته و تخصصی را فراهم میکند
نکات مهم و حرفهای در استفاده از نودهای n8n
- همیشه Trigger مناسب انتخاب کنید
- هر Workflow حداقل به یک Trigger نیاز دارد.
- انتخاب صحیح Trigger (Webhook، Schedule یا Manual) باعث بهینه شدن اجرای Workflow میشود.
- دادهها را مرحلهای پردازش کنید
- از نودهای Data Manipulation مثل Set، Merge و Filter برای نظمدهی دادهها استفاده کنید.
- پردازش مرحلهای باعث کاهش خطا و بهبود خوانایی Workflow میشود.
- کنترل مسیر با دقت انجام شود
- استفاده از Flow Control Nodes مثل IF، Switch و Wait مسیرهای پیچیده را قابل مدیریت میکند.
- ترکیب درست این نودها باعث کاهش تکرار و پیچیدگی میشود.
- استفاده هوشمند از HTTP & API Nodes
- برای ارتباط با سرویسهای خارجی همیشه از Credential و تایید هویت امن استفاده کنید.
- ترکیب Webhook و Respond to Webhook اجرای همزمان دریافت و پاسخدهی را ساده میکند.
- مدیریت پایگاههای داده بهینه باشد
- Database Nodes برای ذخیرهسازی دائمی دادهها ضروری هستند.
- همیشه Queryها را بهینه بنویسید و دادهها را قبل از ذخیره بررسی کنید.
- فایلها و دادههای باینری را کنترل کنید
- از File & Binary Data Nodes برای مدیریت فایلها و تبدیل فرمتها استفاده کنید.
- دادهها را تا حد امکان به صورت باینری نگه دارید تا سرعت Workflow افزایش یابد.
- ارتباط با کاربران و سرویسها امن باشد
- Communication & Messaging Nodes مانند Email، Slack و Telegram نیاز به Credential دارند.
- همیشه اطمینان حاصل کنید که اتصال امن برقرار است و داده حساس منتقل نمیشود.
- اتوماسیون هوشمند را به Workflow اضافه کنید
- استفاده از AI & Advanced Automation Nodes، مانند OpenAI یا ChatGPT، میتواند قابلیتهای پیشرفته ایجاد کند.
- از این نودها برای تحلیل داده، تولید متن یا تصمیمگیری هوشمند استفاده کنید.
- نودهای Utility و سیستمی را فراموش نکنید
- نودهای مثل Function، Execute Command و Date & Time، انعطاف بیشتری به Workflow میدهند.
- این نودها برای پردازش پیشرفته، مدیریت زمان و تولید دادههای کمکی کاربردی هستند.
- Workflowها را کوچک و قابل مدیریت نگه دارید
- Workflowهای بزرگ و پیچیده را به بخشهای کوچک تقسیم کنید.
- از Execute Workflow برای مدیریت زیر-Workflowها استفاده کنید تا نگهداری آسان باشد.
جمعبندی و مسیر ادامه یادگیری
این مقاله با هدف ارائه مرجع کامل نودهای Built-in نرمافزار n8n تهیه شد. تمام نودهای اصلی n8n به صورت دستهبندیشده معرفی شدند و در کنار هر نود، توضیحی کوتاه، دقیق و کاربردی ارائه شد. این مرجع به شما کمک میکند تا:
- به سرعت نود مناسب برای Workflow خود را پیدا کنید
- منطق طراحی Workflow را بهتر درک کنید
- اتوماسیونهای پایدار، انعطافپذیر و حرفهای بسازید
جهت شروع آموزش به دوره آموزش جامع N8N با مهندس پویا حیاتی مراجعه نمایید
سوالات پرتکرار
Node در n8n چیست و چه کاربردی دارد؟
نود کوچکترین واحد اجرایی یک Workflow است و هر نود یک عمل مشخص مانند دریافت داده، پردازش اطلاعات یا ارسال خروجی را انجام میدهد.
Trigger Node و Action Node چه تفاوتی دارند؟
Trigger Node آغازگر اجرای Workflow است (مثلاً Webhook یا Schedule) و Action Node عملی را روی دادهها انجام میدهد.
Workflow چیست و چگونه با نودها ساخته میشود؟
Workflow زنجیرهای از نودهاست که دادهها را از شروع تا پایان پردازش میکند و منطق اجرای خودکار را تعریف میکند.
چطور میتوان یک Workflow را بهینه و کمخطا طراحی کرد؟
Workflowها را مرحلهای بسازید، دادهها را با Data Manipulation Nodes مدیریت کنید و مسیر اجرا را با Flow Control Nodes کنترل کنید.
چه نودهایی برای پردازش دادهها و مدیریت دادههای بزرگ توصیه میشوند؟
نودهای Set، Merge، Filter، Split In Batches و Code یا Function برای پردازش و مدیریت دادهها بسیار مناسب هستند.
چطور میتوان مسیر اجرای Workflow را با Flow Control Nodes کنترل کرد؟
با استفاده از نودهای IF، Switch، Wait و Loop Over Items میتوانید جریان دادهها را شرطی یا مرحلهای کنید.
Webhook چیست و چگونه Workflow را شروع میکند؟
Webhook نقطهای است که درخواست HTTP از سرویس خارجی دریافت میکند و Workflow را آغاز میکند.
چطور میتوان با سرویسهای خارجی مثل Google Sheets، Slack یا Notion ارتباط برقرار کرد؟
با نودهای مخصوص هر سرویس و اتصال Credential یا API Token میتوان دادهها را خواند، نوشت یا به روز کرد.
چطور میتوان از نودهای OpenAI یا ChatGPT در Workflow استفاده کرد؟
با اضافه کردن نود OpenAI/ChatGPT و اتصال API Key، میتوان متن تولید، تحلیل دادهها یا پاسخ هوشمند ایجاد کرد.
آیا میتوان تصمیمات هوشمند را خودکار در Workflow پیادهسازی کرد؟
بله، با ترکیب AI Nodes و Flow Control Nodes میتوان تصمیمات خودکار و هوشمند روی دادهها گرفت.
چه نودهایی برای ذخیره دائمی دادهها در پایگاههای داده مناسب هستند؟
نودهای MySQL، PostgreSQL، MongoDB، SQLite و Redis برای ذخیره و بازیابی دائمی دادهها مناسب هستند.
چطور Workflowهای بزرگ را به بخشهای کوچک تقسیم کنیم؟
از نود Execute Workflow استفاده کنید تا زیر-Workflowها را جداگانه اجرا کرده و مدیریت آنها آسان شود.