مقدمه
ربات تلگرام با n8n:
N8Nابزاری است که به کمک آن می توانید در مدتزمان کوتاهی، فرایندهای خود را با هوش مصنوعی خودکار کنید و از مزایای اتوماسیون هوشمند بهره مند شوید.
N8N برای چه کسب و کارهایی مناسب است:
اگر سازمان شما کوچک می باشد و هم اکنون بسیاری از کار های خود را با نرم افزار هایی همچون اکسل انجام می دهید، N8N برای کسب و کار شما ایده آل است و در صورتی که کسب و کاری متوسط یا بزرگ دارید می توانید بخش های بسیاری از فرایند های غیر کلیدی خود را با این ابزار هوشمند کنید.
اگر به پیادهسازی اختصاصی، اتصال n8n به نرمافزارهای سازمانی یا سفارشیسازی Workflowها متناسب با کسبوکارتان نیاز دارید، Danix با بررسی نیازهای کسبوکار تان، میتواند این فرایند را از طراحی تا استقرار برای شما انجام دهیم.
برای کسب و کارهای کوچک به این لینک مراجعه کنید و برای کسب و کارهای بزرگ و متوسط میتوانید از این لینک استفاده نمایید.
همچنین اگر ترجیح میدهید شخصاً نصب و راهاندازی را انجام دهید، میتوانید از اطلاعات موجود در مقالات، دسته N8N استفاده کنید .همچنین می توانید template موجود در این workflow را به صورت رایگان از این قسمت دانلود کنید.
ربات تلگرام با n8n
مقدمه
دیگر نیازی نیست برای ساخت یک ربات هوشمند که هم گفتگو کند و هم تصویر بسازد، حتماً یک تیم برنامهنویسی بزرگ داشته باشید. ساخت ربات تلگرام با n8n و یک Workflow آماده، این مسیر پیچیده را برای شما هموار میکند. ما در این مقاله، یک سناریوی جذاب را بررسی میکنیم: ساخت رباتی که به سرویسهای هوش مصنوعی متصل میشود تا دو خروجی متفاوت ارائه دهد؛ پاسخهای متنی هوشمند و تصاویر ساختهشده با هوش مصنوعی.
هوشمندی این ساختار در مدیریت هوشمند جریان دادهها نهفته است. به محض اینکه پیام کاربر وارد n8n میشود، سیستم بلافاصله تشخیص میدهد که آیا مخاطب به دنبال گفتوگو است یا میخواهد با دستور /flux یک تصویر خلق کند. پس از این تصمیمگیری، Workflow درخواست را به API مربوطه میفرستد و در نهایت، نتیجه را مستقیماً به چت کاربر بازمیگرداند.
این Template یک نقطه شروع ایدهآل برای کاربران از سطح مبتدی تا متوسط است. ما در طراحی این مسیر، نه تنها جریان اصلی را در نظر گرفتهایم، بلکه بخشهای مدیریت خطا و نمایش وضعیت پردازش را نیز برای بهبود تجربه کاربری اضافه کردهایم.
قبل از شروع
اگر هنوز با n8n آشنایی ندارید، پیشنهاد میکنم ابتدا مقاله «آموزش n8n» را مطالعه کنید. در آنجا مراحل نصب با Node.js و Docker را بهطور کامل توضیح دادهایم. پس از اینکه محیط n8n را راهاندازی کردید، به این مقاله برگردید و مراحل ساخت ربات تلگرام با n8n را دنبال کنید.
این Workflow چه کاری انجام میدهد؟
طراحی ربات تلگرام با n8n در این پروژه دو وظیفه اصلی را بر عهده دارد. ابتدا، تمام پیامهای متنی کاربران را دریافت کرده و با استفاده از مدلهای زبانی، پاسخهای دقیق تولید میکند. در مرحله دوم، اگر کاربر دستور /flux را ارسال کند، ربات وارد مسیر تولید تصویر میشود.
جریان کار بسیار منظم است. ابتدا Telegram Trigger پیام را دریافت میکند و سپس یک Switch تصمیم میگیرد که مسیر حرکت به سمت شاخه تصویر باشد یا شاخه متن. اگر کاربر در چت خصوصی پیام دهد یا نام ربات را در گروه بیاورد، مسیر متنی فعال میشود. در نهایت، پس از فراخوانی APIها، ربات پاسخ یا تصویر را به کاربر تحویل میدهد. حتی اگر مشکلی پیش بیاید، سیستم با ارسال پیامهای خطای مناسب، کاربر را از وضعیت موجود باخبر میکند.
کاربردهای این Workflow
- طراحی دستیار هوشمند برای مدیریت دایرکت تلگرام
- تولید خودکار تصاویر محتوایی برای کانالهای تلگرامی
- ایجاد ابزار پرسش و پاسخ برای مشتریان
- ساخت نمونه اولیه (MVP) سریع برای استارتاپهای هوش مصنوعی
- راهاندازی رباتهای تعاملی در گروهها با استفاده از Mention
- ساخت ربات تلگرام با n8n برای آزمایش سریع مدلهای مختلف هوش مصنوعی در محیط واقعی
پیشنیازها
برای اجرای این پروژه، موارد زیر را آماده کنید:
۱. نصب بودن n8n روی سرور یا سیستم شخصی
۲. ساخت ربات تلگرام از طریق BotFather و دریافت Token
۳. داشتن حساب کاربری در NeurochainAI و دریافت API Key
۴. داشتن اعتبار کافی در حساب برای درخواستها
۵. آشنایی با نحوه Import کردن فایلهای JSON در n8n
نکته حیاتی: حتماً کلید API خود را در بخش Header دو Node از نوع HTTP Request جایگزین عبارت YOUR-API-KEY-HERE کنید. همچنین مطمئن شوید که تمامی Credentialهای تلگرام را بهدرستی تنظیم کردهاید.
رمز فایل : danixai.com
فایل JSON این Workflow را از این قسمت دانلود کنید.
آموزش Import کردن Workflow
برای بارگذاری و اجرای فایل پروژه مراحل زیر را طی کنید:
۱. وارد داشبورد n8n شوید.
۲. گزینه Import from File را انتخاب کنید.
۳. فایل JSON دانلود شده را در سیستم خود پیدا و انتخاب کنید.
۴. پس از بارگذاری، تنظیمات Credential (توکن تلگرام و کلید API) را اعمال کنید.
پس از انجام این steps، زیرساخت ربات تلگرام با n8n آماده پیکربندی نهایی خواهد بود.
ساختار Workflow و منطق تصمیمگیری
مرکز فرماندهی این ربات تلگرام با n8n، یک Node از نوع Switch است. این Node با بررسی محتوای پیام، کاربر را به یکی از سه مسیر زیر هدایت میکند:
- مسیر Flux: اگر پیام با
/fluxشروع شود، ربات مسیر تولید تصویر را برمیگزیند. - مسیر Text: اگر کاربر در گروه، نام ربات را (
@NCNAI_BOT) بیاورد، مسیر پاسخ متنی فعال میشود. - مسیر DM Text: اگر پیام در چت خصوصی (Private) ارسال شود، ربات مستقیماً وارد گفتوگو میشود.
این طراحی هوشمندانه باعث میشود ربات در گروهها مزاحم گفتگو نشود و فقط وقتی لازم است پاسخ دهد.
بررسی دقیق Nodeها
بخش ورود و شاخه تصویر (Nodes 1 to 5)
- Telegram Trigger: نقطه شروع کار که پیامها و دادههایی مثل متن و شناسه چت را دریافت میکند.
- Switch: تفکیک مسیرها بر اساس شرطهای
startsWithوcontainsبرای تشخیص تولید تصویر یا متن. - Code1: پاکسازی متن پیش از ارسال درخواست تصویر و حذف عبارت
/fluxبرای استخراج پرامپت خالص. - Telegram2: ارسال پیام موقت و نشانگر انتظار برای بهبود تجربه کاربری در زمان پردازش.
- NeurochainAI – Flux: ارسال درخواست تولید تصویر به API شامل مدل (مانند
flux1-schnell) و ابعاد تصویر.
پردازش تصویر و ارسال (Nodes 6 to 10)
- Code: استخراج لینک مستقیم تصویر از میان دادههای پیچیده دریافتی از API.
- HTTP Request3: دانلود فایل باینری تصویر از لینک مستقیم جهت ارسال به تلگرام.
- Telegram1: ارسال تصویر دانلود شده همراه با متن پرامپت کاربر به چت تلگرام.
- Telegram4: پاکسازی و حذف پیام موقت انتظار پس از ارسال موفقیتآمیز تصویر.
- Switch1: تشخیص نوع خطا در شاخه تصویر (مثلاً کوتاه بودن پرامپت).
مدیریت خطای تصویر و شاخه متنی (Nodes 11 to 15)
- Telegram6: نمایش پیام هشدار در صورت نامناسب یا کوتاه بودن پرامپت کاربر.
- Telegram7: حذف پیام انتظار در صورت بروز خطای پرامپت.
- Telegram3: ارسال پیام خطای عمومی سرور همراه با دکمه تلاش مجدد (Retry).
- Telegram5: پاکسازی پیام انتظار پس از بروز خطاهای عمومی.
- TYPING – ACTION: فعالسازی وضعیت «در حال تایپ…» در تلگرام برای ایجاد حس تعامل زنده.
پردازش متن و خطایابی (Nodes 16 to 21)
- NeurochainAI – REST API: ارسال پیام کاربر به مدلهای زبانی (مانند Llama 3.1) برای تولید پاسخ.
- AI Response: تحویل پاسخ متنی تولیدشده توسط هوش مصنوعی به چت تلگرام.
- Switch2: مدیریت و هدایت خطاهای احتمالی در بخش متنی.
- No response: اطلاعرسانی به کاربر در صورت عدم پاسخگویی سرور.
- Prompt too short: ارسال پیام راهنما در صورت کوتاه بودن ورودی متنی.
- Sticky Notes: یادداشتهای راهنما در محیط n8n برای توضیح بخشهای مختلف Workflow.
شخصیسازی و ارتقای ربات
شما میتوانید پروژه ربات تلگرام با n8n را مطابق نیاز خود تغییر دهید:
- تغییر لحن و نقش: در Node متنی بخش پرامپت را تغییر دهید تا ربات از یک دستیار ساده به معلم زبان یا مشاور تجاری تبدیل شود.
- انتخاب مدلهای مختلف: فهرست مدلها را بررسی کرده و با تغییر نام مدل، سرعت یا کیفیت پاسخها را مدیریت کنید.
- تولید تصاویر خاص: در شاخه Flux، پارامترهایی مثل ابعاد یا مدل تصویرساز را تغییر دهید.
- افزودن فرمانهای جدید: با اضافه کردن شرطهای جدید به Switch اصلی، دستوراتی مانند
/helpیا/settingsرا اضافه کنید.
مزایا و نکات کلیدی
طراحی ربات تلگرام با n8n مزایای متعددی مانند سرعت بالای راهاندازی و مدیریت هوشمند خطاها دارد. اما برای عملکرد بهتر، این نکات را به خاطر بسپارید:
- همیشه صحت API Key و توکن تلگرام خود را چک کنید.
- متن خطاها را به فارسی برگردانید تا کاربر ارتباط بهتری برقرار کند.
- اگر در گروهها از ربات استفاده میکنید، حتماً دسترسیها را محدود کنید تا از مصرف بیهوده اعتبار API جلوگیری شود.
رفع مشکلات رایج (Troubleshooting)
۱. ربات هیچ واکنشی نشان نمیدهد:
احتمالاً Token تلگرام را اشتباه وارد کردهاید یا Workflow را فعال (Activate) نکردهاید.
۲. خطای احراز هویت (Authentication Error):
مطمئن شوید که در قسمت Header، عبارت Bearer را قبل از کلید API قرار دادهاید.
۳. تصویر ساخته میشود اما ارسال نمیشود:
کد داخل Node مربوط به استخراج لینک تصویر را با فرمت جدید API هماهنگ کنید.
۴. پیام No response میآید:
مشکل از سمت سرویس هوش مصنوعی است. موجودی حساب خود را بررسی کرده یا کمی صبر کنید.
جمعبندی
ساخت ربات تلگرام با n8n، تجربهای هیجانانگیز، سریع و بدون نیاز به کدنویسی پیچیده است. این Workflow به شما اجازه میدهد پتانسیلهای عظیم هوش مصنوعی را در قالب پاسخ متنی و تولید تصویر در اختیار کاربران قرار دهید. این ساختار منعطف، پایهای قدرتمند برای پروژههای آتی شما خواهد بود.
سوالات متداول
۱. آیا میتوانم از مدلهای رایگان استفاده کنم؟
بله، بستگی به مدلهای ارائه شده توسط سرویس API دارد و میتوانید آنها را در تنظیمات جایگزین کنید.
۲. آیا ربات در گروهها هم کار میکند؟
بله، اما در فرایند ساخت ربات تلگرام با n8n تنظیم شده که در گروهها فقط با Mention پاسخ دهد.
۳. آیا برای اجرای این ربات نیاز به سرور دارم؟
برای فعال بودن ۲۴ ساعته ربات تلگرام با n8n، بهتر است n8n را روی یک VPS نصب کنید.
۴. چطور میتوانم زبان پاسخها را تغییر دهم؟
در System Prompt بنویسید: «لطفاً همیشه به زبان فارسی پاسخ بده».
۵. آیا این ربات تصاویر با کیفیت بالا تولید میکند؟
بله، مدل Flux یکی از قدرتمندترین مدلهای تولید تصویر با کیفیت بالا است.
۶. آیا میتوان تعداد تصاویر تولیدی را زیاد کرد؟
بله، با تغییر پارامتر n در درخواست API میتوانید تعداد تصاویر را افزایش دهید.
۷. آیا این روش برای پروژههای تجاری امن است؟
بله، اما پیشنهاد میکنیم لایههای امنیتی و محدودیت استفاده (Rate Limiting) را به Workflow اضافه کنید.
