به اشتراک بگذارید
موارد فنی | بلاگ وبداده
اتصال ربات تلگرام به n8n؛ آموزش اتوماسیون پیامرسان
از ساخت ربات با BotFather تا فعالسازی ورکفلو، گامبهگام یاد میگیرید چطور تلگرام را به n8n وصل کنید و کارهای تکراری را خودکار کنید.
اتصال تلگرام به n8n به شما اجازه میدهد پیامهای ربات را به یک ابزار قدرتمند اتوماسیون متصل کنید و بدون نوشتن کد، فرایندهای تکراری مثل پاسخ خودکار، اعلان و جمعآوری داده را بهصورت بصری بسازید. در این راهنما ابتدا توضیح میدهیم این اتصال چه کاربردی دارد، بعد پیشنیازها را فهرست میکنیم، سپس مرحلهبهمرحله از ساخت ربات تا فعالسازی ورکفلو پیش میرویم، تفاوت اجرای ابری و نصب روی سرور شخصی را در یک جدول مقایسه میکنیم و در پایان رایجترین خطاها و محدودیتها را صادقانه مرور میکنیم تا از صفر تا صد بدون گیر کردن کار را انجام دهید.
- دو ابزار، یک پل: ربات را با BotFather میسازید و توکن آن را بهعنوان Credential در n8n وارد میکنید.
- شروعگر ورکفلو: نود Telegram Trigger با هر پیام جدید ربات، ورکفلو را اجرا میکند.
- پیشنیاز کلیدی: برای کار وبهوک، نمونه n8n باید از طریق اینترنت و با HTTPS قابل دسترس باشد.
- بدون کدنویسی: همهچیز با کشیدن نودها و تنظیم چند فیلد در رابط گرافیکی n8n انجام میشود.
- دو مسیر میزبانی: میتوانید از نسخه ابری n8n استفاده کنید یا آن را روی سرور مجازی خودتان نصب کنید.
در یک جمله
n8n نقش یک «مرکز فرماندهی» را بازی میکند که پیامهای ربات تلگرام را دریافت و بر اساس منطقی که شما طراحی میکنید، بهصورت خودکار پاسخ میدهد یا آنها را به سرویسهای دیگر میفرستد — و همه اینها روی سروری اجرا میشود که در وبداده میتوانید تهیه کنید.
حتماً این مقاله را باز کردهاید چون میخواهید یک ربات تلگرام هوشمند بسازید اما نمیدانید از کجا شروع کنید. در ادامه بهجای کلیگویی، یک مسیر روشن و عملی پیش پایتان میگذاریم تا قدمبهقدم به یک اتوماسیون کارآمد برسید.
اتصال تلگرام به n8n چیست و چه کاربردی دارد؟
n8n یک ابزار اتوماسیون گردشکار (workflow automation) متنباز است که به شما اجازه میدهد سرویسهای مختلف را بدون کدنویسی به هم وصل کنید. وقتی این ابزار را به ربات تلگرام متصل میکنید، میتوانید هر اتفاقی در چت ربات (مثل دریافت یک پیام) را به یک زنجیره از کارهای خودکار تبدیل کنید؛ از ارسال پاسخ آماده گرفته تا ثبت اطلاعات در گوگلشیت یا فراخوانی یک هوش مصنوعی.
این اتصال از دو طرف ساخته میشود. در سمت تلگرام، یک ربات با کمک BotFather ایجاد میشود که یک «توکن دسترسی» یکتا به شما میدهد. در سمت n8n، این توکن بهعنوان اعتبارنامه (Credential) وارد میشود و سپس نودهای تلگرام میتوانند پیامها را دریافت و ارسال کنند. به این ترتیب n8n به نمایندگی از ربات شما با کاربران گفتگو میکند.
مهمترین مزیت این روش، حذف نیاز به برنامهنویسی است. بهجای نوشتن یک سرور و مدیریت دستی Bot API تلگرام، کافی است نودها را روی بوم n8n بچینید و منطق کار را بهصورت بصری طراحی کنید. همین سادگی باعث شده ساخت رباتِ پشتیبانی، اعلان فروش، یا دستیار شخصی در تلگرام به کاری چنددقیقهای تبدیل شود.
تشبیه ساده
ربات تلگرام را مثل یک منشی تصور کنید که فقط پیامها را میگیرد و میدهد، و n8n را مثل مغز پشت آن منشی که تصمیم میگیرد با هر پیام چه کند. توکن BotFather هم مثل کلیدی است که این دو را به هم وصل میکند و اجازه گفتگو میدهد.
پیشنیازهای لازم برای شروع
پیش از آنکه سراغ مراحل برویم، مطمئن شوید این چهار مورد را آماده دارید. نبودِ هرکدام، شما را وسط راه متوقف میکند؛ پس همین ابتدا تیکشان بزنید:
۱) حساب تلگرام فعال
برای ساخت ربات به یک حساب کاربری معمولی تلگرام نیاز دارید تا بتوانید با BotFather گفتگو کنید و دستور ساخت ربات را اجرا کنید.
۲) دسترسی به n8n
یا یک حساب در نسخه ابری n8n داشته باشید، یا n8n را روی سرور خودتان نصب کرده باشید. در حالت نصب شخصی، سرور باید با HTTPS از اینترنت قابل دسترس باشد.
۳) توکن ربات (Access Token)
همان رشتهای که BotFather پس از ساخت ربات به شما میدهد. این توکن کلید اصلی اتصال است و باید آن را محرمانه نگه دارید.
۴) یک هدف مشخص
بدانید ربات قرار است چه کند: پاسخ خودکار بدهد، اعلان بفرستد یا داده ثبت کند. داشتن هدف روشن، طراحی ورکفلو را بسیار سادهتر میکند.
نکته مهم درباره میزبانی n8n
اگر n8n را خودتان روی سرور نصب میکنید، تلگرام برای ارسال پیامها به n8n از «وبهوک» استفاده میکند و این یعنی سرور شما باید یک آدرس عمومی با گواهی SSL (HTTPS) داشته باشد. روی لوکالهاست یا سروری که از بیرون در دسترس نیست، تریگر تلگرام کار نمیکند. نسخه ابری n8n این زیرساخت را بهصورت آماده در اختیار میگذارد.
آموزش گامبهگام؛ از ساخت ربات تا فعالسازی
حالا که پیشنیازها آماده است، مراحل را به ترتیب پیش میرویم. هر مرحله مستقل است؛ تا یکی کامل نشده، سراغ بعدی نروید.
مرحله ۱: ساخت ربات و گرفتن توکن از BotFather
در تلگرام عبارت BotFather را جستجو کنید و وارد چت حساب رسمی آن (با تیک آبی) شوید. دستور /newbot را بفرستید. BotFather ابتدا یک «نام نمایشی» و سپس یک «یوزرنیم» از شما میخواهد. طبق مستندات تلگرام، یوزرنیم باید بین ۵ تا ۳۲ کاراکتر، فقط شامل حروف لاتین، عدد و آندرلاین باشد و حتماً به کلمه bot ختم شود (مثلاً my_shop_bot). پس از تأیید، BotFather یک «توکن دسترسی» به شما میدهد؛ آن را کپی و در جای امنی نگه دارید.
مرحله ۲: ساخت Credential تلگرام در n8n
وارد n8n شوید و از بخش Credentials یک اعتبارنامه جدید از نوع Telegram API بسازید. توکنی را که از BotFather گرفتهاید در فیلد Access Token بچسبانید و ذخیره کنید. n8n بهصورت خودکار اتصال را تست میکند؛ اگر توکن درست باشد، اعتبارنامه با موفقیت ذخیره میشود و از این پس همه نودهای تلگرام میتوانند از آن استفاده کنند.
مرحله ۳: افزودن نود Telegram Trigger و انتخاب رویداد
یک ورکفلو جدید بسازید و بهعنوان اولین نود، Telegram Trigger را اضافه کنید. این نود همان شروعگر است که با دریافت پیام، ورکفلو را روشن میکند. اعتبارنامهای را که در مرحله قبل ساختید انتخاب کنید. سپس در بخش Updates مشخص کنید به چه رویدادهایی گوش بدهد؛ گزینههای رایج عبارتاند از:
- message: دریافت پیامهای متنی و رسانهای عادی (پرکاربردترین گزینه).
- callback_query: فشردن دکمههای شیشهای (inline) زیر پیامها.
- edited_message: ویرایش پیام توسط کاربر.
- channel_post: انتشار پست در کانالی که ربات در آن ادمین است.
مرحله ۴: فعالسازی ورکفلو و ثبت خودکار وبهوک
برای اینکه تریگر بهصورت دائمی به پیامها گوش بدهد، باید ورکفلو را فعال (Activate) کنید. با این کار، n8n بهصورت خودکار یک وبهوک نزد API تلگرام ثبت میکند تا هر پیام جدید مستقیماً به n8n ارسال شود. این نکته را به خاطر بسپارید: در نصب self-hosted، فعالسازی تنها زمانی موفق است که سرور شما آدرس عمومی HTTPS داشته باشد.
مرحله ۵: افزودن نود پاسخ و تست نهایی
حالا یک نود Telegram (اکشن) بعد از تریگر اضافه کنید و عملیات Send Message را انتخاب کنید. در فیلد Chat ID مقدار chat id را از خروجی تریگر بردارید و متن پاسخ را بنویسید. ربات را در تلگرام باز کنید و یک پیام تستی بفرستید؛ اگر همهچیز درست باشد، پاسخ خودکار را دریافت میکنید و داده پیام را هم در خروجی نود تریگر میبینید.
بررسی صحت عملکرد
بهترین راه آزمایش، فرستادن چند نوع پیام مختلف (متن، دکمه، فایل) به ربات و تماشای خروجی هر نود در n8n است. اگر دادهها در نود تریگر ظاهر میشوند اما پاسخی نمیگیرید، مشکل معمولاً در تنظیم Chat ID یا اعتبارنامه نود ارسال است، نه در تریگر.
n8n ابری یا نصب روی سرور خودتان؟ جدول مقایسه
برای راهاندازی ربات، دو مسیر اصلی دارید: استفاده از نسخه ابری آماده n8n، یا نصب n8n روی سرور مجازی خودتان (self-hosted). جدول زیر تفاوتهای کلیدی این دو را برای تصمیمگیری کنار هم میگذارد:
| معیار | n8n ابری (Cloud) | نصب روی سرور خودتان |
|---|---|---|
| راهاندازی | آماده و سریع، بدون نصب | نیازمند نصب و پیکربندی روی سرور |
| دسترسی HTTPS برای وبهوک | بهصورت پیشفرض فراهم است | خودتان باید دامنه و SSL را تنظیم کنید |
| کنترل روی دادهها | داده روی زیرساخت ارائهدهنده | داده کاملاً روی سرور خودتان |
| امکان سفارشیسازی | محدود به امکانات سرویس | کامل؛ دسترسی ریشه به سرور |
| هزینه | اشتراک ماهانه سرویس | هزینه سرور مجازی + زمان مدیریت |
| مناسب برای | شروع سریع و کمدردسر | پروژههای جدی، حریم داده و حجم بالا |
اگر تازهکار هستید، شروع با نسخه ابری سادهتر است؛ اما برای کنترل کامل روی دادهها و اجرای پایدار رباتِ پرترافیک، نصب n8n روی یک سرور مجازی اختصاصی انتخاب حرفهایتری است. برای زمانبندی اجرای خودکار کارها هم میتوانید از کرون جاب روی سرور کمک بگیرید.
از منابع معتبر
طبق مستندات رسمی n8n، نود Telegram Trigger با فعالشدن ورکفلو «بهصورت خودکار یک وبهوک نزد تلگرام ثبت میکند» و برای دریافت رویدادها، نمونه n8n باید از طریق HTTPS در دسترس باشد. منبع: n8n Docs — Telegram Trigger node.
عیبیابی مشکلات رایج
اگر اتصال طبق انتظار کار نکرد، معمولاً یکی از این موارد دلیلش است. قبل از هر تغییر بزرگ، این فهرست را مرور کنید:
- ربات پاسخ نمیدهد: مطمئن شوید ورکفلو در حالت Active است؛ در حالت تست، تریگر فقط یکبار اجرا میشود.
- خطای وبهوک در نصب شخصی: اغلب بهخاطر نبودِ HTTPS یا در دسترس نبودن سرور از اینترنت است؛ دامنه و گواهی SSL را بررسی کنید.
- تداخل دو ورکفلو با یک ربات: هر ربات همزمان فقط میتواند یک وبهوک فعال داشته باشد؛ استفاده همزمان دو ورکفلو از یک توکن باعث خطا میشود.
- پیام ارسال نمیشود: Chat ID را از خروجی تریگر بردارید و اعتبارنامه نود ارسال را دوباره چک کنید.
- توکن نامعتبر: اگر توکن را لو دادید یا گم کردید، با دستور بازتولید توکن در BotFather یکی جدید بگیرید و Credential را بهروزرسانی کنید.
محدودیتها و نکاتی که باید بدانید
این روش بسیار قدرتمند است، اما بیعیب نیست. شناخت محدودیتها کمک میکند انتظار درستی داشته باشید:
- وابستگی به زیرساخت: در نصب شخصی، اگر سرور یا اینترنت قطع شود، ربات هم از کار میافتد؛ پایداری سرور اهمیت مستقیم دارد.
- نیاز به دامنه و SSL: راهاندازی self-hosted برای کاربر کاملاً تازهکار کمی چالشبرانگیز است و دانش پایه سرور میخواهد.
- محدودیتهای API تلگرام: تلگرام برای تعداد پیام در ثانیه محدودیت دارد؛ رباتِ خیلی پرترافیک باید این سقفها را رعایت کند.
- مدیریت و نگهداری: نسخه self-hosted نیازمند بهروزرسانی منظم n8n و بکاپگیری از ورکفلوها و اعتبارنامههاست.
برای راهاندازی امن سرور و دسترسی مدیریتی، راهنمای فعال کردن یوزر روت در اوبونتو میتواند نقطه شروع خوبی باشد.
اجرای پایدار n8n روی سرور مجازی وبداده
برای اینکه ربات تلگرامی شما همیشه آنلاین و پاسخگو بماند، به سروری نیاز دارید که هم دسترسی عمومی HTTPS بدهد و هم پایدار باشد. در وبداده، سرور مجازی با همین هدف فراهم شده تا بتوانید n8n را بهصورت self-hosted نصب کنید و کنترل کامل روی دادهها و ورکفلوهای ربات خود داشته باشید.
✅ زیرساخت نسل جدید HPE (Gen11 و Gen10) برای پایداری و کارایی بالای سرویس.
✅ دیتاسنترهای ایران، هلند و آلمان برای انتخاب نزدیکترین لوکیشن به کاربران ربات.
✅ امکان ارتقای منابع متناسب با رشد ترافیک ربات، بدون نیاز به مهاجرت.
✅ پشتیبانی فنی ۲۴ ساعته برای کمک در راهاندازی سرور و رفع مشکلات اتصال.
✅ دیتاسنترهای ایران، هلند و آلمان برای انتخاب نزدیکترین لوکیشن به کاربران ربات.
✅ امکان ارتقای منابع متناسب با رشد ترافیک ربات، بدون نیاز به مهاجرت.
✅ پشتیبانی فنی ۲۴ ساعته برای کمک در راهاندازی سرور و رفع مشکلات اتصال.
میتوانید پلنها را در صفحه سرور مجازی وبداده ببینید؛ اگر هدف اصلی شما کار با تلگرام است، سرور مخصوص تلگرام هم گزینهای متناسب با همین کاربری است.
پرسشهای پرتکرار درباره اتصال n8n و تلگرام
برای اتصال ربات تلگرام به n8n به دانش برنامهنویسی نیاز دارم؟
نه. کل فرایند بدون کدنویسی و با چیدن نودها در رابط گرافیکی n8n انجام میشود. تنها چیزی که لازم دارید، توکن ربات از BotFather و کمی آشنایی با مفهوم ورکفلو است. برای نصب self-hosted روی سرور، دانش پایه مدیریت سرور هم کمککننده است.
توکن ربات را از کجا بیاورم؟
از BotFather در تلگرام. کافی است دستور /newbot را بفرستید، نام و یوزرنیم ربات را تعیین کنید و BotFather یک توکن دسترسی یکتا به شما میدهد. این توکن کلید اتصال است و باید آن را محرمانه نگه دارید.
چرا تریگر تلگرام در نصب شخصی n8n کار نمیکند؟
چون تلگرام برای ارسال پیامها به وبهوک نیاز دارد و این یعنی سرور n8n شما باید از اینترنت با آدرس HTTPS قابل دسترس باشد. روی لوکالهاست یا سروری بدون دامنه و SSL، ثبت وبهوک شکست میخورد. تنظیم درست دامنه و گواهی SSL این مشکل را حل میکند.
تفاوت نسخه ابری n8n و نصب روی سرور خودم چیست؟
نسخه ابری آماده است و زیرساخت HTTPS را خودش فراهم میکند، اما کنترل و سفارشیسازی محدودتری دارد. نصب روی سرور شخصی کنترل کامل روی دادهها و امکانات میدهد اما به راهاندازی و نگهداری نیاز دارد. انتخاب به سطح مهارت و حساسیت پروژه شما بستگی دارد.
میتوانم یک ربات را همزمان به دو ورکفلو وصل کنم؟
هر ربات تلگرام در هر لحظه فقط میتواند یک وبهوک فعال داشته باشد. اگر دو ورکفلو همزمان از یک توکن استفاده کنند، با هم تداخل پیدا میکنند. راهکار درست این است که منطق مختلف را داخل یک ورکفلو شاخهبندی کنید یا برای هر کاربرد یک ربات جدا بسازید.
ربات میتواند به دکمهها و فایلها هم واکنش نشان دهد؟
بله. در نود Telegram Trigger میتوانید علاوه بر پیام متنی، رویدادهایی مثل فشردن دکمههای شیشهای (callback_query) یا دریافت فایل را هم فعال کنید و در ورکفلو برای هرکدام پاسخ مناسب طراحی کنید.
اگر توکن رباتم لو برود چه کنم؟
بلافاصله در BotFather توکن را بازتولید (Revoke) کنید تا توکن قبلی باطل شود، سپس توکن جدید را در اعتبارنامه n8n بهروزرسانی کنید. توکن مثل رمز عبور ربات است؛ هرگز آن را در جای عمومی منتشر نکنید.
برای میزبانی یک ربات تلگرام چه سروری مناسب است؟
سروری که دسترسی عمومی HTTPS، پایداری بالا و منابع کافی برای ترافیک ربات داشته باشد. سرور مجازی وبداده با امکان ارتقای منابع و پشتیبانی ۲۴ ساعته برای اجرای self-hosted ابزارهایی مثل n8n گزینه مناسبی است.
جمعبندی و قدم بعدی شما
دیدیم که وصلکردن ربات تلگرام به n8n یک مسیر روشن دارد: ربات را با BotFather میسازید، توکن را بهعنوان Credential در n8n وارد میکنید، نود Telegram Trigger را اضافه و رویداد دلخواه را انتخاب میکنید، ورکفلو را فعال میکنید و با یک نود ارسال، پاسخ خودکار میدهید. مهمترین نکته زیرساختی هم این بود که برای کار وبهوک، نمونه n8n باید با HTTPS از اینترنت در دسترس باشد. با رعایت همین چند اصل، از صفر تا یک اتوماسیون کارآمد فاصله زیادی ندارید.
جمعبندی سریع
✅ ربات و توکن را از BotFather بگیرید.
✅ توکن را در Credential تلگرام n8n وارد کنید.
✅ نود Telegram Trigger را اضافه و ورکفلو را فعال کنید.
✅ برای اجرای پایدار، n8n را روی سرور مجازی با HTTPS نصب کنید.
✅ توکن را در Credential تلگرام n8n وارد کنید.
✅ نود Telegram Trigger را اضافه و ورکفلو را فعال کنید.
✅ برای اجرای پایدار، n8n را روی سرور مجازی با HTTPS نصب کنید.
در صورتی که سوالی داشتید میتوانید در بخش نظرات با ما در ارتباط باشید.
منابع: n8n Docs — Telegram Trigger node؛ n8n Docs — Telegram credentials؛ و مستندات BotFather در Telegram Bot API.
