مقدمه

ربات تلگرام NeurochainAI با n8n

ربات تلگرام NeurochainAI با n8n : دیگر نیازی نیست برای ساخت یک ربات هوشمند که هم گفتگو می‌کند و هم تصویر می‌سازد، حتماً یک تیم برنامه‌نویسی بزرگ داشته باشید. ترکیب n8n و یک Workflow آماده، این مسیر پیچیده را برای شما هموار می‌کند. ما در این مقاله، یک سناریوی جذاب را بررسی می‌کنیم: ساخت رباتی که به سرویس NeurochainAI متصل می‌شود تا دو خروجی متفاوت ارائه دهد؛ یکی پاسخ‌های متنی هوشمند و دیگری تصاویر ساخته‌شده با قدرت هوش مصنوعی.

هوشمندی این ساختار در مدیریت هوشمند جریان داده‌ها نهفته است. به محض اینکه پیام کاربر وارد n8n می‌شود، سیستم بلافاصله تشخیص می‌دهد که آیا مخاطب به دنبال گفت‌وگو است یا می‌خواهد با دستور /flux یک تصویر خلق کند. پس از این تصمیم‌گیری، Workflow درخواست را به API مربوطه می‌فرستد و در نهایت، نتیجه را مستقیماً به چت کاربر بازمی‌گرداند.

این Template یک نقطه شروع ایده‌آل برای کاربران از سطح مبتدی تا متوسط است. ما در طراحی این مسیر، نه تنها جریان اصلی را در نظر گرفته‌ایم، بلکه بخش‌های مدیریت خطا و نمایش وضعیت پردازش را نیز برای بهبود تجربه کاربری اضافه کرده‌ایم. در ادامه، تمام جزئیات از تنظیمات Nodeها تا روش‌های شخصی‌سازی را با هم مرور می‌کنیم.

قبل از شروع

ربات تلگرام NeurochainAI با n8n

اگر هنوز با n8n آشنایی ندارید، پیشنهاد می‌کنم ابتدا مقاله «آموزش n8n» را مطالعه کنید. در آنجا مراحل نصب با Node.js و Docker را به‌طور کامل توضیح داده‌ایم. پس از اینکه محیط n8n را راه‌اندازی کردید، به این مقاله برگردید و مراحل زیر را دنبال کنید.

این Workflow چه کاری انجام می‌دهد؟

ربات تلگرام NeurochainAI با n8n

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

جریان کار بسیار منظم است. ابتدا Telegram Trigger پیام را دریافت می‌کند و سپس یک Switch تصمیم می‌گیرد که مسیر حرکت به سمت شاخه تصویر باشد یا شاخه متن. اگر کاربر در چت خصوصی پیام دهد یا نام ربات را در گروه بیاورد، مسیر متنی فعال می‌شود. در نهایت، پس از فراخوانی APIهای NeurochainAI، ربات پاسخ یا تصویر را به کاربر تحویل می‌دهد. حتی اگر مشکلی پیش بیاید، سیستم با ارسال پیام‌های خطای مناسب، کاربر را از وضعیت موجود باخبر می‌کند.

کاربردهای این Workflow

ربات تلگرام NeurochainAI با n8n

• طراحی دستیار هوشمند برای مدیریت دایرکت تلگرام
• تولید خودکار تصاویر محتوایی برای کانال‌های تلگرامی
• ایجاد ابزار پرسش و پاسخ برای مشتریان
• ساخت نمونه اولیه (MVP) سریع برای استارتاپ‌های هوش مصنوعی
• راه‌اندازی ربات‌های تعاملی در گروه‌ها با استفاده از Mention
• آزمایش سریع مدل‌های مختلف NeurochainAI در محیط واقعی

پیش‌نیازها

ربات تلگرام NeurochainAI با n8n

برای اجرای این پروژه، موارد زیر را آماده کنید:

• نصب بودن n8n
• ساخت ربات تلگرام از طریق BotFather و دریافت Token
• داشتن حساب کاربری در NeurochainAI و دریافت API Key
• داشتن اعتبار کافی در حساب NeurochainAI برای درخواست‌ها
• آشنایی با نحوه Import کردن فایل‌های JSON در n8n

نکته حیاتی: حتماً کلید API خود را در بخش Header دو Node از نوع HTTP Request جایگزین عبارت YOUR-API-KEY-HERE کنید. همچنین مطمئن شوید که تمامی Credentialهای تلگرام را به‌درستی تنظیم کرده‌اید.

رمز فایل : danixai.com

فایل JSON این Workflow را از این قسمت دانلود کنید.

آموزش Import کردن Workflow

ربات تلگرام NeurochainAI با n8n

۱. وارد داشبورد n8n شوید.

۲. گزینه Import from File را انتخاب کنید.

۳. فایل دانلود شده را در سیستم خود پیدا و انتخاب کنید.

۴. پس از بارگذاری، تنظیمات Credential را اعمال کنید.

ساختار Workflow و منطق تصمیم‌گیری

ربات تلگرام NeurochainAI با n8n

