چگونه ربات Telegram را میزبانی کنیم

مرحله ۱: ربات را با BotFather بسازید

1. در Telegram، @BotFather را باز کنید و /newbot را بفرستید.
2. یک نام نمایشی برای ربات انتخاب کنید و سپس یک نام کاربری: ۵ تا ۳۲ نویسه شامل حروف لاتین، ارقام و زیرخط، که به bot ختم شود — برای نمونه my_shop_helper_bot.
3. BotFather با توکن پاسخ می‌دهد که شبیه 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11 است. هر کسی آن را داشته باشد ربات شما را کنترل می‌کند، پس آن را بیرون از کد نگه دارید و هرگز با کسی به اشتراک نگذارید. اگر لو رفت، /token را به BotFather بفرستید تا توکن جدیدی بگیرید.

دو فرمان دیگر BotFather که دانستنشان مفید است: /setcommands فهرست فرمان‌هایی را اضافه می‌کند که کاربران هنگام تایپ / می‌بینند، و /setprivacy تعیین می‌کند ربات در گروه‌ها چه چیزی را ببیند. حالت حریم خصوصی به‌طور پیش‌فرض روشن است، پس ربات در گروه فقط فرمان‌هایی را که برای آن است و پاسخ به پیام‌های خودش را دریافت می‌کند — مگر اینکه آن را مدیر کنید.

Polling یا webhook؟

ربات پیام‌هایش را از Telegram به یکی از دو روش دریافت می‌کند — هرگز هر دو به‌طور هم‌زمان:

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

مرحله ۲الف: ربات در Python (python-telegram-bot)

python-telegram-bot 22 به Python 3.10 یا جدیدتر نیاز دارد. آن را با pip install python-telegram-bot نصب کنید و bot.py را بسازید:

import os
from telegram import Update
from telegram.ext import Application, CommandHandler, ContextTypes, MessageHandler, filters

async def start(update: Update, context: ContextTypes.DEFAULT_TYPE) -> None:
    await update.message.reply_text("Hi! Send me a message and I will echo it.")

async def echo(update: Update, context: ContextTypes.DEFAULT_TYPE) -> None:
    await update.message.reply_text(update.message.text)

def main() -> None:
    application = Application.builder().token(os.environ["TELEGRAM_TOKEN"]).build()
    application.add_handler(CommandHandler("start", start))
    application.add_handler(MessageHandler(filters.TEXT & ~filters.COMMAND, echo))
    application.run_polling(allowed_updates=Update.ALL_TYPES)

if __name__ == "__main__":
    main()

aiogram 3 گزینه محبوب دیگر در Python است و آن هم به Python 3.10 یا جدیدتر نیاز دارد.

مرحله ۲ب: ربات در JavaScript (grammY)

grammY فریم‌ورک Telegram برای Node.js است که به‌طور فعال نگهداری می‌شود. npm install grammy را اجرا کنید و bot.js را بسازید:

const { Bot } = require("grammy");

const bot = new Bot(process.env.TELEGRAM_TOKEN);
bot.command("start", (ctx) => ctx.reply("Welcome! Up and running."));
bot.on("message:text", (ctx) => ctx.reply(ctx.message.text));

process.once("SIGINT", () => bot.stop());
process.once("SIGTERM", () => bot.stop());
bot.start();

آموزش‌های قدیمی‌تر از Telegraf استفاده می‌کنند که از فوریه 2024 نسخه جدیدی منتشر نکرده است؛ برای ربات جدید، grammY انتخاب مطمئن‌تری است.

محدودیت‌ها و قوانین Telegram برای ربات‌ها

محدودیت‌ها طبق پرسش‌های متداول ربات‌های Telegram:

• حدود یک پیام در ثانیه در یک گفتگو، ۲۰ پیام در دقیقه در یک گروه و در مجموع حدود ۳۰ پیام در ثانیه.
• فایل‌ها: ربات می‌تواند تا 50 MB ارسال و تا 20 MB دانلود کند.
• در هر لحظه فقط یک نسخه از ربات می‌تواند polling کند. نسخه دوم خطای Conflict: terminated by other getUpdates request می‌گیرد — برای آزمایش از توکن جداگانه استفاده کنید.

قوانین: شرایط Telegram برای توسعه‌دهندگان ربات، اسپم، پیام‌های ناخواسته و دور زدن محدودیت نرخ را ممنوع می‌کند. ربات به سیاست حریم خصوصی نیاز دارد (اگر سیاست خودتان را ننویسید، سیاست استاندارد Telegram اعمال می‌شود) و باید داده‌های کاربر را در صورت درخواست او حذف کند. خودکارسازی یک حساب شخصی به‌جای ربات — به اصطلاح userbot — موضوعی کاملا متفاوت است و Telegram حساب‌هایی را که برای فلود یا اسپم استفاده می‌شوند مسدود می‌کند.

میزبانی ربات Telegram در HytHost

پلن‌های میزبانی ربات ما ربات‌های Telegram را هم مانند ربات‌های Discord اجرا می‌کنند:

1. یک پلن و محیط اجرا انتخاب کنید — Python برای python-telegram-bot یا aiogram، و Node.js برای grammY. در زبانه Startup نسخه Python 3.10 یا جدیدتر، یا نسخه فعلی Node.js را انتخاب کنید.
2. کد خود را آپلود کنید با مدیر فایل یا SFTP، همراه با requirements.txt یا package.json.
3. توکن را در فایل .env بگذارید یا در یک متغیر محیطی، نه در کد.
4. آن را اجرا کنید. با polling ربات به دامنه یا پورت باز نیازی ندارد؛ اگر از کار بیفتد، پنل آن را دوباره راه‌اندازی می‌کند.

آنچه قوانین ما مجاز می‌داند: ربات‌هایی که بر پایه Bot API رسمی و با توکن BotFather ساخته شده‌اند. مجاز نیست: userbotهایی که یک حساب شخصی را خودکار می‌کنند، پیام‌های انبوه ناخواسته، جمع‌آوری (scraping) اطلاعات کاربران یا گروه‌ها، و ربات‌هایی که رسانه را بدون داشتن حقوق آن دانلود و بازنشر می‌کنند. رباتی که این قوانین را نقض کند تعلیق می‌شود.

پلن‌ها شامل یک پایگاه داده MySQL و پشتیبان‌گیری هستند. ربات Discord هم می‌سازید؟ چگونه ربات Discord بسازیم را ببینید.