Project Detail
شروع پروژه

معرفی پروژه

Bale to Telegram Forwarder یک ابزار اتوماسیون پیام‌رسان است که برای انتقال خودکار محتوا از پیام‌رسان بله به کانال تلگرام طراحی شده است. این پروژه زمانی کاربرد دارد که محتوا ابتدا در بله دریافت یا مدیریت می‌شود، اما نیاز است همان محتوا به‌صورت خودکار در یک کانال تلگرام نیز منتشر شود. برنامه با Python توسعه داده شده و برای اتصال به تلگرام از کتابخانه python-telegram-bot استفاده می‌کند. تنظیمات حساس مثل توکن بات بله، توکن بات تلگرام و شناسه کانال تلگرام از طریق Environment Variables مدیریت می‌شوند تا اطلاعات محرمانه داخل فایل‌های اصلی پروژه قرار نگیرند. این ابزار از انواع مختلف پیام‌ها پشتیبانی می‌کند؛ از جمله پیام متنی، عکس، فایل، پیام صوتی، ویدئو و فایل صوتی. در پیام‌های رسانه‌ای، فایل از بله دریافت شده و دوباره در تلگرام آپلود می‌شود و کپشن اصلی نیز حفظ می‌شود.
مسئله اصلی

چالش پروژه

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

راه حل اجرا

برای حل این مسئله، یک Forwarder با Python پیاده‌سازی شد که از توکن بات بله برای دریافت پیام‌ها و از توکن بات تلگرام برای ارسال محتوا به کانال مقصد استفاده می‌کند. تنظیمات اصلی پروژه از طریق فایل .env یا Environment Variables خوانده می‌شود تا امنیت اطلاعات بهتر حفظ شود. برای سناریوی اجرا نیز در مستندات پروژه پیشنهاد شده که بات روی VPS خارجی یا سرویس‌های ابری اجرا شود، چون ابزار باید همزمان به بله و تلگرام دسترسی داشته باشد. همچنین پشتیبانی از چند نوع پیام در نظر گرفته شده تا ابزار فقط محدود به متن نباشد و بتواند فایل‌های رسانه‌ای را نیز همراه با کپشن اصلی منتقل کند.
دستاورد نهایی

خروجی و نتیجه

خروجی پروژه یک ابزار کاربردی برای اتوماسیون انتشار محتوا بین دو پیام‌رسان است. این ابزار فرآیند انتقال محتوا از بله به تلگرام را سریع‌تر و منظم‌تر می‌کند و برای مدیریت کانال‌ها، انتشار همزمان محتوا و کاهش کار دستی مناسب است. پروژه با ساختار ساده و وابستگی‌های محدود توسعه داده شده و برای راه‌اندازی فقط به Python 3.9 یا بالاتر، توکن بات بله، توکن بات تلگرام و دسترسی ادمین بات در کانال تلگرام نیاز دارد.
زیرساخت اجرا

فناوری های پروژه

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

Python Telegram Bot API Bale Bot API python-telegram-bot requests python-dotenv Environment Variables VPS Deployment
گام بعدی

لینک های پروژه