آموزش ساخت ربات تلگرامی خوش‌آمدگویی روی ساب‌دامین

اگر شما هم دوست دارید یک ربات تلگرامی ساده بسازید که به کاربران خوش‌آمد بگوید و آن را روی هاست خود اجرا کنید، در این آموزش از ایران پای، قدم‌به‌قدم به شما نشان می‌دهیم که چگونه یک ربات تلگرام با پایتون برای خوش‌آمدگویی بسازید و آن را با استفاده از ابزار Setup Python App در cPanel روی یک ساب‌دامین آنلاین کنید. آموزش ساخت ربات تلگرام برای مبتدیان و افرادی که می‌خواهند یک پروژه کاربردی را تجربه کنند، طراحی شده است. این محتوا بخشی از آموزش پایتون رایگان است. با ما همراه باشید!

چرا این آموزش برای شما مفید است؟

ساخت ربات تلگرامی و اجرای آن روی هاست، نه‌تنها یک پروژه جذاب است، بلکه به شما کمک می‌کند با مفاهیم برنامه‌نویسی پایتون، مدیریت هاست و ابزارهای cPanel بیشتر آشنا شوید. با استفاده از Setup Python App، می‌توانید ربات خود را به‌سادگی روی یک ساب‌دامین اجرا کنید و از تداخل با دامنه اصلی جلوگیری کنید.

پیش‌نیازهای شروع

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

• هاست cPanel با قابلیت Setup Python App
• دسترسی به بخش Subdomains در cPanel
• توکن ربات تلگرام (می‌توانید از BotFather در تلگرام دریافت کنید)
• آشنایی اولیه با ترمینال و مفاهیم Cron Job
• نصب پایتون (نسخه پیشنهادی: 3.9 یا بالاتر)

کد ربات تلگرامی خوش‌آمدگویی

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

فایل: welcome_bot.py

import os
from aiogram import Bot, Dispatcher, types
from aiogram.utils import executor

# دریافت توکن از متغیر محیطی
TELEGRAM_BOT_TOKEN = os.getenv("TELEGRAM_BOT_TOKEN")

# بررسی وجود توکن
if not TELEGRAM_BOT_TOKEN:
    raise ValueError("لطفاً توکن ربات تلگرام را تنظیم کنید.")

# مقداردهی ربات و دیسپچر
bot = Bot(token=TELEGRAM_BOT_TOKEN)
dp = Dispatcher(bot)

# پاسخ به پیام‌های دریافتی
@dp.message_handler()
async def welcome_message(message: types.Message):
    user_name = message.from_user.first_name
    await message.reply(f"سلام {user_name} 👋\nبه ربات من خوش آمدی! 😊")

# تابع اصلی برای اجرا
def main():
    executor.start_polling(dp, skip_updates=True)

if __name__ == "__main__":
    main()

این کد ساده است و با کتابخانه aiogram کار می‌کند. حالا بیایید ببینیم چگونه آن را روی هاست خود آنلاین کنیم.

مراحل ساخت ربات تلگرام و آنلاین کردن ربات

۱. ساخت ساب‌دامین در cPanel

برای اینکه ربات روی یک آدرس اختصاصی اجرا شود، ابتدا یک ساب‌دامین می‌سازیم:

1. ورود به cPanel: وارد پنل هاست خود شوید.
2. بخش Subdomains: در cPanel، به قسمت Domains بروید و گزینه Subdomains را انتخاب کنید.
3. ایجاد ساب‌دامین:
   • نامی برای ساب‌دامین وارد کنید (مثلاً welcomebot).
   • دامنه اصلی را انتخاب کنید (مثلاً iranpy.com).
   • مسیر Document Root به‌صورت خودکار تنظیم می‌شود (مثلاً /home/username/public_html/welcomebot).
   • روی Create کلیک کنید.
4. نتیجه: حالا ساب‌دامین شما (مثلاً welcomebot.iranpy.com) آماده است و یک پوشه جدید برای آن ساخته شده.

۲. آپلود فایل ربات

• فایل welcome_bot.py را در پوشه ساب‌دامین (مثلاً /home/username/public_html/welcomebot/) آپلود کنید.
• می‌توانید از File Manager در cPanel یا نرم‌افزارهای FTP مثل FileZilla استفاده کنید.

۳. تنظیم Setup Python App

ابزار Setup Python App به شما کمک می‌کند تا ربات پایتونی خود را به‌راحتی اجرا کنید:

1. رفتن به Setup Python App:
   • در cPanel، به بخش Advanced بروید و Setup Python App را پیدا کنید.
