سلام دوست من! 👋 یادگیری ساخت ربات هم خیلی لذت‌بخشه و هم می‌تونه کلی درهای جدید برنامه‌نویسی رو به روت باز کنه. توی این آموزش، گام‌به‌گام و خیلی ساده با هم پیش می‌ریم تا یک ربات تلگرامی واقعی و کاربردی بسازیم.

اصلاً نگران نباش، حتی اگه تازه‌کار هم باشی، این مسیر رو با هم خیلی راحت طی می‌کنیم! 🚀

📋 پیش‌نیازهای کار

قبل از اینکه شروع کنیم، فقط به چند چیز کوچک نیاز داریم:

1. پایتون (Python) نصب‌شده روی کامپیوترت (ترجیحاً نسخه ۳.۸ یا بالاتر).
2. یک اکانت تلگرام فعال.
3. یک ویرایشگر کد ساده مثل VS Code یا PyCharm (حتی IDLE خود پایتون هم کارسازه).

🎯 گام اول: دریافت توکن (Token) از BotFather

تلگرام یک پدر برای تمام ربات‌ها داره به اسم BotFather! برای اینکه ربات خودت رو ثبت کنی، باید بری پیش پدر ربات‌ها!

1. اپلیکیشن تلگرام رو باز کن و عبارت @BotFather رو جستجو کن (مواظب باش اکانت‌های تقلبی رو انتخاب نکنی، اونی که تیک آبی داره درسته).
2. دکمه Start رو بزن.
3. دستور /newbot رو ارسال کن.
4. ازت می‌پرسه: نام رباتت چیه؟ (مثلاً: دوست هوشمند من).
5. بعدش می‌پرسه: نام کاربری (Username) رباتت چی باشه؟ (باید به bot ختم بشه، مثلاً: my_friendly_python_bot).
6. اگر نام کاربری تکراری نباشه، BotFather یک توکن (Token) اختصاصی بهت میده. این توکن مثل کلید خانه رباتته! ⚠️ حواست باشه این توکن رو به کسی ندی!

توکن چیزی شبیه به این خواهد بود: 1234567890:ABCdefGhIJKlmNoPQRsTUVwxyZ123456

📦 گام دوم: آماده‌سازی محیط و نصب کتابخانه

حالا بریم سراغ کامپیوترت. می‌خوایم یک کتابخانه عالی و ساده پایتون به اسم pyTelegramBotAPI (که بهش telebot هم میگن) رو نصب کنیم.

1. محیط ترمینال (Terminal) یا CMD رو باز کن.
2. دستور زیر رو وارد کن و کلید Enter رو بزن:

pip install pyTelegramBotAPI

کمی صبر کن تا نصب با موفقیت تموم بشه. همین! ابزار کارمون آماده‌ست. 🎉

💻 گام سوم: نوشتن اولین کد ربات

یک پوشه جدید بساز و داخلش یک فایل به اسم main.py یا bot.py ایجاد کن. حالا کدهای زیر رو داخلش کپی کن:

import telebot

# 🔑 توکنی که از BotFather گرفتی رو بین دو کوتیشن بذار
TOKEN = 'YOUR_BOT_TOKEN_HERE'

# ساخت شیء اصلی ربات
bot = telebot.TeleBot(TOKEN)

# 1️⃣ پاسخ به دستور /start
@bot.message_handler(commands=['start'])
def send_welcome(message):
    user_name = message.from_user.first_name
    welcome_text = f"سلام {user_name} عزیز! 👋\nبه ربات خودت خوش اومدی. چطور می‌تونم کمکت کنم؟"
    bot.reply_to(message, welcome_text)

# 2️⃣ پاسخ به دستور /help
@bot.message_handler(commands=['help'])
def send_help(message):
    help_text = "این یک ربات تستیه! 🛠️\nهر پیامی برام بفرستی، عین همونو برات تکرار می‌کنم (اکو می‌کنم)!"
    bot.reply_to(message, help_text)

# 3️⃣ پاسخ به پیام‌های متنی عادی (Echo Bot)
@bot.message_handler(func=lambda message: True)
def echo_all(message):
    bot.reply_to(message, f"شما گفتی: {message.text} 😃")

