ساخت ربات تلگرام ساده با پایتون و Telebot: شروعی آسان

[Ali]

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

پیش‌نیازها:

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

• پایتون: نسخه 3.6 به بالا. می‌توانید آن را از وب‌سایت رسمی پایتون دانلود و نصب کنید.
• pip: ابزار مدیریت پکیج‌های پایتون که معمولاً با نصب پایتون همراه است.
• یک حساب کاربری تلگرام: برای ساخت ربات و تست آن.
• آشنایی اولیه با پایتون: درک مفاهیم پایه مانند توابع، متغیرها و دکوراتورها مفید خواهد بود.

گام اول: ساخت ربات و دریافت توکن از BotFather

برای اینکه ربات شما با سرورهای تلگرام ارتباط برقرار کند، به یک توکن API نیاز دارید. این توکن را از ربات رسمی تلگرام به نام BotFather دریافت می‌کنید:

1. در تلگرام، BotFather@ را در قسمت جستجو پیدا کرده و با آن چت کنید.
2. دستور /newbot را ارسال کنید.
3. BotFather از شما می‌خواهد یک نام نمایشی (Display Name) برای ربات خود انتخاب کنید. این نامی است که کاربران در چت با ربات شما می‌بینند (مثلاً "ربات آزمایشی من").
4. سپس از شما می‌خواهد یک نام کاربری (Username) برای ربات خود انتخاب کنید. این نام باید منحصر به فرد باشد و حتماً با پسوند _bot یا Bot به پایان برسد (مثلاً MyTestBot_bot).
5. پس از انتخاب نام کاربری، BotFather یک توکن API به شما می‌دهد. این توکن چیزی شبیه 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11 خواهد بود. این توکن را در جایی امن نگه دارید و آن را با کسی به اشتراک نگذارید، زیرا کلید دسترسی به ربات شماست.

گام دوم: نصب کتابخانه pyTelegramBotAPI

حالا که توکن ربات خود را دارید، باید کتابخانه پایتون مورد نیاز برای تعامل با API تلگرام را نصب کنید.

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

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

این دستور آخرین نسخه کتابخانه pyTelegramBotAPI را نصب می‌کند.

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

یک فایل پایتون جدید با نام دلخواه (مثلاً my_first_bot.py) ایجاد کنید و کد زیر را در آن کپی کنید. فراموش نکنید که YOUR_BOT_TOKEN_HERE را با توکن واقعی که از BotFather دریافت کردید، جایگزین کنید.

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

توضیح کد:

• import telebot: این خط کتابخانه telebot را وارد برنامه می‌کند تا بتوانیم از توابع و کلاس‌های آن استفاده کنیم.
• API_TOKEN = 'YOUR_BOT_TOKEN_HERE': توکن API ربات شما در این متغیر ذخیره می‌شود.
• bot = telebot.TeleBot(API_TOKEN): یک شیء (object) از کلاس TeleBot ایجاد می‌کند که نماینده ربات شماست. تمام عملیات مربوط به ربات از طریق این شیء انجام می‌شود.
• @bot.message_handler(commands=['start']): این یک "دکوراتور" پایتون است که تابع send_welcome را به عنوان یک هندلر (handler) برای دستور /start ثبت می‌کند. وقتی کاربری /start را می‌فرستد، این تابع اجرا می‌شود.
• bot.reply_to(message, "..."): این متد برای پاسخ دادن به پیامی که ربات دریافت کرده استفاده می‌شود. message شیءای است که حاوی اطلاعات پیام دریافتی است.
• @bot.message_handler(func=lambda message: True): این دکوراتور تابع echo_all را به عنوان یک هندلر برای تمام پیام‌های متنی که توسط هندلرهای قبلی مدیریت نشده‌اند، ثبت می‌کند. lambda message: True به این معنی است که این هندلر برای همه پیام‌ها مطابقت دارد.
• bot.polling(none_stop=True): این متد ربات را در حالت "polling" قرار می‌دهد، به این معنی که ربات به طور مداوم سرورهای تلگرام را برای دریافت پیام‌های جدید بررسی می‌کند. none_stop=True باعث می‌شود اگر خطایی در حین پردازش پیام‌ها رخ داد، ربات متوقف نشود و به کار خود ادامه دهد.

گام چهارم: اجرای ربات

1. فایل پایتون خود (مثلاً my_first_bot.py) را ذخیره کنید.
2. ترمینال یا Command Prompt را باز کرده و به مسیری که فایل را ذخیره کرده‌اید بروید.
3. دستور زیر را اجرا کنید:

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

پس از اجرای دستور، پیامی مانند "ربات در حال اجرا است..." را در ترمینال خواهید دید.

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

مراحل بعدی و توسعه پیشرفته:

ساخت این ربات ساده تنها شروع کار است. دنیای ربات‌های تلگرام بسیار وسیع است و می‌توانید قابلیت‌های پیچیده‌تری به ربات خود اضافه کنید:

• کیبوردها (Keyboards): اضافه کردن دکمه‌های قابل کلیک سفارشی (Inline Keyboards یا Reply Keyboards) برای تعامل بهتر و آسان‌تر با کاربر.
• وب‌هوک‌ها (Webhooks): به جای polling، می‌توانید از وب‌هوک‌ها برای دریافت پیام‌ها استفاده کنید. این روش برای ربات‌های بزرگتر و در محیط‌های سرور (مانند هاستینگ) توصیه می‌شود، زیرا کارآمدتر است و نیاز به اتصال مداوم ندارد.
• پایگاه داده: ذخیره اطلاعات کاربران، تنظیمات، یا وضعیت‌های مختلف در یک دیتابیس (مانند SQLite, PostgreSQL, MongoDB) برای ساخت ربات‌های هوشمندتر و شخصی‌سازی شده.
• Inline Mode: اجازه دادن به کاربران برای تعامل با ربات در هر چتی، بدون نیاز به اضافه کردن ربات به گروه یا شروع چت مستقیم با آن.
• مدیریت خطا پیشرفته: اضافه کردن مکانیزم‌های پیشرفته‌تر برای لاگ‌گیری و مدیریت خطاها برای پایداری بیشتر ربات.
• استفاده از APIهای خارجی: اتصال ربات به APIهای دیگر (مثلاً آب و هوا، قیمت ارز، اخبار) برای ارائه اطلاعات متنوع‌تر.

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