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

آموزش Import کردن Workflow

n8n تولید تصویر

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

روی Import from File کلیک کنید.

فایل JSON را انتخاب کنید.

Workflow ایجاد خواهد شد.

Credentialهای موردنیاز را تنظیم کنید.

آموزش کامل تمام Nodeها

n8n تولید تصویر

وظیفه Node

این نود تریگر اصلی Workflow است و تمام رویدادهای ورودی تلگرام را دریافت می‌کند.

ورودی آن

ورودی ندارد، چون نقطه شروع اجرای Workflow است.

خروجی آن

خروجی شامل اطلاعات کامل پیام ورودی، مشخصات کاربر، شناسه چت و سایر داده‌های مربوط به آپدیت تلگرام است.

تنظیمات مهم

• نوع نود: telegramTrigger
• updates روی * تنظیم شده است
• از Credential مربوط به Telegram استفاده می‌کند
• Webhook اختصاصی برای دریافت رویدادها دارد

نکات قابل تغییر

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

دلیل استفاده از این Node در Workflow

n8n تولید تصویر

این نود دروازه ورود داده به Agentic Telegram AI n8n است و بدون آن هیچ پیامی از تلگرام وارد Workflow نمی‌شود.

 

وظیفه Node

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

ورودی آن

متن پیام کاربر از خروجی Telegram Trigger وارد این نود می‌شود.

خروجی آن

پاسخ نهایی Agent در فیلد output قرار می‌گیرد.

تنظیمات مهم

• text: از مسیر message.text گرفته می‌شود
• promptType: روی define قرار دارد
• systemMessage: شامل دستوراتی برای رفتار Agent است

نکات قابل تغییر

• می‌توانید لحن Agent را فارسی، رسمی، دوستانه یا تخصصی کنید
• می‌توانید نقش Agent را تغییر دهید
• امکان افزودن قوانین بیشتر برای پاسخ‌گویی وجود دارد
• می‌توان آن را به ابزارهای دیگر هم متصل کرد

دلیل استفاده از این Node در Workflow

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

 

وظیفه Node

این نود مدل زبانی اصلی Workflow را تأمین می‌کند تا Agent بتواند به پیام‌های کاربران پاسخ هوشمند بدهد.

ورودی آن

از مسیر معمول main ورودی ندارد و به‌عنوان مدل زبانی به Agent متصل است.

خروجی آن

خروجی آن در اختیار Agent قرار می‌گیرد تا برای تحلیل متن و تولید پاسخ استفاده شود.

تنظیمات مهم

• مدل: gpt-4o
• temperature: برابر 0.7
• frequencyPenalty: برابر 0.2

نکات قابل تغییر

• می‌توانید مدل را تغییر دهید
• می‌توانید مقدار Temperature را برای خلاقیت کمتر یا بیشتر تنظیم کنید
• امکان بهینه‌سازی هزینه و کیفیت با انتخاب مدل مناسب وجود دارد

دلیل استفاده از این Node در Workflow

این نود قدرت پردازش زبان طبیعی را به Agentic Telegram AI n8n می‌دهد و پاسخ‌های انسانی‌تر تولید می‌کند.

 

وظیفه Node

این نود برای نگهداری حافظه کوتاه‌مدت گفتگو به‌کار می‌رود.

ورودی آن

از main ورودی مستقیمی ندارد و به‌عنوان حافظه به Agent متصل است.

خروجی آن

تاریخچه چند پیام اخیر را در اختیار Agent قرار می‌دهد.

تنظیمات مهم

• sessionKey بر اساس chat.id ساخته می‌شود
• contextWindowLength: برابر 10

نکات قابل تغییر

• می‌توانید طول حافظه را بیشتر یا کمتر کنید
• می‌توانید نحوه ساخت Session Key را سفارشی کنید
• در پروژه‌های بزرگ می‌توان از حافظه‌های ماندگارتر استفاده کرد

دلیل استفاده از این Node در Workflow

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

 

وظیفه Node

این نود ابزار تولید تصویر است و وقتی کاربر درخواست رسم یا ساخت تصویر می‌دهد، توسط Agent فراخوانی می‌شود.

ورودی آن

ورودی این نود از Agent تأمین می‌شود و شامل Prompt تولید تصویر است.

خروجی آن

خروجی آن شامل نتیجه درخواست API و آدرس تصویر تولیدشده است.

تنظیمات مهم

• آدرس API: https://api.openai.com/v1/images/generations
• متد: POST
• مدل: dall-e-3
• پارامتر Prompt به‌صورت داینامیک ارسال می‌شود
• احراز هویت با OpenAI Credential انجام می‌شود

نکات قابل تغییر

• می‌توانید متن Prompt را دقیق‌تر طراحی کنید
• می‌توانید ابزارهای تصویری دیگری اضافه کنید
• در صورت تغییر API، پارامترها قابل ویرایش هستند

دلیل استفاده از این Node در Workflow

