فصل ۵: اولین پروژه؛ ربات ساده پاسخ‌گو در تلگرام با پایتون

""

مقدمه

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

مراحل آموزش

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

برای ارتباط برنامه‌نویسی پایتون با تلگرام، به کتابخانه رسمی نیاز داریم.
در محیط ترمینال/کامندلاین دستور زیر را اجرا کنید:

pip install python-telegram-bot --upgrade

(در صورتی که نصب کردی، این مرحله را رد کن.)

۲. کدنویسی اولین ربات ساده

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

from telegram.ext import Updater, CommandHandler, MessageHandler, Filters

# توکن ربات را جایگزین کنید
TOKEN = 'توکن_دریافتی_از_BotFather'

def start(update, context):
    update.message.reply_text("سلام! من ربات تلگرام شما هستم.")

def echo(update, context):
    # هر پیام را تکرار می‌کند
    update.message.reply_text(update.message.text)

def main():
    updater = Updater(TOKEN, use_context=True)
    dp = updater.dispatcher

    dp.add_handler(CommandHandler("start", start))
    dp.add_handler(MessageHandler(Filters.text, echo))

    updater.start_polling()
    updater.idle()

if __name__ == '__main__':
    main()
  • جای 'توکن_دریافتی_از_BotFather' مقدار توکن خود را بگذارید.
  • این ربات وقتی کاربر پیامی بفرستد، همان پیام را به او برمی‌گرداند (اکو).

۳. اجرای کد و تست عملکرد ربات

در خط فرمان پوشه‌ای که bot.py قرار دارد، دستور زیر را بزنید:

python bot.py

اگر پیغام خطا مشاهده نکردید، ربات شما روشن است.

  • وارد تلگرام شوید.
  • به رباتتان پیام بدهید (مثلاً «سلام»).
  • ربات باید همان پیام را به شما پاسخ دهد.

۴. توضیحات مرحله‌به‌مرحله

  • CommandHandler: برای فرمان‌های خاص مثل /start
  • MessageHandler: برای هر نوع پیام متنی
  • reply_text: ارسال پیام به کاربر
  • updater.start_polling(): ربات دائماً پیام‌ها را چک می‌کند

۵. نکات و جمع‌بندی

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

ترفند سریع با هوش مصنوعی (برای علاقه‌مندان به ابزارهای جدید)

  • اگر می‌خواهید کد ربات را سریع‌تر و با خطای کمتر بنویسید، می‌توانید شرح پروژه را به ChatGPT بدهید تا کد پایه را برایتان تولید کند یا اشکالات کد خود را به آن بسپارید.
محمد وب‌سایت
مطالب مشابه

دیدگاهتان را بنویسید

نشانی ایمیل شما منتشر نخواهد شد. بخش‌های موردنیاز علامت‌گذاری شده‌اند *