איך לארח בוט Telegram

שלב 1: יוצרים את הבוט עם BotFather

1. ב-Telegram, פתחו את @BotFather ושלחו /newbot.
2. תנו לבוט שם תצוגה, ואחר כך שם משתמש: 5 עד 32 תווים, אותיות לטיניות, ספרות וקווים תחתונים, שמסתיים ב-bot — למשל my_shop_helper_bot.
3. BotFather משיב עם הטוקן, שנראה כך: 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11. מי שמחזיק בו שולט בבוט שלכם, אז השאירו אותו מחוץ לקוד ולעולם אל תשתפו אותו. אם הוא דלף, שלחו /token ל-BotFather כדי לקבל טוקן חדש.

עוד שתי פקודות של BotFather שכדאי להכיר: /setcommands מוסיפה את רשימת הפקודות שמשתמשים רואים כשהם מקלידים /, ו-/setprivacy קובעת מה הבוט רואה בקבוצות. כברירת מחדל מצב הפרטיות פעיל, כך שבקבוצה הבוט מקבל רק פקודות שמיועדות לו ותגובות להודעות שלו — אלא אם תהפכו אותו למנהל.

Polling או webhooks?

בוט מקבל את ההודעות שלו מ-Telegram באחת משתי דרכים — אף פעם לא בשתיהן בו-זמנית:

התחילו עם polling. הוא לא דורש דומיין, תעודה או פורט פתוח, וכל ספרייה תומכת בו. אם אי פעם הוגדר webhook על הטוקן, קראו קודם ל-deleteWebhook — polling לא עובד כל עוד webhook פעיל.

שלב 2א: בוט ב-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 ומעלה.

שלב 2ב: בוט ב-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:

• בערך הודעה אחת בשנייה בצ'אט בודד, 20 הודעות בדקה בקבוצה, ובערך 30 הודעות בשנייה בסך הכול.
• קבצים: הבוט יכול לשלוח עד 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. בחרו Python 3.10 ומעלה, או גרסה עדכנית של Node.js, בלשונית Startup.
2. העלו את הקוד דרך מנהל הקבצים או SFTP, יחד עם requirements.txt או package.json.
3. שימו את הטוקן בקובץ .env או במשתנה סביבה, לא בקוד.
4. הפעילו אותו. עם polling הבוט לא צריך דומיין או פורט פתוח; הפאנל מפעיל אותו מחדש אם הוא קורס.

מה הכללים שלנו מתירים: בוטים שבנויים על ה-Bot API הרשמי עם טוקן מ-BotFather. אסור: userbots שמבצעים אוטומציה לחשבון אישי, הודעות המוניות שלא התבקשו, איסוף נתונים (scraping) של משתמשים או קבוצות, ובוטים שמורידים ומעבירים הלאה מדיה בלי הזכויות עליה. בוט שמפר את הכללים האלה מושעה.

החבילות כוללות מסד נתונים MySQL וגיבויים. בונים גם בוט Discord? ראו איך ליצור בוט Discord.