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

آموزش Import کردن Workflow

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

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

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

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

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

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

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

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

1) Listen for incoming events

وظیفه Node:

این نود نقش Trigger اصلی را دارد و هر رویداد جدیدی را از سمت تلگرام دریافت می‌کند.

ورودی آن:

این نود ورودی مستقیم از کاربر نمی‌گیرد، بلکه از Bot API تلگرام رویدادها را دریافت می‌کند.

خروجی آن:

خروجی شامل داده‌هایی مثل شناسه کاربر، شناسه چت، نام فرستنده، متن پیام، فایل صوتی و سایر جزئیات پیام است.

تنظیمات مهم:

در این Template گزینه updates روی * قرار دارد تا همه رویدادها را بگیرد.

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

اگر فقط بعضی رویدادها را نیاز دارید، می‌توانید نوع آپدیت‌ها را محدود کنید.

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

این نود نقطه شروع کل فرآیند است و بدون آن بات هیچ پیامی را دریافت نمی‌کند.

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

2) Send Typing action

وظیفه Node:

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

ورودی آن:

شناسه چت از پیام دریافتی در نود Trigger.

خروجی آن:

ارسال وضعیت typing به تلگرام.

تنظیمات مهم:

عملیات روی sendChatAction تنظیم شده است.

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

می‌توانید نوع اکشن را بر اساس کاربرد تغییر دهید.

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

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

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

3) Determine content type

وظیفه Node:

این نود نوع محتوای ورودی را تشخیص می‌دهد و مسیر مناسب را انتخاب می‌کند.

ورودی آن:

خروجی نود Trigger شامل داده خام پیام.

خروجی آن:

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

تنظیمات مهم:

وجود message.text برای متن و message.voice برای پیام صوتی بررسی می‌شود.

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

می‌توانید شرط‌های بیشتری برای تصویر، فایل یا ویدیو اضافه کنید.

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

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

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

4) Download voice file

وظیفه Node:

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

ورودی آن:

مقدار file_id مربوط به ویس کاربر.

خروجی آن:

فایل صوتی به صورت باینری برای مراحل بعدی آماده می‌شود.

تنظیمات مهم:

فیلد resource روی file قرار دارد.

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

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

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

بدون دریافت فایل اصلی، مرحله تبدیل صوت به متن انجام نمی‌شود.

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

5) Convert audio to text

وظیفه Node:

این نود صدای کاربر را به متن تبدیل می‌کند.

ورودی آن:

فایل صوتی دریافت‌شده از نود قبلی.

خروجی آن:

متن استخراج‌شده از پیام صوتی.

تنظیمات مهم:

این نود از OpenAI در حالت audio و عملیات transcribe استفاده می‌کند.

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

می‌توانید زبان یا دمای پردازش را تغییر دهید.

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

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

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

6) Combine content and set properties

وظیفه Node:

این نود داده‌های ورودی را یکدست می‌کند و چند فیلد کمکی می‌سازد.

ورودی آن:

یا متن مستقیم کاربر، یا متن تبدیل‌شده از ویس.

خروجی آن:

فیلدهایی مثل CombinedMessage، نوع پیام و وضعیت فوروارد بودن.

تنظیمات مهم:

در این بخش مقدار پیام نهایی و نوع آن با Expression ساخته می‌شود.

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

می‌توانید فیلدهای سفارشی بیشتری مثل زبان، شناسه کاربر یا دسته‌بندی پیام اضافه کنید.

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

این نود ساختار ورودی را برای AI Agent استاندارد می‌کند.

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

7) AI Agent

وظیفه Node:

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

ورودی آن:

فیلد CombinedMessage به همراه حافظه و مدل متصل به Agent.

خروجی آن:

پاسخ متنی آماده ارسال.

تنظیمات مهم:

در systemMessage به Agent گفته شده که کاربر را با نام صدا بزند، تاریخ جاری را بداند و پاسخ را با HTML سازگار با تلگرام تولید کند.

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

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

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

این نود مغز اصلی سناریو است و منطق پاسخ‌گویی را مدیریت می‌کند.

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

