اتصال پیامرسان بله به n8n با استفاده از نود Telegram
پیامرسان بله از API بسیار مشابه تلگرام استفاده میکند؛ به همین دلیل برای اتصال آن به n8n نیازی به نصب نود اختصاصی ندارید. تنها کافی است Bot Token ربات بله خود را در Credential مربوط به Telegram وارد کرده و آدرس API را به سرور بله تغییر دهید.
در این آموزش، ابتدا Credential مربوط به بله را در نود تلگرام داخل n8n ایجاد میکنیم و تنظیمات لازم برای اتصال به API بله را انجام میدهیم. سپس نحوه استفاده از این اتصال در ورکفلوها را بررسی خواهیم کرد تا بتوانید پیامهای خودکار، اعلانها و گزارشهای مختلف را از طریق بله ارسال کنید.
مشخصات و پیشنیازهای اتصال بله به n8n
| مشخصات | مقدار |
|---|---|
| سطح آموزش | مبتدی تا متوسط |
| زمان راهاندازی | حدود ۵ دقیقه |
| پیشنیازها | نصب n8n، ساخت ربات بله و دریافت Bot Token |
| نود مورد استفاده | Telegram |
| نیاز به نود اختصاصی | خیر |
| Base URL | https://tapi.bale.ai/ |
| کاربردها | ارسال پیام، اعلان سفارشهای ووکامرس، گزارشهای روزانه، اطلاعرسانی پرداختها، انتشار خودکار در کانال بله و سایر سناریوهای اتوماسیون |
پیشنیازها
قبل از شروع آموزش، موارد زیر را آماده داشته باشید:
- نصب و راهاندازی n8n
- ساخت ربات در پیامرسان بله
- دریافت Bot Token ربات
اگر هنوز ربات بله نساختهاید، ابتدا آن را ایجاد کرده و Bot Token را دریافت کنید.
مرحله اول: ایجاد Credential بله از طریق نود تلگرام در n8n
- در داشبورد اولیه n8n روی تب credentials کلیک کنید.
- در گوشه بالا سمت راست روی گزینه Create credential کلیک کنید.
- سپس در پنجره باز شده عبارت Telegram API را جستجو و انتخاب کنید.
مرحله دوم: وارد کردن Bot Token بله و تغییر Base URL
- در فیلد Access Token، توکن ربات بله را وارد کنید. (این توکن همان مقداری است که هنگام ساخت ربات از BotFather بله دریافت کردهاید.)
- بهصورت پیشفرض نود Telegram درخواستها را به API تلگرام ارسال میکند؛ اما برای استفاده از بله باید Base URL را تغییر دهید. از همین رو در فیلد Base URL آدرس https://tapi.bale.ai را وارد کنید.
- و سپس گزینه save را کلیک کنید تا ذخیره شود.
مرحله سوم: تست اتصال
- یک Workflow جدید ایجاد کنید.
- یک نود Telegram اضافه کنید.
- برای مثال Operation را روی Send Message قرار دهید.
- Credential ساختهشده را انتخاب کنید.
- در قسمت Chat ID شناسه کاربر یا کانال بله را وارد کرده و یک متن آزمایشی ارسال کنید.
- اگر همه تنظیمات صحیح باشد، پیام در بله نمایش داده خواهد شد.
استفاده از نود Telegram برای بله
بعد از انجام تنظیمات بالا، تمام Operationهای نود Telegram که توسط API بله پشتیبانی شوند قابل استفاده هستند؛ از جمله:
- Send Message
- Edit Message
- Send Photo
- Send Document
- Send Audio
- Send Video
- Send Location
- Send Media Group
- Send Sticker
در نتیجه بدون نیاز به هیچ افزونه یا نود اختصاصی، میتوانید اکثر قابلیتهای موردنیاز را در ورکفلوهای خود استفاده کنید.
نمونه سناریوهای کاربردی با اتصال بله به n8n
- بعد از اتصال بله به n8n میتوانید اتوماسیونهای متنوعی ایجاد کنید، مانند:
- ارسال پیام هنگام ثبت سفارش جدید ووکامرس
- اطلاعرسانی پرداخت موفق به مدیر سایت
- ارسال گزارش روزانه فروش
- ارسال لاگ خطاهای سرور
- انتشار خودکار مطالب وردپرس در کانال بله
- ارسال پیام هنگام ثبت فرم تماس
- اطلاعرسانی موجود شدن محصول
- ارسال گزارش وضعیت بکاپها
نکات مهم:
- API بله با تلگرام سازگار است، اما ممکن است همه متدهای تلگرام را پشتیبانی نکند.
- در صورت بروز خطا، ابتدا صحت Bot Token و Base URL را بررسی کنید.
- در Workflowهای جدید کافی است همان Credential را انتخاب کنید و نیازی به انجام تنظیمات مجدد نیست.
جمعبندی
به دلیل سازگاری API بله با تلگرام، اتصال آن به n8n بسیار ساده است و تنها با ایجاد یک Credential از نوع Telegram و تغییر Base URL به https://tapi.bale.ai/ میتوانید ربات بله را به ورکفلوهای خود متصل کنید. از این پس میتوانید انواع اعلانها، گزارشها و پیامهای خودکار را بدون نیاز به نود اختصاصی، مستقیماً در پیامرسان بله ارسال کنید.
سوالات متداول در رابطه با اتصال بله به n8n
آیا برای اتصال بله به n8n نیاز به نود اختصاصی است؟
خیر. از آنجایی که API پیامرسان بله با API تلگرام سازگاری بالایی دارد، میتوانید از نود Telegram در n8n استفاده کنید و تنها با تغییر Base URL و وارد کردن Bot Token، ربات بله را متصل کنید.
آیا تمام قابلیتهای نود Telegram در بله قابل استفاده هستند؟
بیشتر قابلیتهای رایج مانند ارسال پیام، تصویر، فایل و رسانه در بله قابل استفاده هستند. با این حال، ممکن است برخی متدهای اختصاصی تلگرام توسط API بله پشتیبانی نشوند. برای اطلاع از قابلیتهای قابل استفاده، مستندات API بله را بررسی کنید.
Base URL بله در n8n چیست؟
برای اتصال به API بله باید مقدار Base URL را به آدرس زیر تغییر دهید:
https://tapi.bale.ai/
در صورت استفاده از آدرس پیشفرض تلگرام، درخواستها به سرورهای تلگرام ارسال شده و اتصال به بله برقرار نخواهد شد.
چگونه Bot Token ربات بله را دریافت کنم؟
ابتدا یک ربات در پیامرسان بله ایجاد کنید. پس از ساخت ربات، Bot Token در اختیار شما قرار میگیرد که باید آن را در Credential مربوط به Telegram در n8n وارد کنید.
آیا میتوان پیامهای بله را نیز در n8n دریافت کرد؟
بله. در صورتی که API بله از ورکفلوهای موردنیاز پشتیبانی کند، میتوانید از قابلیتهای دریافت پیام نیز در ورکفلوهای n8n استفاده کنید. البته عملکرد برخی Triggerها ممکن است با تلگرام تفاوتهایی داشته باشد.
با اتصال بله به n8n چه اتوماسیونهایی میتوان ساخت؟
پس از راهاندازی این اتصال میتوانید انواع سناریوهای اتوماسیون را پیادهسازی کنید؛ مانند ارسال اعلان سفارشهای ووکامرس، اطلاعرسانی پرداختهای موفق، انتشار خودکار مطالب سایت در کانال بله، ارسال گزارشهای روزانه، هشدارهای مانیتورینگ و بسیاری از فرآیندهای دیگر.
