سورس ربات شبیه‌ساز BotFather تلگرام | python-telegram-bot

معرفی سورس

یک ربات تلگرام جذاب و آموزشی که فرآیند ساخت ربات در BotFather را شبیه‌سازی می‌کند. کاربران می‌توانند با استفاده از دستور /newbot یک ربات جدید (به صورت ساختگی) بسازند، برای آن نام کاربری انتخاب کنند، نام نمایشی و توضیحات تعیین کنند و حتی دستورات آن را مشخص کنند. در پایان یک توکن تصادفی به کاربر نمایش داده می‌شود.

🎯 ویژگی‌ها

• ✅ شبیه‌سازی فرآیند ساخت ربات در BotFather
• ✅ استفاده از ConversationHandler برای مدیریت مراحل مختلف (حالت مکالمه)
• ✅ دریافت و اعتبارسنجی نام کاربری ربات (باید به bot ختم شود)
• ✅ تولید توکن تصادفی ۴۵ کاراکتری برای هر ربات
• ✅ امکان تعیین نام، توضیحات و لیست دستورات ربات
• ✅ نمایش لیست ربات‌های ساخته‌شده با /mybots
• ✅ قابلیت لغو عملیات با /cancel
• ✅ مدیریت خطا و لاگ‌گیری کامل
• ✅ کدنویسی تمیز و دارای کامنت‌های توضیحی

📦 محتویات سورس

• bot.py – کد کامل ربات با تمام هندلرها
• ruquirements.txt – کتابخانه مورد نیاز سورس

پیش‌نیازها: کتابخانه python-telegram-bot (نسخه ۲۰ به بالا) و پایتون ۳.۸+

🚀 نحوه اجرا

1. کتابخانه مورد نیاز را نصب کنید: pip install -r requirements.txt
2. توکن ربات خود را در متغیر BOT_TOKEN در کد جایگزین کنید.
3. فایل bot.py را اجرا کنید: python bot.py
4. در تلگرام به ربات خود پیام دهید و از دستورات start، /newbot/ و mybots/ استفاده کنید.

🎓 کاربرد آموزشی

این سورس یک مثال عالی برای یادگیری مفاهیم پیشرفته در کتابخانه python-telegram-bot است:

• ConversationHandler: مدیریت مکالمات چند مرحله‌ای با کاربر
• ForceReply: وادار کردن کاربر به پاسخ دادن
• context.user_data و bot_data: ذخیره‌سازی موقت اطلاعات در حافظه
• اعتبارسنجی ورودی: بررسی صحت نام کاربری

📋 مشخصات فنی

• زبان برنامه‌نویسی: Python 3.8+
• کتابخانه اصلی: python-telegram-bot (v20+)
• نوع ذخیره‌سازی: موقت در حافظه (با ری‌استارت ربات پاک می‌شود)
• الگوهای طراحی: ConversationHandler, ForceReply
• پلتفرم: تلگرام
• تعداد فایل: ۱
• حجم کد: حدود ۲۰۰ خط

⚠️ نکات مهم

• این ربات صرفاً یک شبیه‌ساز است و ربات واقعی در تلگرام نمی‌سازد.
• داده‌ها در حافظه موقت ذخیره می‌شوند و با ری‌استارت ربات از بین می‌روند.
• برای استفاده واقعی، باید توکن ربات خود را از @BotFather دریافت کنید.
• اعتبارسنجی نام کاربری بسیار ساده است و صرفاً وجود "bot" در انتها را بررسی می‌کند.

🎁 این سورس برای چه کسانی مناسب است؟

• توسعه‌دهندگانی که می‌خواهند با ConversationHandler کار کنند
• افرادی که به دنبال یک پروژه آموزشی جذاب برای یادگیری python-telegram-bot هستند
• کسانی که می‌خواهند یک شبیه‌ساز ساده برای نمایش قابلیت‌های ربات‌ها داشته باشند
• مدرسین برای آموزش مفاهیم مدیریت حالت (State Management) در ربات‌های تلگرام

💡 چرا این سورس؟

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