2. ایجاد برنامه پایتونی:
   • روی Create Application کلیک کنید.
   • Python Version: نسخه‌ای مثل 3.9 را انتخاب کنید.
   • Application Root: مسیر ساب‌دامین را وارد کنید (مثلاً /home/username/public_html/welcomebot).
   • Application URL: ساب‌دامین را انتخاب کنید (مثلاً welcomebot.iranpy.com).
   • Application Startup File: فایل welcome_bot.py را وارد کنید.
   • Application Entry Point: این قسمت را خالی بگذارید.
   • روی Create کلیک کنید.
3. نصب کتابخانه‌ها:
   • Setup Python App یک محیط مجازی برای شما ایجاد می‌کند.
   • در بخش Add Module، کتابخانه aiogram را نصب کن
   • یا از ترمینال cPanel استفاده کنید:

source /home/username/virtualenv/public_html/welcomebot/3.9/bin/activate
pip install aiogram

۴. تنظیم توکن تلگرام

برای امنیت بیشتر، توکن ربات را در متغیرهای محیطی ذخیره می‌کنیم:

1. در Setup Python App، به بخش Environment Variables بروید.
2. یک متغیر جدید اضافه کنید:
   • Name: TELEGRAM_BOT_TOKEN
   • Value: توکن ربات خود را وارد کنید (مثلاً 8039911561:AAEm8zxMFOWWeszQ3qeL4YNAgNDyk8deSLk).
3. روی Add کلیک کنید.

۵. ساخت اسکریپت برای اجرای مداوم ربات

برای اطمینان از اینکه ربات همیشه فعال است، یک اسکریپت شل می‌سازیم:

1. ایجاد فایل check_bot.sh:
   • در پوشه ساب‌دامین، فایل check_bot.sh را بسازید:

nano /home/username/public_html/welcomebot/check_bot.sh

محتوای زیر را اضافه کنید:

#!/bin/bash
source /home/username/virtualenv/public_html/welcomebot/3.9/bin/activate
if ! pgrep -f "python3 welcome_bot.py" > /dev/null; then
    nohup python3 /home/username/public_html/welcomebot/welcome_bot.py >> /home/username/public_html/welcomebot/bot.log 2>&1 &
fi

• نکته: به جای username، نام کاربری cPanel خود را وارد کنید.

دادن دسترسی اجرایی:

chmod +x /home/username/public_html/welcomebot/check_bot.sh

۶. تست اسکریپت

قبل از ادامه، اسکریپت را دستی اجرا کنید:

/bin/bash /home/username/public_html/welcomebot/check_bot.sh

سپس فایل bot.log را بررسی کنید:

cat /home/username/public_html/welcomebot/bot.log

اگر خطایی دیدید (مثل ModuleNotFoundError)، مطمئن شوید کتابخانه‌ها درست نصب شده‌اند.

۷. تنظیم Cron Job

برای اجرای خودکار اسکریپت، یک Cron Job تنظیم می‌کنیم:

1. رفتن به Cron Jobs:
   • در cPanel، بخش Cron Jobs را پیدا کنید.
2. تنظیم زمان‌بندی:
   • Minute: */5 (هر ۵ دقیقه)
   • Hour, Day, Month, Weekday: * (همیشه)
3. دستور:

/bin/bash /home/username/public_html/welcomebot/check_bot.sh

1. روی Add New Cron Job کلیک کنید.
2. بررسی:
   • چند دقیقه صبر کنید، سپس bot.log را چک کنید.
   • به ربات تلگرامی خود پیام دهید و مطمئن شوید پیام خوش‌آمدگویی دریافت می‌شود.

۸. عیب‌یابی مشکلات

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

• فایل bot.log: خطاهایی مثل ModuleNotFoundError یا ConnectionError را چک کنید.
• فایل stderr.log:

cat /home/username/stderr.log

• دسترسی به API تلگرام: مطمئن شوید هاست شما پورت 443 را برای HTTPS باز کرده است.
• تماس با پشتیبانی هاست: اگر مشکل حل نشد، با تیم هاستینگ خود تماس بگیرید.

۹. بهینه‌سازی ربات (اختیاری)

برای حرفه‌ای‌تر شدن ربات:

• لاگ‌گیری بهتر:

import logging
logging.basicConfig(filename='bot.log', level=logging.INFO)
logging.info("Bot started")

• بررسی دسترسی شبکه: مطمئن شوید هاست شما به API تلگرام متصل است.

📌 پیشنهاد می‌کنیم در کنار این آموزش، به مستندات رسمی و کامل کتابخانه‌ی python-telegram-bot در گیت‌هاب نیز سر بزنید:
آموزش ساخت اولین ربات تلگرامی (Your First Bot)
در این راهنما، نحوه‌ی راه‌اندازی یک ربات ساده با زبان پایتون به همراه توضیحات کامل و مثال‌های عملی آموزش داده شده است.

نتیجه‌گیری

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