8) OpenAI Chat Model

وظیفه Node:

این نود مدل زبانی مورد استفاده AI Agent را فراهم می‌کند.

ورودی آن:

درخواست‌های پردازش‌شده از طرف AI Agent.

خروجی آن:

پاسخ مدل زبانی برای Agent.

تنظیمات مهم:

مدل روی gpt-4o تنظیم شده و temperature برابر 0.7 است. همچنین frequencyPenalty روی 0.2 قرار دارد.

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

می‌توانید مدل را بر اساس بودجه، کیفیت یا سرعت تغییر دهید.

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

این نود کیفیت درک و تولید متن را تعیین می‌کند.

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

9) Window Buffer Memory

وظیفه Node:

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

ورودی آن:

شناسه جلسه و پیام‌های ردوبدل‌شده.

خروجی آن:

بخشی از تاریخچه مکالمه برای استفاده Agent.

تنظیمات مهم:

کلید جلسه با chat.id ساخته شده و طول پنجره حافظه روی 10 قرار دارد.

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

می‌توانید طول حافظه را کم یا زیاد کنید.

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

این نود باعث می‌شود بات هر پیام را جدا از بقیه نبیند و زمینه گفتگو را حفظ کند.

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

10) Send final reply

وظیفه Node:

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

ورودی آن:

خروجی نود AI Agent.

خروجی آن:

پیام نهایی در چت تلگرام.

تنظیمات مهم:

parse_mode روی HTML قرار دارد. همچنین متن پایانی بر اساس نوع پیام و منبع پیام ساخته می‌شود.

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

می‌توانید متن انتهایی، امضا، لحن یا حتی دکمه‌های بات را تغییر دهید.

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

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

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

11) Correct errors

وظیفه Node:

این نود خطاهای مربوط به کاراکترهای حساس HTML را اصلاح می‌کند.

ورودی آن:

خروجی خطادار از مسیر خطای نود ارسال پاسخ.

خروجی آن:

نسخه امن‌تر پیام برای ارسال مجدد.

تنظیمات مهم:

این نود با Expression کاراکترهای &، <، > و " را جایگزین می‌کند.

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

در صورت نیاز می‌توانید قواعد بیشتری برای پاک‌سازی متن تعریف کنید.

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

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

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

12) Send error message

وظیفه Node:

این نود به کاربر اطلاع می‌دهد که فرمت پیام پشتیبانی نمی‌شود.

ورودی آن:

پیام‌هایی که نه متن هستند و نه ویس.

خروجی آن:

ارسال پیام خطا به کاربر.

تنظیمات مهم:

متن پیام به‌صورت ثابت نوشته شده و از نام کاربر استفاده می‌کند.

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

می‌توانید پیام را دوستانه‌تر، رسمی‌تر یا دقیق‌تر تنظیم کنید.

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

این نود جلوی سردرگمی کاربر را می‌گیرد و نوع پیام‌های قابل قبول را مشخص می‌کند.

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

13) Sticky Note

وظیفه Node:

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

ورودی آن:

ورودی عملیاتی ندارد.

خروجی آن:

خروجی اجرایی ندارد.

تنظیمات مهم:

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

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

می‌توانید توضیح‌ها را متناسب با تیم خود تغییر دهید.

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

این نود خوانایی Workflow را برای توسعه‌دهنده بهتر می‌کند.

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

14) Sticky Note1

وظیفه Node:

این نود توضیح مرحله ارسال پیام به Agent و بازگرداندن پاسخ را نشان می‌دهد.

ورودی آن:

ورودی عملیاتی ندارد.

خروجی آن:

خروجی اجرایی ندارد.

تنظیمات مهم:

متن توضیحی این قسمت روی بوم ثبت شده است.

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

می‌توانید از آن برای مستندسازی داخلی تیم استفاده کنید.

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

وجود این نود درک سریع‌تر ساختار سناریو را آسان می‌کند.

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

15) Sticky Note2

وظیفه Node:

این نود بخش مربوط به تبدیل صوت به متن را روی بوم مشخص می‌کند.

