ساخت ربات تلگرام با پایتون: آموزش جامع

ربات‌های تلگرام ابزارهای قدرتمندی هستند که می‌توانند وظایف مختلفی را به صورت خودکار در تلگرام انجام دهند. از ارسال پیام‌های خودکار گرفته تا مدیریت گروه‌ها و ارائه خدمات مختلف، ربات‌ها می‌توانند به طور قابل توجهی کارایی و تعامل در تلگرام را افزایش دهند. پایتون به دلیل سادگی، خوانایی و کتابخانه‌های غنی، یک انتخاب عالی برای ساخت ربات‌های تلگرام است. این مقاله یک راهنمای جامع برای ساخت ربات تلگرام با پایتون ارائه می‌دهد، که برای افراد با دانش مقدماتی پایتون مناسب است و در دسته بندی ‘اتوماسیون و اسکریپت‌نویسی’ قرار می‌گیرد.

پیش‌نیازها

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

• پایتون 3.6 یا بالاتر: می‌توانید از وب‌سایت رسمی پایتون (https://www.python.org) دانلود کنید.
• یک ویرایشگر کد: مانند VS Code، PyCharm یا Sublime Text.
• یک حساب کاربری تلگرام.

مراحل ساخت ربات تلگرام

1. دریافت توکن ربات

اولین قدم، دریافت توکن (Token) ربات از BotFather است. BotFather یک ربات تلگرام است که به شما کمک می‌کند ربات‌های جدید ایجاد کنید و تنظیمات آن‌ها را مدیریت کنید.

1. در تلگرام، BotFather را جستجو کنید و با آن شروع به چت کنید.
2. فرمان /newbot را ارسال کنید.
3. یک نام برای ربات خود انتخاب کنید.
4. یک نام کاربری (Username) برای ربات خود انتخاب کنید. نام کاربری باید با کلمه “bot” به پایان برسد.
5. BotFather توکن ربات شما را نمایش می‌دهد. این توکن را در یک مکان امن ذخیره کنید، زیرا برای دسترسی به API تلگرام ربات شما ضروری است.

2. نصب کتابخانه python-telegram-bot

برای تعامل با API تلگرام در پایتون، از کتابخانه python-telegram-bot استفاده می‌کنیم. این کتابخانه یک رابط کاربری ساده و قدرتمند برای ساخت ربات‌های تلگرام فراهم می‌کند.

برای نصب کتابخانه، از دستور زیر در ترمینال یا خط فرمان استفاده کنید:

pip install python-telegram-bot

3. ساخت اسکلت ربات

اکنون می‌توانیم اسکلت اصلی ربات خود را ایجاد کنیم. یک فایل پایتون جدید ایجاد کنید (مثلاً bot.py) و کد زیر را در آن قرار دهید:

from telegram import Update
from telegram.ext import ApplicationBuilder, CommandHandler, MessageHandler, filters

# توکن ربات خود را اینجا قرار دهید
TOKEN = "YOUR_BOT_TOKEN"

async def start(update: Update, context):
    await context.bot.send_message(chat_id=update.effective_chat.id, text="سلام! من یک ربات تلگرام هستم.")

async def echo(update: Update, context):
    await context.bot.send_message(chat_id=update.effective_chat.id, text=update.message.text)

def main():
    application = ApplicationBuilder().token(TOKEN).build()

    start_handler = CommandHandler('start', start)
    echo_handler = MessageHandler(filters.TEXT & (~filters.COMMAND), echo)

    application.add_handler(start_handler)
    application.add_handler(echo_handler)

    application.run_polling()

if __name__ == '__main__':
    main()

در این کد:

• TOKEN: توکن ربات خود را در اینجا جایگزین کنید.
• start: این تابع زمانی فراخوانی می‌شود که کاربر دستور /start را ارسال کند.
• echo: این تابع هر پیامی را که کاربر ارسال می‌کند، تکرار می‌کند.
• main: این تابع برنامه ربات را راه‌اندازی می‌کند و هندلرها را اضافه می‌کند.

4. اجرای ربات

برای اجرای ربات، فایل bot.py را در ترمینال یا خط فرمان اجرا کنید:

python bot.py

اکنون ربات شما در تلگرام فعال است. با ربات خود در تلگرام شروع به چت کنید و دستور /start را ارسال کنید. ربات باید به شما پاسخ دهد. همچنین، هر پیامی که ارسال کنید، ربات آن را تکرار خواهد کرد.

افزودن قابلیت‌های بیشتر

اکنون که اسکلت اصلی ربات را ایجاد کرده‌اید، می‌توانید قابلیت‌های بیشتری به آن اضافه کنید. در اینجا چند ایده برای شروع وجود دارد:

1. پاسخ به دستورات سفارشی

می‌توانید دستورات سفارشی خود را تعریف کنید و توابعی را برای پاسخ به آن‌ها ایجاد کنید. به عنوان مثال، می‌توانید یک دستور /help ایجاد کنید که اطلاعاتی در مورد ربات ارائه می‌دهد.

async def help(update: Update, context):
    await context.bot.send_message(chat_id=update.effective_chat.id, text="این ربات یک ربات نمونه است که پیام‌ها را تکرار می‌کند.")

help_handler = CommandHandler('help', help)
application.add_handler(help_handler)

2. مدیریت پیام‌های مختلف

می‌توانید از فیلترها برای مدیریت پیام‌های مختلف استفاده کنید. به عنوان مثال، می‌توانید پیام‌های حاوی تصاویر یا ویدیوها را پردازش کنید.

async def handle_image(update: Update, context):
    await context.bot.send_message(chat_id=update.effective_chat.id, text="تصویر دریافت شد!")

image_handler = MessageHandler(filters.PHOTO, handle_image)
application.add_handler(image_handler)

3. استفاده از کیبوردها

می‌توانید از کیبوردها برای ارائه گزینه‌هایی به کاربران استفاده کنید. این می‌تواند تعامل با ربات را آسان‌تر و جذاب‌تر کند.

from telegram import ReplyKeyboardMarkup

async def show_keyboard(update: Update, context):
    keyboard = [[ "گزینه 1", "گزینه 2" ],
                [ "گزینه 3", "گزینه 4" ]]
    reply_markup = ReplyKeyboardMarkup(keyboard)
    await context.bot.send_message(chat_id=update.effective_chat.id, text="لطفاً یک گزینه را انتخاب کنید:", reply_markup=reply_markup)

keyboard_handler = CommandHandler('keyboard', show_keyboard)
application.add_handler(keyboard_handler)

4. ذخیره و بازیابی داده‌ها

می‌توانید از پایگاه داده یا فایل‌ها برای ذخیره و بازیابی داده‌ها استفاده کنید. این می‌تواند برای ذخیره تنظیمات کاربر، اطلاعات محصول یا هر نوع داده دیگری که ربات شما نیاز دارد، مفید باشد.

نکات مهم

• امنیت: توکن ربات خود را در یک مکان امن ذخیره کنید و آن را با کسی به اشتراک نگذارید.
• مدیریت خطا: کد خود را به گونه‌ای طراحی کنید که خطاها را به درستی مدیریت کند و از خرابی ربات جلوگیری کند.
• مستندات: مستندات کتابخانه python-telegram-bot را به دقت مطالعه کنید تا از تمام قابلیت‌های آن آگاه شوید.
• بهینه‌سازی: کد خود را بهینه کنید تا ربات شما سریع و کارآمد باشد.

نتیجه‌گیری

ساخت ربات تلگرام با پایتون یک فرآیند نسبتاً ساده و سرگرم‌کننده است. با استفاده از کتابخانه python-telegram-bot و دانش پایتون، می‌توانید ربات‌های قدرتمندی ایجاد کنید که وظایف مختلفی را در تلگرام انجام دهند. این مقاله یک نقطه شروع خوب برای یادگیری ساخت ربات تلگرام با پایتون است. با تمرین و آزمایش، می‌توانید مهارت‌های خود را بهبود بخشید و ربات‌های پیچیده‌تری ایجاد کنید.