مرکز فرماندهی این ربات، Node Switch است. این Node با بررسی محتوای پیام، کاربر را به یکی از سه مسیر زیر هدایت می‌کند:

1. مسیر Flux: اگر پیام با /flux شروع شود، ربات مسیر تولید تصویر را برمی‌گزیند.
2. مسیر Text: اگر کاربر در گروه، نام ربات را @NCNAI_BOT بیاورد، مسیر پاسخ متنی فعال می‌شود.
3. مسیر DM Text: اگر پیام در چت خصوصی (Private) ارسال شود، ربات مستقیماً وارد گفت‌وگو می‌شود.

این طراحی هوشمندانه باعث می‌شود ربات در گروه‌ها مزاحم گفتگو نشود و فقط وقتی لازم است پاسخ دهد.

بررسی دقیق Nodeها

ربات تلگرام NeurochainAI با n8n

1) Telegram Trigger

این Node نقطه شروع کار است. ربات با این ابزار، تمام آپدیت‌ها و پیام‌های دریافتی از تلگرام را دریافت می‌کند و داده‌هایی مثل متن پیام و شناسه چت را در اختیار بقیه مراحل قرار می‌دهد.

2) Switch

ربات تلگرام NeurochainAI با n8n

وظیفه اصلی این Node، جداسازی مسیرها بر اساس شرط‌های مختلف است. ما در اینجا از قابلیت‌های startsWith و contains استفاده کرده‌ایم تا ربات بتواند بین تولید تصویر و متن، تفاوت قائل شود.

ربات تلگرام NeurochainAI با n8n

3) Code1

قبل از ارسال درخواست تصویر، این Node وظیفه دارد متن را پاک‌سازی کند. با استفاده از یک قطعه کد جاوااسکریپت ساده، کلمه /flux را از ابتدای پیام حذف می‌کند تا فقط پرامپت خالص به هوش مصنوعی برسد.

4) Telegram2

برای اینکه کاربر در زمان پردازش تصویر احساس بی‌نتیجه بودن نکند، این Node یک پیام موقت (مثل علامت انتظار) ارسال می‌کند. این کار تجربه کاربری را بسیار حرفه‌ای‌تر می‌کند.

ربات تلگرام NeurochainAI با n8n

5) NeurochainAI – Flux

قلب تپنده تولید تصویر، این Node است. ربات در اینجا درخواست تولید تصویر را شامل مدل (مثلاً flux1-schnell) و اندازه تصویر به API ارسال می‌کند.

ربات تلگرام NeurochainAI با n8n

6) Code

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

7) HTTP Request3

در این مرحله، ربات لینک تصویر را می‌گیرد و فایل واقعی آن را دانلود می‌کند. این کار برای آن است که بتوانیم فایل باینری تصویر را مستقیماً به تلگرام بفرستیم.

ربات تلگرام NeurochainAI با n8n

8) Telegram1

در نهایت، ربات تصویر دانلود شده را همراه با متن پرامپت کاربر به چت تلگرام می‌فرستد.

9) Telegram4

بلافاصله پس از ارسال موفقیت‌آمیز تصویر، این Node پیام موقت (نشانگر پردازش) را از چت حذف می‌کند تا محیط چت تمیز باقی بماند.

10) Switch1

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

ربات تلگرام NeurochainAI با n8n

11) Telegram6

اگر کاربر پرامپت نامناسبی نوشته باشد، این Node پیام هشدار مربوط به کوتاهی متن را به او نمایش می‌دهد.

12) Telegram7

مانند مرحله قبل، این Node وظیفه دارد پیام انتظار را در صورت بروز خطای پرامپت حذف کند.

13) Telegram3

زمانی که خطای عمومی (مثل مشکل در سرور) رخ می‌دهد، این Node پیام خطا را به همراه یک دکمه برای تلاش مجدد (Retry) ارسال می‌کند.

14) Telegram5

این Node نیز پیام انتظار را پس از بروز خطاهای عمومی پاک‌سازی می‌کند.

15) TYPING – ACTION

در شاخه متنی، این Node وضعیت “در حال تایپ…” را در تلگرام فعال می‌کند. این حرکت ساده، به کاربر حس تعامل زنده با یک موجود هوشمند را می‌دهد.

16) NeurochainAI – REST API

این Node وظیفه پردازش متن را بر عهده دارد. ربات پیام کاربر را به مدل‌های زبانی (مانند Llama 3.1) می‌فرستد تا پاسخی هوشمندانه تولید کند.

17) AI Response

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

18) Switch2

این Node خطاهای احتمالی در بخش متنی را مدیریت می‌کند. اگر سرویس پاسخ ندهد، مسیرهای مختلف را فعال می‌کند.

19) No response

اگر سرور پاسخ ندهد، این Node به کاربر اطلاع می‌دهد که سرویس در حال حاضر در دسترس نیست.

ربات تلگرام NeurochainAI با n8n

20) Prompt too short

در بخش متنی نیز، اگر ورودی کاربر خیلی کوتاه باشد، این Node پیام راهنما را ارسال می‌کند.

21) Sticky Notes