این نود توانایی تولید تصویر را به Workflow اضافه می‌کند و آن را از یک ربات متنی ساده به یک Agent چندمنظوره تبدیل می‌کند.

وظیفه Node

این نود فایل یا لینک تصویر را برای کاربر در تلگرام ارسال می‌کند.

ورودی آن

ورودی این نود از Agent تأمین می‌شود و شامل URL تصویر است.

خروجی آن

خروجی، نتیجه ارسال فایل در تلگرام است.

تنظیمات مهم

• عملیات: sendDocument
• file: یک URL معتبر تصویر
• chatId: از اطلاعات کاربر تلگرام خوانده می‌شود

نکات قابل تغییر

• می‌توانید آن را به sendPhoto تغییر دهید
• امکان افزودن کپشن وجود دارد
• در صورت نیاز می‌توانید نوع خروجی را تغییر دهید

دلیل استفاده از این Node در Workflow

پس از تولید تصویر، این نود تجربه کاربری را کامل می‌کند و نتیجه را مستقیماً به کاربر می‌رساند.

وظیفه Node

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

ورودی آن

ورودی این نود خروجی AI Agent است.

خروجی آن

خروجی شامل نتیجه ارسال پیام متنی در تلگرام است.

تنظیمات مهم

• متن: {{$json.output}}
• chatId: از message.from.id
• appendAttribution: غیرفعال
• onError: روی continueErrorOutput

نکات قابل تغییر

• می‌توانید قالب پیام را سفارشی کنید
• می‌توانید Markdown یا فرمت‌های دیگر را اضافه کنید
• امکان افزودن پردازش قبل از ارسال وجود دارد

دلیل استفاده از این Node در Workflow

این نود پاسخ نهایی را به کاربر می‌رساند و حلقه مکالمه را تکمیل می‌کند.

وظیفه Node

این نود صرفاً برای توضیح داخلی و مستندسازی Workflow استفاده می‌شود.

ورودی آن

ندارد.

خروجی آن

ندارد.

تنظیمات مهم

• متن داخلی برای توضیح هدف Workflow در آن نوشته شده است

نکات قابل تغییر

• می‌توانید توضیحات تیمی یا مستندات فارسی در آن قرار دهید
• محل، رنگ و اندازه آن قابل تغییر است

دلیل استفاده از این Node در Workflow

به نگهداری بهتر Workflow و خوانایی آن کمک می‌کند.

نحوه شخصی‌سازی Workflow

تغییر Promptها

در AI Agent می‌توانید پیام سیستمی را تغییر دهید و مشخص کنید:

• پاسخ‌ها کاملاً فارسی باشند
• لحن رسمی یا دوستانه باشد
• نام کاربر در ابتدای پاسخ یا انتهای آن قرار گیرد
• محدودیت طول پاسخ اعمال شود

تغییر APIها

می‌توانید به‌جای ابزار فعلی، APIهای دیگری اضافه کنید یا سرویس‌های داخلی خود را به Agent وصل کنید.

تغییر مدل AI

در این Template از gpt-4o استفاده شده است، اما در صورت نیاز می‌توانید مدل را متناسب با هزینه، سرعت و کیفیت تغییر دهید.

تغییر Triggerها

اگر تلگرام برای شما کافی نیست، می‌توانید ساختار این Agentic Telegram AI n8n را برای Webhook، Slack یا Discord نیز بازنویسی کنید.

تغییر زمان‌بندی

هرچند این Workflow رویدادمحور است، اما می‌توانید آن را با Cron ترکیب کنید تا پیام‌های زمان‌بندی‌شده هم ارسال شوند.

تغییر Labelها و شرط‌ها

می‌توانید با نودهای IF و Switch مسیرهای مختلفی برای کاربران، نوع پیام یا درخواست تصویر ایجاد کنید.

تغییر مسیر اجرای Workflow

امکان افزودن لاگ‌گیری، ذخیره در دیتابیس، Google Sheets یا ابزارهای گزارش‌گیری نیز وجود دارد.

مزایای استفاده از این Workflow

• راه‌اندازی سریع ربات AI در تلگرام
• ترکیب پاسخ متنی و تولید تصویر در یک ساختار واحد
• قابلیت استفاده از حافظه مکالمه
• شخصی‌سازی تجربه کاربر با نام او
• توسعه‌پذیری بالا با افزودن Toolهای جدید
• مناسب برای یادگیری Agentها در n8n
• کاهش زمان پیاده‌سازی پروژه‌های هوش مصنوعی
• مناسب برای MVP و محصولات واقعی

نکات مهم

