ساخت اولین ربات تلگرام: از BotFather تا پایتون

[Ali]

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

بخش اول: ایجاد ربات با BotFather

قبل از هرگونه کدنویسی، باید ربات خود را در تلگرام ثبت کنید. این کار توسط ربات رسمی تلگرام به نام BotFather انجام می‌شود.

1. پیدا کردن BotFather: در تلگرام خود، @BotFather را جستجو کرده و با او چت را آغاز کنید.
2. شروع ساخت ربات: دستور /newbot را برای BotFather ارسال کنید.
3. انتخاب نام: BotFather از شما می‌خواهد نامی برای ربات خود انتخاب کنید. این نام همان چیزی است که کاربران در چت با ربات شما می‌بینند (مثلاً "ربات تست من").
4. انتخاب نام کاربری (Username): در مرحله بعد، باید یک نام کاربری برای ربات خود انتخاب کنید. این نام کاربری باید منحصر به فرد باشد و حتماً به -bot یا Bot ختم شود (مثلاً MyFirstTestBot).
5. دریافت توکن API: پس از موفقیت‌آمیز بودن مراحل بالا، BotFather یک پیام تبریک همراه با یک "توکن API" برای شما ارسال می‌کند. این توکن یک رشته کاراکتری طولانی و بسیار مهم است (مثلاً 123456:ABC-DEF1234ghIkl-7890Jkl). این توکن کلید ربات شماست و باید آن را محرمانه نگه دارید. هرگز آن را با کسی به اشتراک نگذارید.
6. تنظیمات بیشتر (اختیاری): می‌توانید با دستورات دیگری مانند /setdescription، /setabouttext، و /setuserpic توضیحات و عکس پروفایل برای ربات خود تنظیم کنید.

بخش دوم: شروع کدنویسی با پایتون

حالا که ربات شما ایجاد شده و توکن API را در اختیار دارید، نوبت به کدنویسی می‌رسد. ما از کتابخانه محبوب python-telegram-bot استفاده خواهیم کرد که کار با API تلگرام را بسیار ساده می‌کند.

پیش‌نیازها:

• پایتون (نسخه 3.6 به بالا) نصب شده باشد.
• مدیریت بسته pip نصب شده باشد.

1. نصب کتابخانه:
ترمینال یا Command Prompt خود را باز کنید و دستور زیر را اجرا کنید:

محتوای بلوک کدها در دسترس شما نیست. برای مشاهده بلوک کدها، وارد انجمن شوید یاثبت نام کنید

(استفاده از --pre برای دریافت آخرین نسخه‌های در حال توسعه است که معمولاً پایدارتر و کامل‌تر هستند.)

2. نوشتن اولین کد ربات:
یک فایل پایتون جدید با نام my_bot.py ایجاد کنید و کد زیر را در آن قرار دهید:

محتوای بلوک کدها در دسترس شما نیست. برای مشاهده بلوک کدها، وارد انجمن شوید یاثبت نام کنید

توضیح کد:

• TOKEN: توکن API که از BotFather دریافت کردید را در این قسمت قرار دهید.
• start(update, context): این تابع زمانی اجرا می‌شود که کاربر دستور /start را به ربات ارسال کند. update.effective_user.mention_html() نام کاربر را به صورت لینک‌دار نمایش می‌دهد. reply_html برای ارسال پیام با قابلیت‌های HTML است.
• echo(update, context): این تابع هر پیام متنی غیر دستوری (یعنی پیامی که با / شروع نشود) را دریافت کرده و همان پیام را به کاربر بازمی‌گرداند.
• Application.builder().token(TOKEN).build(): شیء اصلی ربات را با توکن شما ایجاد می‌کند.
• CommandHandler("start", start): یک هندلر برای دستور /start ایجاد می‌کند و آن را به تابع start متصل می‌کند.
• MessageHandler(filters.TEXT & ~filters.COMMAND, echo): یک هندلر برای پیام‌های متنی (که دستور نیستند) ایجاد می‌کند و آن را به تابع echo متصل می‌کند.
• application.run_polling(): این خط ربات شما را راه‌اندازی کرده و به صورت مداوم به سرورهای تلگرام متصل می‌شود تا به‌روزرسانی‌ها (پیام‌ها، دستورات و...) را دریافت کند.

3. اجرای ربات:
فایل my_bot.py را ذخیره کنید. سپس ترمینال خود را باز کرده، به مسیری که فایل را ذخیره کرده‌اید بروید و دستور زیر را اجرا کنید:

محتوای بلوک کدها در دسترس شما نیست. برای مشاهده بلوک کدها، وارد انجمن شوید یاثبت نام کنید

حالا به تلگرام بروید و ربات خود را پیدا کنید (با نام کاربری که انتخاب کردید). با آن چت کنید! دستور /start را ارسال کنید یا یک پیام متنی بفرستید تا پاسخ ربات خود را ببینید.

گام‌های بعدی:

این فقط شروع کار است! با python-telegram-bot می‌توانید کارهای بسیار پیچیده‌تری انجام دهید:

• دکمه‌های Inline و کیبورد سفارشی: برای تعاملات پیشرفته‌تر.
• پایگاه داده: برای ذخیره اطلاعات کاربران و تنظیمات.
• وب‌هوک‌ها (Webhooks): برای مقیاس‌پذیری بیشتر و عملکرد بهتر در محیط‌های سرور.
• ادغام با APIهای دیگر: برای افزودن قابلیت‌های متنوع (مثلاً وضعیت آب و هوا، قیمت ارز و...).

امیدوارم این راهنما به شما کمک کرده باشد تا اولین قدم‌های خود را در دنیای ساخت ربات تلگرام بردارید!