راهنمای ورک‌فلوحدود ۳ دقیقه مطالعه
تنظیم Credential در n8n بعد از Import؛ راهنمای سریع
ورک‌فلو را وارد کرده‌اید اما نودها به حساب شما وصل نیستند؟ با این راهنمای کوتاه، Credential خودتان را انتخاب یا بسازید، اتصال را آزمایش کنید و خطاهای رایج را بررسی کنید.
تنظیمات مطالعه ۰٪
۱۶
فایل ورک‌فلو را وارد n8n کرده‌اید، اما یکی از نودها اتصال حساب می‌خواهد یا خطای احراز هویت نشان می‌دهد؟ قدم بعدی، تنظیم Credential خودتان است. این راهنما با مثال تلگرام نشان می‌دهد کدام بخش را تکمیل کنید و نتیجه اتصال را چطور بررسی کنید.
Credential چیست و چرا بعد از Import لازم می‌شود؟
Credential همان اطلاعات احراز هویت n8n برای ارتباط با یک سرویس است؛ مثلاً توکن ربات تلگرام یا دسترسی یک حساب. Import ساختار ورک‌فلو را می‌آورد، اما اتصال ذخیره‌شده در فایل لزوماً در محیط شما وجود ندارد. تغییر نام یک اتصال قدیمی هم جای ساخت یا انتخاب دسترسی معتبر خودتان را نمی‌گیرد.
۱. اتصال موردنیاز نود را پیدا کنید
نودی را که اتصال می‌خواهد باز کنید. از فهرست Credential، اتصال مناسب همان سرویس را انتخاب کنید. اگر اتصال ندارید، گزینه ساخت Credential جدید را بزنید. نام گزینه‌ها ممکن است بین نسخه‌ها فرق کند. مطمئن شوید حساب انتخاب‌شده به همان پروژه و سرویسی تعلق دارد که قصد استفاده از آن را دارید.
۲. اطلاعات حساب خودتان را وارد کنید؛ مثال تلگرام
برای نود Telegram به توکن یک ربات نیاز دارید. اگر ربات ندارید، در حساب رسمی BotFather دستور /newbot را اجرا کنید و مراحل نام‌گذاری را انجام دهید. سپس توکن ربات خودتان را در فیلد Access Token مربوط به Telegram Credential قرار دهید و اتصال را ذخیره کنید.
یک نام روشن مثل «ربات پشتیبانی فروشگاه» برای Credential بگذارید. توکن را داخل متن پیام نود یا فیلد Chat ID وارد نکنید. Chat ID مقصد پیام است؛ Credential هویت ربات را مشخص می‌کند. اگر از قبل اتصال معتبر دارید، همان را انتخاب کنید و نیازی به ساخت ربات تازه نیست.
۳. اتصال را آزمایش کنید
نتیجه بررسی اتصال هنگام ذخیره را ببینید. موفق‌بودن این بررسی به‌تنهایی به معنی درست‌بودن همه تنظیمات ورک‌فلو نیست. برای مثال، نود ارسال پیام تلگرام علاوه بر توکن معتبر به مقصد درست و امکان ارسال پیام به آن مقصد نیاز دارد. یک اجرای محدود با حساب و مقصد آزمایشی خودتان انجام دهید و پاسخ نود را بخوانید.
اگر اتصال برقرار نشد، از اینجا شروع کنید
- اتصال پیدا نمی‌شود: Credential را در فضای کاری قابل دسترس بسازید و دوباره در خود نود انتخاب کنید.
- خطای 401 یا 403: اطلاعات ورود، اعتبار توکن و مجوز عملیات را طبق پاسخ سرویس بررسی کنید. توکن متعلق به ربات یا حساب دیگری نباشد.
- تست اتصال موفق است، اما عملیات شکست می‌خورد: پارامترهای همان عملیات، مثل Chat ID و دسترسی به مقصد پیام را بررسی کنید.
- Timeout یا خطای شبکه: آدرس سرویس و امکان دسترسی از محیط اجرای n8n را بررسی کنید؛ تغییر توکن الزاماً این مشکل را حل نمی‌کند.
پیش از اجرای اصلی
اتصال‌های بقیه نودها را هم بررسی کنید؛ یک ورک‌فلو ممکن است چند Credential جدا داشته باشد. بعد از تأیید نتیجه آزمایشی، اجرای اصلی را فعال کنید. توکن و اطلاعات ورود را در تصویر، پیام پشتیبانی یا فایل عمومی منتشر نکنید.
برای شروع از پایه، آموزش فارسی n8n و اولین ورک‌فلو را ببینید. برای تمرین روی یک سناریوی آماده، نمونه رایگان تولید محتوا و آموزش راه‌اندازی در دسترس است؛ ابزارهای موردنیاز هر فایل هم در کتابخانه ورک‌فلوهای آماده معرفی شده‌اند.
منابع: ساخت و ویرایش Credential در مستندات n8n و راهنمای Telegram Credential.