ساخت ربات تلگرام با پایتون از صفر

📋 پیش‌نیازها

• ✅ نصب بودن Python 3.9 یا بالاتر
• ✅ یک اکانت تلگرام
• ✅ یک ویرایشگر کد مثل VS Code
• ✅ آشنایی ابتدایی با متغیر و تابع در پایتون

🔑 مرحله ۱: ساخت ربات در BotFather

• ① در تلگرام @BotFather را جستجو و استارت کن
• ② دستور /newbot را بفرست
• ③ نام و یوزرنیم (که آخرش bot باشد) انتخاب کن
• ④ توکن دریافتی را کپی کن

📦 مرحله ۲: نصب کتابخانه

pip install python-telegram-bot

💻 مرحله ۳: نوشتن اولین ربات

فایلی به نام bot.py بساز و کد زیر را داخلش بگذار:

from telegram import Update
from telegram.ext import (
    ApplicationBuilder, CommandHandler,
    MessageHandler, ContextTypes, filters
)

TOKEN = "YOUR_BOT_TOKEN"

async def start(update: Update, context: ContextTypes.DEFAULT_TYPE):
    await update.message.reply_text("سلام! به ربات من خوش اومدی 👋")

async def echo(update: Update, context: ContextTypes.DEFAULT_TYPE):
    await update.message.reply_text(f"گفتی: {update.message.text}")

app = ApplicationBuilder().token(TOKEN).build()
app.add_handler(CommandHandler("start", start))
app.add_handler(MessageHandler(filters.TEXT & ~filters.COMMAND, echo))

print("Bot is running...")
app.run_polling()

🔍 این کد چطور کار می‌کند؟

بخش	توضیح
ApplicationBuilder	ربات را با توکن می‌سازد
CommandHandler	به دستورهایی مثل /start پاسخ می‌دهد
MessageHandler	پیام‌های متنی عادی را مدیریت می‌کند
run_polling()	مرتب پیام‌های جدید را از تلگرام می‌گیرد

▶️ مرحله ۴: اجرا

python bot.py

حالا به رباتت پیام بده؛ باید جواب بگیری 🎉

⚡ Polling یا Webhook؟

روش	مناسب برای	نکته
Polling	تست و توسعه	ساده‌ترین روش
Webhook	سرور و هاست واقعی	سریع‌تر، نیازمند HTTPS

💎 ایده‌هایی برای توسعه ربات

• ✅ دکمه‌های شیشه‌ای: Inline Keyboard برای منوهای تعاملی
• ✅ دیتابیس: ذخیره کاربران در SQLite یا MySQL
• ✅ درگاه پرداخت: ساخت ربات فروشگاهی
• ✅ پنل مدیریت: آمار و ارسال پیام همگانی

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