ورودی آن:

ورودی عملیاتی ندارد.

خروجی آن:

خروجی اجرایی ندارد.

تنظیمات مهم:

رنگ و متن آن برای تفکیک بصری انتخاب شده است.

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

در پروژه‌های بزرگ می‌توانید از استیکی نوت‌ها برای جداسازی بخش‌ها استفاده کنید.

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

این نود نگهداری و توسعه Workflow را ساده‌تر می‌کند.

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

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

برای شخصی‌سازی این Template چند نقطه کلیدی وجود دارد. مهم‌ترین بخش، نود AI Agent است. شما می‌توانید متن systemMessage را تغییر دهید تا بات رسمی‌تر، صمیمی‌تر، تخصصی‌تر یا محدود به یک موضوع خاص پاسخ دهد. اگر بات قرار است نقش پشتیبان فروش، مشاور آموزشی یا دستیار فنی را بازی کند، باید همین‌جا شخصیت آن را تعریف کنید.

برای تغییر مدل AI، نود OpenAI Chat Model را ویرایش کنید. اگر هزینه برای شما مهم است، می‌توانید از مدل‌های اقتصادی‌تر استفاده کنید. اگر کیفیت اولویت دارد، همان GPT-4o گزینه مناسبی است. همچنین می‌توانید مقدار temperature را کم کنید تا پاسخ‌ها دقیق‌تر و قابل پیش‌بینی‌تر شوند.

برای تغییر Trigger، سراغ نود Listen for incoming events بروید. اگر بخواهید این منطق را از تلگرام به سرویس دیگری منتقل کنید، باید Trigger و نودهای ارسال پاسخ را تغییر دهید. اگر هدف شما فقط دستورهای خاص باشد، می‌توانید در نود Determine content type شرط‌های دقیق‌تری تعریف کنید.

برای تغییر زمان‌بندی، باید بدانید این Workflow در نسخه فعلی رویدادمحور است و با پیام کاربر اجرا می‌شود. اگر بخواهید بخشی از آن به شکل دوره‌ای کار کند، می‌توانید یک Cron Trigger اضافه کنید و مسیر جداگانه‌ای بسازید.

برای تغییر شرط‌ها و مسیر اجرا، بهترین محل نود Switch و در صورت نیاز نودهای IF یا Merge هستند. با این روش می‌توانید مسیرهای جدیدی برای عکس، فایل، دستورهای خاص یا کاربران ویژه اضافه کنید.

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

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

این Template مزیت‌های عملی زیادی دارد:

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

نکات مهم

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

برای استفاده بهتر از این Workflow به نکات زیر توجه کنید:

• حتماً Credentialهای تلگرام و OpenAI را به‌درستی تنظیم کنید
• قبل از فعال‌سازی نهایی، مسیرهای متن و ویس را جداگانه تست کنید
• اگر پاسخ‌های HTML خطا می‌دهند، خروجی Agent را دقیق بررسی کنید
• طول حافظه را با توجه به هزینه و نیاز مکالمه تنظیم کنید
• برای ویس‌های طولانی زمان پردازش بیشتری در نظر بگیرید
• اگر کاربران فارسی‌زبان هستند، پرامپت Agent را با نیاز فارسی هماهنگ کنید
• متن پیام خطا را واضح بنویسید تا کاربر بداند چه فرمتی مجاز است
• در پروژه‌های واقعی، بهتر است روی لاگ‌گیری و مانیتورینگ هم کار کنید
• در صورت افزایش تعداد کاربران، مصرف توکن و هزینه API را زیر نظر بگیرید
• اگر بات در گروه‌ها هم فعال است، قواعد پاسخ‌گویی را دقیق‌تر تعریف کنید

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

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

1) بات هیچ پیامی دریافت نمی‌کند

علت:

Webhook تلگرام به‌درستی تنظیم نشده یا دامنه شما در دسترس نیست.

راه‌حل:

آدرس n8n، فعال بودن HTTPS و صحت اتصال Credential تلگرام را بررسی کنید. سپس Workflow را دوباره فعال کنید.

