گردشکارهای n8n
AI-School میتواند گردشکارهای n8n را از طریق production webhook شروع کند. این زمانی کاربرد دارد که بخواهید خارج از AI-School یک فرآیند خودکار را اجرا کنید؛ برای نمونه ساخت یک وظیفه، بهروزرسانی یک رکورد CRM، شروع یک جریان گزارشگیری یا ارسال دادههای فرم به یک سیستم دیگر.
مثال: خبر در وبسایت مدرسه
فرض کنید مدرسه یک workflow در n8n ساخته است که یک خبر را در وبسایت WordPress منتشر میکند. در AI-School کاربر فقط یک متن کوتاه وارد میکند، مثلاً چند جمله درباره هفته پروژه، روز ورزش یا روز بازدید. همین متن workflow را در n8n شروع میکند.
سپس workflow در n8n میتواند مثلاً:
- متن کوتاه را با یک LLM node و prompt مناسب با لحن مدرسه به یک پیشنویس خوب تبدیل کند.
- با یک LLM node دوم، یک تصویرسازی مناسب بسازد، مثلاً با رنگهای مدرسه و سبک تصویرسازی قابل تشخیص.
- متن و تصویر را به عنوان blog post در وبسایت WordPress آماده یا منتشر کند.
اینگونه AI-School و n8n با هم کار میکنند: در AI-School کاربر workflow را انتخاب میکند و اطلاعات لازم را وارد میکند. سپس n8n مراحل خودکار را اجرا میکند و مطمئن میشود خبر مرتب روی وبسایت قرار میگیرد.
این یکپارچهسازی چه کاری انجام میدهد؟
گردشکار n8n در AI-School یک چت AI نیست. گردشکار مستقیماً از نمای کلی workflows شروع میشود.
- اگر گردشکار فیلدی نداشته باشد، webhook بلافاصله اجرا میشود.
- اگر گردشکار فیلد داشته باشد، ابتدا یک پنجره باز میشود. کاربر فرم را تکمیل میکند و سپس گردشکار را با دکمه شروع میکند.
- مقادیر واردشده به صورت JSON در یک درخواست POST به n8n webhook ارسال میشوند.
ساخت گردشکار n8n در AI-School
مدیر گردشکار را به این شکل ثبت میکند:
- به Assistants بروید.
- Workflows را باز کنید.
- New n8n workflow را انتخاب کنید.
- نام گردشکار و Production URL مربوط به n8n را وارد کنید.
- Header authentication را با نام header و مقدار محرمانه header تنظیم کنید.
- در صورت نیاز فیلدهایی را اضافه کنید که باید در درخواست POST ارسال شوند.
- گردشکار را ذخیره کنید.
فیلدها
- فیلدها اختیاری هستند.
- هر فیلد یک نام و یک نوع دارد.
- نوعهای پشتیبانیشده شامل متن کوتاه، متن بلند، عدد، بله/خیر و تاریخ هستند.
- فیلدهای اجباری باید پیش از شروع گردشکار تکمیل شوند.
- نام فیلد به key در JSON body ارسالشده به n8n تبدیل میشود.
ساخت گردشکار سازگار در n8n
- در n8n یک گردشکار جدید بسازید.
- یک Webhook Trigger را به عنوان اولین node اضافه کنید.
- HTTP Method را روی POST تنظیم کنید.
- Header authentication را در n8n پیکربندی کنید. همان نام و مقدار header را که در برنامه وارد کردهاید استفاده کنید.
- Production URL مربوط به webhook را کپی کنید. از URL آزمایشی استفاده نکنید.
- گردشکار را در n8n فعال کنید.
- از JSON body دریافتشده در nodeهای بعدی n8n استفاده کنید.
نمونه JSON body
اگر فیلدهایی با نامهای prompt، customerName و date تعریف کنید، n8n برای مثال این JSON body را دریافت میکند:
{
"prompt": "یک خلاصه کوتاه از درخواست بساز.",
"customerName": "سازمان نمونه",
"date": "2026-09-22"
}
محدودیتهای مهم
- فقط Webhook Triggers پشتیبانی میشوند.
- فقط production webhook URLs پشتیبانی میشوند.
- URLهای آزمایشی webhook که شامل
/webhook-test/باشند رد میشوند. - فقط POST پشتیبانی میشود.
- فقط generic header authentication پشتیبانی میشود.
- مقدار header در برنامه به عنوان اطلاعات محرمانه در نظر گرفته میشود.
- tenant در سمت سرور از روی کاربر واردشده تعیین میشود، نه از مقداری که مرورگر ارسال می کند.
رفع اشکال
- 404 یا webhook ثبت نشده است: گردشکار را در n8n فعال کنید و از Production URL استفاده کنید.
- خطای احراز هویت: بررسی کنید نام و مقدار header در هر دو سیستم دقیقاً یکسان باشند.
- دادههای ناقص: بررسی کنید نام فیلدها در برنامه با keyهایی که n8n انتظار دارد یکسان باشند.
- در n8n درخواستی دیده نمیشود: بررسی کنید گردشکار با Webhook Trigger شروع شود و از POST استفاده کند.
