“`html

معرفی نودهای پرکاربرد n8n و نحوه استفاده از آن‌ها

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

فهرست مطالب

• نود HTTP Request
• نود Set
• نود If
• نود Function
• نود Email
• نود Google Sheets
• نود Webhook

نود HTTP Request

نود HTTP Request یکی از اساسی ترین و پرکاربردترین نودها در n8n است. این نود به شما امکان می دهد درخواست های HTTP به هر API یا endpoint ارسال کنید. این نود از انواع متد های HTTP از جمله GET، POST، PUT، DELETE و PATCH پشتیبانی می کند.

نحوه استفاده از نود HTTP Request

برای استفاده از نود HTTP Request، ابتدا باید آن را به گردش کار خود اضافه کنید. سپس، باید URL endpoint API مورد نظر، متد HTTP و هر پارامتر یا هدر مورد نیاز را پیکربندی کنید.

پارامترهای اصلی نود HTTP Request:

• URL: آدرس endpoint API که می خواهید به آن درخواست ارسال کنید.
• Method: متد HTTP که می خواهید استفاده کنید (GET، POST، PUT، DELETE، PATCH).
• Headers: هدرهای HTTP که می خواهید به درخواست اضافه کنید.
• Query Parameters: پارامترهای query که می خواهید به URL اضافه کنید.
• Body: بدنه درخواست (برای متدهای POST، PUT، PATCH). می توانید بدنه را به صورت JSON، XML یا فرمت های دیگر ارسال کنید.
• Authentication: اطلاعات احراز هویت برای دسترسی به API های امن. n8n از انواع مختلف احراز هویت پشتیبانی می کند، از جمله API Key، Basic Authentication، OAuth2 و غیره.

مثال استفاده از نود HTTP Request

فرض کنید می خواهید داده ها را از یک API به دست آورید. می توانید از نود HTTP Request با متد GET برای ارسال درخواست به endpoint API استفاده کنید. در اینجا یک مثال ساده آورده شده است:

1. نود HTTP Request را به گردش کار خود اضافه کنید.
2. در فیلد URL، آدرس endpoint API را وارد کنید (به عنوان مثال، https://api.example.com/users).
3. متد را روی GET تنظیم کنید.
4. روی دکمه “Execute Node” کلیک کنید تا درخواست ارسال شود.

پس از اجرای نود، پاسخ API در خروجی نود نمایش داده می شود. می توانید از نودهای دیگر برای پردازش و استفاده از این داده ها استفاده کنید.

سناریوهای کاربردی نود HTTP Request

• دریافت داده ها از API ها: دریافت اطلاعات کاربران، محصولات، آب و هوا و غیره.
• ارسال داده ها به API ها: ایجاد، به روز رسانی یا حذف داده ها در سیستم های دیگر.
• اتصال به سرویس های خارجی: اتصال به CRM، سیستم های بازاریابی، پلتفرم های پرداخت و غیره.
• اسکرپینگ وب: جمع آوری داده ها از وب سایت ها (با رعایت قوانین اسکرپینگ).

نود Set

نود Set به شما امکان می دهد مقادیر متغیرها را در گردش کار خود تعیین کنید. این نود برای ذخیره داده ها، ایجاد متغیرهای موقت و تغییر داده های موجود بسیار مفید است.

نحوه استفاده از نود Set

برای استفاده از نود Set، ابتدا باید آن را به گردش کار خود اضافه کنید. سپس، باید نام متغیر و مقداری که می خواهید به آن اختصاص دهید را پیکربندی کنید.

پارامترهای اصلی نود Set:

• Variable Name: نام متغیری که می خواهید ایجاد یا به روز رسانی کنید.
• Value: مقداری که می خواهید به متغیر اختصاص دهید. می توانید از انواع داده های مختلف از جمله رشته، عدد، بولین، آرایه و آبجکت استفاده کنید. همچنین می توانید از عبارات (expressions) برای محاسبه مقدار متغیر استفاده کنید.
• Keep Existing Key: اگر می خواهید کلیدهای موجود را در دیتا نگه دارید، تیک این گزینه را بزنید.

مثال استفاده از نود Set

فرض کنید می خواهید نام کاربری را از یک API دریافت کنید و آن را در یک متغیر ذخیره کنید. می توانید از نود HTTP Request برای دریافت داده ها و سپس از نود Set برای ذخیره نام کاربری در یک متغیر استفاده کنید.

1. نود HTTP Request را به گردش کار خود اضافه کنید و endpoint API را پیکربندی کنید.
2. نود Set را به گردش کار خود اضافه کنید و آن را به نود HTTP Request متصل کنید.
3. در فیلد Variable Name، نام متغیر را وارد کنید (به عنوان مثال، username).
4. در فیلد Value، از عبارت {{$json.name}} استفاده کنید تا مقدار فیلد “name” از خروجی نود HTTP Request را به متغیر اختصاص دهید.
5. روی دکمه “Execute Node” کلیک کنید تا نود اجرا شود.

پس از اجرای نود، متغیر username با مقدار نام کاربری از API مقداردهی می شود. می توانید از این متغیر در نودهای دیگر برای استفاده از نام کاربری استفاده کنید.

سناریوهای کاربردی نود Set

• ذخیره داده ها: ذخیره داده های موقت برای استفاده در مراحل بعدی گردش کار.
• ایجاد متغیرهای موقت: ایجاد متغیرهایی برای شمارش، مقایسه و غیره.
• تغییر داده ها: تغییر فرمت داده ها، تبدیل انواع داده و غیره.
• ساختن آبجکت های JSON: ساختن آبجکت های JSON پیچیده با استفاده از داده های مختلف.

نود If

نود If به شما امکان می دهد جریان گردش کار خود را بر اساس یک شرط (condition) کنترل کنید. این نود برای ایجاد گردش کارهای شرطی که بسته به مقدار یک متغیر یا نتیجه یک مقایسه، مسیرهای مختلفی را طی می کنند بسیار مفید است.

نحوه استفاده از نود If

برای استفاده از نود If، ابتدا باید آن را به گردش کار خود اضافه کنید. سپس، باید شرطی که می خواهید ارزیابی کنید را پیکربندی کنید. نود If دارای دو خروجی است: “True” و “False”. اگر شرط درست باشد، گردش کار از خروجی “True” ادامه می یابد. اگر شرط نادرست باشد، گردش کار از خروجی “False” ادامه می یابد.

پارامترهای اصلی نود If:

• Value 1: مقدار اولی که می خواهید در شرط استفاده کنید. می توانید از متغیرها، مقادیر ثابت یا عبارات استفاده کنید.
• Operation: عملگری که می خواهید برای مقایسه دو مقدار استفاده کنید. n8n از انواع مختلف عملگرها از جمله “=”, “!=”, “>”، “<"، ">=”، “<="، "contains" و "matches" پشتیبانی می کند.
• Value 2: مقدار دومی که می خواهید در شرط استفاده کنید. می توانید از متغیرها، مقادیر ثابت یا عبارات استفاده کنید.

مثال استفاده از نود If

فرض کنید می خواهید بر اساس مقدار یک متغیر، یک ایمیل ارسال کنید یا نه. اگر مقدار متغیر بزرگتر از 10 باشد، باید ایمیل ارسال شود. در غیر این صورت، ایمیل نباید ارسال شود.

1. نود Set را به گردش کار خود اضافه کنید و یک متغیر با نام “count” ایجاد کنید.
2. نود If را به گردش کار خود اضافه کنید و آن را به نود Set متصل کنید.
3. در فیلد Value 1، از عبارت {{$node["Set"].json["count"]}} استفاده کنید تا مقدار متغیر “count” را دریافت کنید.
4. در فیلد Operation، عملگر “>” را انتخاب کنید.
5. در فیلد Value 2، مقدار 10 را وارد کنید.
6. نود Email را به خروجی “True” نود If متصل کنید.
7. نود دیگری را به خروجی “False” نود If متصل کنید (به عنوان مثال، یک نود Log برای ثبت یک پیام).
8. روی دکمه “Execute Workflow” کلیک کنید تا گردش کار اجرا شود.

پس از اجرای گردش کار، اگر مقدار متغیر “count” بزرگتر از 10 باشد، یک ایمیل ارسال می شود. در غیر این صورت، یک پیام در لاگ ثبت می شود.

سناریوهای کاربردی نود If

• کنترل جریان گردش کار: تعیین اینکه کدام مسیر در گردش کار باید طی شود.
• اعتبارسنجی داده ها: بررسی اینکه آیا داده ها معتبر هستند یا خیر.
• فیلتر کردن داده ها: انتخاب داده هایی که با یک شرط خاص مطابقت دارند.
• مدیریت خطا: رسیدگی به خطاها و انجام اقدامات مناسب.

نود Function

نود Function به شما امکان می دهد کد JavaScript سفارشی را در گردش کار خود اجرا کنید. این نود برای انجام عملیات پیچیده، پردازش داده ها و ادغام با کتابخانه های JavaScript بسیار مفید است.

نحوه استفاده از نود Function

برای استفاده از نود Function، ابتدا باید آن را به گردش کار خود اضافه کنید. سپس، باید کد JavaScript مورد نظر خود را در ویرایشگر کد نود وارد کنید. کد شما به خروجی نودهای قبلی دسترسی دارد و می تواند داده ها را پردازش و تغییر دهد.

پارامترهای اصلی نود Function:

• Code: کد JavaScript که می خواهید اجرا کنید.

مثال استفاده از نود Function

فرض کنید می خواهید یک رشته را به حروف بزرگ تبدیل کنید. می توانید از نود Function برای اجرای کد JavaScript که این کار را انجام می دهد استفاده کنید.

1. نود Set را به گردش کار خود اضافه کنید و یک متغیر با نام “text” ایجاد کنید و یک رشته را به آن اختصاص دهید.
2. نود Function را به گردش کار خود اضافه کنید و آن را به نود Set متصل کنید.
3. در ویرایشگر کد نود Function، کد زیر را وارد کنید:

   
     let text = items[0].json.text;
     items[0].json.text = text.toUpperCase();
     return items;
   

4. روی دکمه “Execute Node” کلیک کنید تا نود اجرا شود.

پس از اجرای نود، مقدار متغیر “text” به حروف بزرگ تبدیل می شود.

سناریوهای کاربردی نود Function

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

نود Email

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

نحوه استفاده از نود Email

برای استفاده از نود Email، ابتدا باید آن را به گردش کار خود اضافه کنید. سپس، باید اطلاعات حساب ایمیل خود را پیکربندی کنید، از جمله آدرس ایمیل فرستنده، آدرس ایمیل گیرنده، موضوع و بدنه ایمیل.

پارامترهای اصلی نود Email:

• Connection: اطلاعات اتصال به سرور ایمیل شما (SMTP). باید اطلاعات سرور، پورت، نام کاربری و رمز عبور خود را وارد کنید.
• From Email: آدرس ایمیل فرستنده.
• To Email: آدرس ایمیل گیرنده. می توانید از یک آدرس ایمیل واحد یا یک لیست آدرس ایمیل استفاده کنید.
• Subject: موضوع ایمیل.
• Body: بدنه ایمیل. می توانید از متن ساده یا HTML برای فرمت بندی بدنه ایمیل استفاده کنید. همچنین می توانید از متغیرها برای درج داده های پویا در بدنه ایمیل استفاده کنید.
• Attachments: فایل هایی که می خواهید به ایمیل پیوست کنید.

مثال استفاده از نود Email

فرض کنید می خواهید هر روز یک گزارش خلاصه از فعالیت های وب سایت خود را به صورت ایمیل دریافت کنید.

1. نود HTTP Request را به گردش کار خود اضافه کنید و endpoint API گزارش گیری وب سایت خود را پیکربندی کنید.
2. نود Set را به گردش کار خود اضافه کنید و داده های گزارش را در متغیرها ذخیره کنید.
3. نود Email را به گردش کار خود اضافه کنید و آن را به نود Set متصل کنید.
4. اطلاعات حساب ایمیل خود را در نود Email پیکربندی کنید.
5. موضوع و بدنه ایمیل را تنظیم کنید و از متغیرها برای درج داده های گزارش استفاده کنید.
6. یک تریگر (trigger) زمانبندی شده (به عنوان مثال، نود Cron) را به گردش کار خود اضافه کنید تا هر روز در زمان مشخصی گردش کار اجرا شود.
7. روی دکمه “Activate” کلیک کنید تا گردش کار فعال شود.

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

سناریوهای کاربردی نود Email

• ارسال اعلان ها: ارسال اعلان ها در مورد رویدادهای مهم (به عنوان مثال، ثبت نام کاربر جدید، سفارش جدید، خطا).
• ارسال گزارش ها: ارسال گزارش های خلاصه از داده ها و فعالیت ها.
• ارسال یادآوری ها: ارسال یادآوری ها در مورد وظایف، قرار ملاقات ها و پرداخت ها.
• ارسال ایمیل های بازاریابی: ارسال ایمیل های تبلیغاتی و خبرنامه ها.

نود Google Sheets

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

نحوه استفاده از نود Google Sheets

برای استفاده از نود Google Sheets، ابتدا باید آن را به گردش کار خود اضافه کنید. سپس، باید اطلاعات حساب Google خود را پیکربندی کنید و به n8n اجازه دسترسی به Google Sheets را بدهید. پس از پیکربندی حساب، می توانید عملیاتی که می خواهید روی صفحه گسترده انجام دهید را انتخاب کنید.

پارامترهای اصلی نود Google Sheets:

• Authentication: اطلاعات احراز هویت Google. باید حساب Google خود را به n8n متصل کنید.
• Spreadsheet ID: شناسه صفحه گسترده Google Sheets که می خواهید با آن تعامل داشته باشید.
• Sheet Name: نام برگه (sheet) در صفحه گسترده که می خواهید با آن تعامل داشته باشید.
• Operation: عملیاتی که می خواهید انجام دهید (به عنوان مثال، Read Range، Append Data، Update Range، Create Spreadsheet).
• Range: محدوده سلول هایی که می خواهید با آنها تعامل داشته باشید (به عنوان مثال، “A1:C10”).
• Values: مقادیری که می خواهید در صفحه گسترده بنویسید.

مثال استفاده از نود Google Sheets

فرض کنید می خواهید داده ها را از یک API دریافت کنید و آنها را در یک صفحه گسترده Google Sheets ذخیره کنید.

1. نود HTTP Request را به گردش کار خود اضافه کنید و endpoint API را پیکربندی کنید.
2. نود Google Sheets را به گردش کار خود اضافه کنید و آن را به نود HTTP Request متصل کنید.
3. اطلاعات حساب Google خود را در نود Google Sheets پیکربندی کنید.
4. Spreadsheet ID و Sheet Name را مشخص کنید.
5. Operation را روی “Append Data” تنظیم کنید.
6. داده های API را در فرمت مناسب برای نوشتن در صفحه گسترده تبدیل کنید.
7. روی دکمه “Execute Node” کلیک کنید تا نود اجرا شود.

پس از اجرای نود، داده های API در انتهای صفحه گسترده اضافه می شوند.

سناریوهای کاربردی نود Google Sheets

• خواندن داده ها از صفحات گسترده: خواندن داده ها برای استفاده در گردش کارهای دیگر.
• نوشتن داده ها در صفحات گسترده: ذخیره داده ها از منابع مختلف در یک مکان مرکزی.
• به روز رسانی سلول ها: به روز رسانی مقادیر سلول ها بر اساس داده های جدید.
• ایجاد صفحات گسترده جدید: ایجاد صفحات گسترده جدید به صورت خودکار.
• اتوماسیون گزارش گیری: ایجاد گزارش های خودکار بر اساس داده های ذخیره شده در صفحات گسترده.

نود Webhook

نود Webhook به شما امکان می دهد گردش کار خود را با دریافت درخواست های HTTP از منابع خارجی فعال کنید. این نود برای ادغام با سایر سیستم ها و سرویس ها بسیار مفید است.

نحوه استفاده از نود Webhook

برای استفاده از نود Webhook، ابتدا باید آن را به گردش کار خود اضافه کنید. سپس، باید URL Webhook را پیکربندی کنید. این URL یک آدرس منحصر به فرد است که می توانید از آن برای ارسال درخواست های HTTP به گردش کار خود استفاده کنید.

پارامترهای اصلی نود Webhook:

• Webhook URL: URL Webhook که برای فعال کردن گردش کار استفاده می شود.
• Method: متد HTTP که Webhook از آن پشتیبانی می کند (GET، POST، PUT، DELETE، PATCH).
• Response: پاسخی که Webhook به درخواست ارسال می کند.

مثال استفاده از نود Webhook

فرض کنید می خواهید هر زمان که یک فرم در وب سایت شما ارسال می شود، یک گردش کار را فعال کنید.

1. نود Webhook را به گردش کار خود اضافه کنید.
2. Webhook URL را کپی کنید.
3. Webhook URL را در تنظیمات فرم وب سایت خود پیکربندی کنید.
4. هر زمان که یک فرم ارسال می شود، وب سایت شما یک درخواست HTTP به Webhook URL ارسال می کند و گردش کار شما فعال می شود.

سناریوهای کاربردی نود Webhook

• ادغام با سرویس های خارجی: فعال کردن گردش کارها از طریق رویدادهای رخ داده در سرویس های دیگر.
• ایجاد API های سفارشی: ایجاد API هایی که می توانند برای فعال کردن گردش کارها استفاده شوند.
• اتوماسیون پاسخ به فرم ها: پردازش داده های فرم و انجام اقدامات مناسب.
• مانیتورینگ رویدادها: نظارت بر رویدادهای خاص و انجام اقدامات مناسب.

“`