2) پیام صوتی پردازش نمی‌شود

علت:

فایل ویس به‌درستی دانلود نمی‌شود یا نود تبدیل صوت به متن به OpenAI دسترسی ندارد.

راه‌حل:

ابتدا خروجی نود Download voice file را بررسی کنید. بعد Credential مربوط به OpenAI و دسترسی API را تست کنید.

3) پاسخ نهایی در تلگرام خطای فرمت می‌دهد

علت:

AI Agent متنی تولید کرده که با HTML تلگرام سازگار نیست.

راه‌حل:

Prompt مربوط به فرمت HTML را دقیق‌تر کنید و مطمئن شوید مسیر خطا به نود Correct errors متصل است.

4) بات زمینه گفتگو را فراموش می‌کند

علت:

طول حافظه کم است یا کلید جلسه به‌درستی تعریف نشده است.

راه‌حل:

تنظیمات نود Window Buffer Memory را بررسی کنید و در صورت نیاز مقدار contextWindowLength را افزایش دهید.

5) بات به بعضی پیام‌ها پاسخ خطا می‌دهد

علت:

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

راه‌حل:

یا نودهای جدید برای این فرمت‌ها اضافه کنید، یا متن نود Send error message را واضح‌تر کنید تا کاربر نوع پیام مجاز را بداند.

6) هزینه استفاده از OpenAI بیشتر از انتظار می‌شود

علت:

مدل انتخابی پیشرفته است و حافظه مکالمه یا تعداد درخواست‌ها زیاد شده است.

راه‌حل:

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

جمع‌بندی

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

اگر به دنبال یک نمونه عملی برای ساخت چت بات تلگرام با n8n هستید، این Template یکی از بهترین نقطه‌های شروع است. این Workflow فقط یک بات ساده برای پاسخ به متن نیست، بلکه پیام صوتی را هم دریافت می‌کند، آن را به متن تبدیل می‌کند، پاسخ هوشمند می‌سازد و نتیجه را با فرمت مناسب در تلگرام نمایش می‌دهد. ترکیب Trigger تلگرام، تبدیل صوت به متن، AI Agent، مدل GPT-4o و حافظه مکالمه باعث شده این سناریو هم کاربردی باشد و هم توسعه‌پذیر.

مزیت مهم این ساختار در سادگی توسعه آن است. شما می‌توانید مسیرهای جدید اضافه کنید، لحن بات را تغییر دهید، مدل AI را عوض کنید و آن را برای پشتیبانی، آموزش، فروش یا خدمات تخصصی تنظیم کنید. اگر می‌خواهید بدون صرف زمان زیاد یک بات حرفه‌ای راه‌اندازی کنید، این Workflow انتخاب بسیار خوبی است.

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

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

آیا این بات فقط پیام متنی را پشتیبانی می‌کند؟

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

آیا برای استفاده از این Template باید برنامه‌نویس حرفه‌ای باشم؟

خیر. اگر با مفاهیم پایه n8n آشنا باشید، می‌توانید این Workflow را وارد و تنظیم کنید.

آیا می‌توانم مدل GPT-4o را با مدل دیگری جایگزین کنم؟

بله. در نود OpenAI Chat Model می‌توانید مدل را بر اساس نیاز، هزینه و کیفیت تغییر دهید.

آیا این Workflow برای زبان فارسی مناسب است؟

بله. با تنظیم درست Promptها و نوع پاسخ، این Template برای کاربران فارسی‌زبان هم کاملاً قابل استفاده است.

آیا می‌توانم این بات را برای پشتیبانی مشتریان شخصی‌سازی کنم؟

بله. کافی است Promptها، متن پاسخ‌ها، شرط‌ها و مسیرهای اجرایی را متناسب با کسب‌وکار خود تغییر دهید.

آیا امکان افزودن پشتیبانی از تصویر و فایل هم وجود دارد؟

بله. باید در نود Switch شرط‌های جدید بسازید و نودهای مناسب برای پردازش آن نوع محتوا را به Workflow اضافه کنید.