ما برای اینکه شما در هنگام باز کردن Workflow سردرگم نشوید، چندین یادداشت (Sticky Note) در محیط طراحی قرار داده‌ایم که تمام راهنماها و مدل‌ها را در خود جای داده‌اند.

شخصی‌سازی و ارتقای ربات

ربات تلگرام NeurochainAI با n8n

شما می‌توانید این ربات را به سلیقه خود تغییر دهید:

• تغییر لحن و نقش: در Node NeurochainAI - REST API بخش پرامپت را تغییر دهید. می‌توانید ربات را از یک دستیار ساده به یک معلم زبان یا یک مشاور تجاری تبدیل کنید.
• انتخاب مدل‌های مختلف: فهرست مدل‌های موجود در یادداشت‌ها را بررسی کنید. با تغییر نام مدل در تنظیمات، می‌توانید سرعت یا کیفیت پاسخ‌ها را مدیریت کنید.
• تولید تصاویر خاص: در شاخه Flux، پارامترهایی مثل اندازه تصویر یا مدل تولیدکننده را تغییر دهید تا سبک هنری ربات عوض شود.
• افزودن فرمان‌های جدید: با اضافه کردن شرط‌های جدید به Switch اصلی، می‌توانید دستوراتی مثل /help یا /settings را هم اضافه کنید.

مزایا و نکات کلیدی

ربات تلگرام NeurochainAI با n8n

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

• همیشه API Key خود را چک کنید.
• متن خطاها را به فارسی برگردانید تا کاربر با شما ارتباط بهتری برقرار کند.
• اگر در گروه‌ها از ربات استفاده می‌کنید، حتماً دسترسی‌ها را محدود کنید تا از مصرف بیهوده اعتبار API جلوگیری شود.

رفع مشکلات رایج (Troubleshooting)

ربات تلگرام NeurochainAI با n8n

۱. ربات هیچ واکنشی نشان نمی‌دهد:

احتمالاً Token تلگرام را اشتباه وارد کرده‌اید یا Workflow را فعال (Activate) نکرده‌اید. ابتدا وضعیت اتصال را بررسی کنید.

۲. خطای احراز هویت (Authentication Error):

مطمئن شوید که در قسمت Header، عبارت Bearer را قبل از کلید API خود قرار داده‌اید.

۳. تصویر ساخته می‌شود اما ارسال نمی‌شود:

این مشکل معمولاً به دلیل تغییر در ساختار پاسخ API رخ می‌دهد. در این صورت باید کد داخل Node Code را با فرمت جدید هماهنگ کنید.

۴. پیام No response از سمت سرویس می‌آید:

در این حالت مشکل از سمت NeurochainAI است. موجودی حساب خود را بررسی کنید یا کمی صبر کنید تا سرویس پایدار شود.

جمع‌بندی

ساخت یک ربات تلگرام چندمنظوره با n8n، تجربه‌ای هیجان‌انگیز و سریع است. این Workflow به شما اجازه می‌دهد تا بدون درگیر شدن با پیچیدگی‌های کدنویسی، پتانسیل‌های عظیم هوش مصنوعی را در اختیار کاربران خود قرار دهید. چه بخواهید یک ابزار تولید تصویر بسازید و چه یک دستیار متنی، این ساختار منعطف، پایه و اساس قدرتمندی برای پروژه‌های شما خواهد بود.

سوالات متداول

ربات تلگرام NeurochainAI با n8n

۱. آیا می‌توانم از مدل‌های رایگان استفاده کنم؟

بله، بستگی به مدل‌های ارائه شده توسط NeurochainAI دارد. شما می‌توانید مدل‌ها را در تنظیمات جایگزین کنید.

۲. آیا ربات در گروه‌ها هم کار می‌کند؟

بله، اما طبق طراحی ما، در گروه‌ها فقط زمانی پاسخ می‌دهد که نام ربات را ذکر کنید (Mention).

۳. آیا برای اجرای این ربات نیاز به سرور دارم؟

برای اینکه ربات ۲۴ ساعته فعال باشد، بهتر است n8n را روی یک سرور یا VPS نصب کنید.

۴. چطور می‌توانم زبان پاسخ‌ها را تغییر دهم؟

کافی است در پرامپت اصلی (System Prompt) در Node متنی، بنویسید: “لطفاً همیشه به زبان فارسی پاسخ بده”.

۵. آیا این ربات تصاویر با کیفیت بالا تولید می‌کند؟

بله، مدل Flux یکی از قدرتمندترین مدل‌های تولید تصویر است که کیفیت بسیار بالایی ارائه می‌دهد.

۶. آیا می‌توانم تعداد تصاویر تولیدی را زیاد کنم؟

بله، با تغییر پارامتر n در درخواست API، می‌توانید تعداد تصاویر را افزایش دهید (البته توجه داشته باشید که این کار اعتبار بیشتری مصرف می‌کند).

۷. آیا این روش برای پروژه‌های تجاری امن است؟

بله، اما پیشنهاد می‌کنیم برای مقیاس بزرگ، حتماً لایه‌های امنیتی و مدیریت محدودیت استفاده (Rate Limiting) را به Workflow اضافه کنید.

GIT_LINK