• Credentialهای OpenAI و Telegram را قبل از اجرا بررسی کنید.
• اگر فقط پیام متنی نیاز دارید، انواع آپدیت‌ها را محدود کنید.
• برای کاهش هزینه، تنظیم مدل‌ها را با دقت انجام دهید.
• حافظه مکالمه را متناسب با نیاز پروژه تنظیم کنید.
• متن System Message باید شفاف و دقیق باشد.
• برای تولید تصویر، Promptهای استاندارد تعریف کنید.
• اجرای Workflow را قبل از انتشار عمومی تست کنید.
• برای مدیریت خطاها از IF یا مسیرهای جایگزین استفاده کنید.
• اگر کاربران زیاد هستند، محدودیت نرخ API را بررسی کنید.
• بهتر است روی خروجی‌ها مانیتورینگ و لاگ‌گیری داشته باشید.

خطاهای رایج (Troubleshooting)

1) ربات به پیام‌ها پاسخ نمی‌دهد

علت:

توکن ربات اشتباه است یا Workflow فعال نشده است.

راه‌حل:

توکن تلگرام را بررسی کنید و Workflow را Active کنید.

2) پاسخ متنی کار می‌کند اما تصویر ساخته نمی‌شود

علت:

API Key مربوط به OpenAI معتبر نیست یا دسترسی تولید تصویر فعال نیست.

راه‌حل:

Credential OpenAI را تست کنید و دسترسی API تصویر را بررسی نمایید.

3) تصویر ساخته می‌شود اما به کاربر نمی‌رسد

علت:

URL تصویر معتبر نیست یا نود تلگرام نتوانسته فایل را دریافت کند.

راه‌حل:

خروجی نود تولید تصویر را بررسی کنید و مسیر ورودی URL به نود ارسال تصویر را تست نمایید.

4) حافظه گفتگو درست عمل نمی‌کند

علت:

Session Key اشتباه تنظیم شده یا حافظه به Agent متصل نیست.

راه‌حل:

تنظیمات Window Buffer Memory را بررسی کنید و از یکتابودن chat.id مطمئن شوید.

5) روی بعضی پیام‌ها خطا رخ می‌دهد

علت:

همه رویدادهای تلگرام دریافت می‌شوند و بعضی از آن‌ها message.text ندارند.

راه‌حل:

قبل از AI Agent یک IF قرار دهید تا فقط پیام‌های متنی وارد فرآیند شوند.

6) پاسخ نهایی خالی است

علت:

Agent نتوانسته خروجی مناسب بسازد یا فیلد output مقدار نگرفته است.

راه‌حل:

Prompt سیستم و اجرای Agent را بررسی کنید و در صورت نیاز پاسخ جایگزین تعریف کنید.

جمع‌بندی

اگر بخواهید یک ربات هوشمند، قابل توسعه و کاربردی در تلگرام بسازید، Agentic Telegram AI در n8n یکی از بهترین الگوهایی است که می‌توانید از آن شروع کنید. این Workflow نشان می‌دهد که چگونه می‌توان با ترکیب Telegram Trigger، AI Agent، مدل زبانی OpenAI، حافظه مکالمه و ابزار تولید تصویر DALL·E یک سیستم تعاملی و حرفه‌ای طراحی کرد. مزیت مهم این ساختار در آن است که هم برای آموزش بسیار مناسب است و هم برای توسعه محصول واقعی.

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

اگر قصد دارید ربات خود را شخصی‌سازی کنید، کافی است Promptها، مدل‌ها، ابزارها و مسیرهای Workflow را متناسب با نیازتان تغییر دهید. به همین دلیل، Agentic Telegram AI در n8n هم یک نمونه آموزشی قدرتمند است و هم یک پایه بسیار خوب برای ساخت ربات‌های هوشمند پیشرفته در n8n.

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

1) آیا این Workflow فقط در تلگرام کار می‌کند؟

خیر. منطق آن را می‌توان برای Webhook، Slack یا Discord هم توسعه داد.

2) آیا بدون OpenAI می‌توان این Template را اجرا کرد؟

خیر. در نسخه فعلی، هم پاسخ متنی و هم تولید تصویر به OpenAI وابسته است.

3) آیا این Workflow مکالمات قبلی را درک می‌کند؟

بله. به کمک Window Buffer Memory چند پیام اخیر هر کاربر در حافظه نگه داشته می‌شود.

4) آیا می‌توانم قابلیت تولید تصویر را حذف کنم؟

بله. می‌توانید نودهای مربوط به DALL·E و ارسال تصویر را حذف کنید و Agent را فقط برای پاسخ متنی نگه دارید.

5) آیا این Workflow برای کاربران مبتدی مناسب است؟

بله. با اینکه ساختار آن حرفه‌ای است، اما برای کاربران مبتدی تا متوسط نیز قابل فهم و اجراست.

6) آیا می‌توان پاسخ‌ها را فقط فارسی کرد؟

بله. کافی است در System Message مشخص کنید که پاسخ‌ها فقط به زبان فارسی تولید شوند.

7) آیا می‌توان گفتگوها را ذخیره کرد؟

بله. می‌توانید Nodeهای ذخیره‌سازی مثل Google Sheets یا دیتابیس را به مسیر Workflow اضافه کنید.