# 🚀 روشن نگه داشتن ربات
print("ربات شما با موفقیت روشن شد و منتظر پیام‌هاست...")
bot.infinity_polling()

⚠️ یادت نره: عبارت 'YOUR_BOT_TOKEN_HERE' رو با توکن واقعی خودت جایگزین کن!

🔍 گام چهارم: کدها چی می‌گن؟ (توضیح به زبان ساده)

بیا با هم کدهایی که نوشتیم رو بررسی کنیم:

• import telebot: کتابخانه‌ای که نصب کردیم رو وارد برنامه‌مون می‌کنه.
• bot = telebot.TeleBot(TOKEN): اتصال برنامه ما به سرورهای تلگرام رو برقرار می‌کنه.
• @bot.message_handler(...): به این‌ها میگن «دکوراتور». مثل نگهبان عمل می‌کنن! بررسی می‌کنن اگه کاربر دستور خاصی فرستاد (مثل /start)، تابع زیرش اجرا بشه.
• bot.reply_to(...): این تابع مستقیم روی همون پیام کاربر ریپلای (Reply) می‌کنه.
• bot.infinity_polling(): ربات رو در حالت گوش‌به‌زنگ دائمی قرار میده تا هروقت پیامی اومد، سریع پاسخ بده.

🎨 گام پنجم: افزودن دکمه‌های جذاب (Keyboard)

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

کد زیر رو ببین که چطور دکمه به دستور /menu اضافه می‌کنه:

from telebot import types

@bot.message_handler(commands=['menu'])
def show_menu(message):
    # ساخت کیبورد
    markup = types.ReplyKeyboardMarkup(row_width=2, resize_keyboard=True)
    
    # تعریف دکمه‌ها
    btn1 = types.KeyboardButton('درباره ما ℹ️')
    btn2 = types.KeyboardButton('ارتباط با پشتیبانی 📞')
    btn3 = types.KeyboardButton('یک جوک بگو! 😂')
    
    # چیدمان دکمه‌ها
    markup.add(btn1, btn2)
    markup.add(btn3)
    
    bot.send_message(message.chat.id, "لطفاً یک گزینه را انتخاب کنید:", reply_markup=markup)

# مدیریت کلیک روی دکمه‌ها
import random

@bot.message_handler(func=lambda message: message.text == 'یک حقیقت بگو! 🤓')
def fact(message):
    facts = [
        "پایتون در سال ۱۹۹۱ ساخته شد.",
        "اولین کامپیوترها اندازه یک اتاق بودند.",
        "نام پایتون از برنامه تلویزیونی Monty Python گرفته شده است."
    ]
    bot.reply_to(message, random.choice(facts))

🚀 گام ششم: اجرای ربات و تست

1. در ترمینال یا CMD، به پوشه‌ای که فایل پایتون در اون قرار داره برو.
2. دستور زیر رو اجرا کن:

python main.py

3. اگه همه چیز درست باشه، پیغام «ربات شما با موفقیت روشن شد...» رو در ترمینال می‌بینی.
4. حالا برو توی تلگرام، وارد رباتت بشو و دکمه Start رو بزن! مبارکه! 🎉

🌟 قدم‌های بعدی چیه؟

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

• 🗄️ اتصال به دیتابیس (مثل SQLite): برای ذخیره اطلاعات کاربران.
• 🌐 استفاده از APIهای مختلف: مثل گرفتن قیمت ارز، آب‌وهوا، یا اخبار روز.
• ☁️ ** اجرا روی تله‌ران (telerun.ir): برای اینکه رباتت بدون نیاز به روشن بودن کامپیوترت ۲۴ ساعته آنلاین بمونه، می‌تونی کدهات رو خیلی راحت روی وب‌سایت telerun.ir آپلود و اجرا کنی تا همیشه فعال و در دسترس باشه!

💡 جمع‌بندی

برنامه‌نویسی یک مسیر پر از تجربه و لذته. با همین چند خط کد ساده دیدی که ساخت یک ربات اصلاً کار پیچیده‌ای نیست. اگه جایی به مشکلی خوردی یا سوالی داشتی، اصلاً نگران نباش؛ خطا دادن بخش طبیعی برنامه‌نویسیه‌!

موفق باشی دوست من! ساختن رو ادامه بده... 🔥✨