Come ospitare un bot Telegram

Passo 1: crea il bot con BotFather

1. In Telegram, apri @BotFather e invia /newbot.
2. Dai al bot un nome visualizzato e poi uno username: da 5 a 32 caratteri, lettere latine, cifre e trattini bassi, che termini con bot, per esempio my_shop_helper_bot.
3. BotFather risponde con il token, che ha questo aspetto: 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11. Chi lo possiede controlla il tuo bot, quindi tienilo fuori dal codice e non condividerlo mai. Se trapela, invia /token a BotFather per ottenerne uno nuovo.

Altri due comandi di BotFather da conoscere: /setcommands aggiunge l'elenco dei comandi che gli utenti vedono digitando /, e /setprivacy controlla cosa vede il bot nei gruppi. La modalità privacy è attiva per impostazione predefinita, quindi in un gruppo il bot riceve solo i comandi rivolti a lui e le risposte ai suoi messaggi, a meno che tu non lo renda amministratore.

Polling o webhook?

Un bot riceve i messaggi da Telegram in uno di due modi, mai entrambi contemporaneamente:

Inizia con il polling. Non richiede dominio, certificato né porta aperta, e tutte le librerie lo supportano. Se sul token è mai stato impostato un webhook, chiama prima deleteWebhook: il polling non funziona finché un webhook è attivo.

Passo 2a: un bot in Python (python-telegram-bot)

python-telegram-bot 22 richiede Python 3.10 o successivo. Installalo con pip install python-telegram-bot e crea 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 è l'altra scelta popolare in Python, anch'essa con Python 3.10 o successivo.

Passo 2b: un bot in JavaScript (grammY)

grammY è il framework Telegram per Node.js mantenuto attivamente. Esegui npm install grammy e crea 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();

I tutorial più vecchi usano Telegraf, che non ha più rilasci da febbraio 2024; per un nuovo bot, grammY è la scelta più sicura.

Limiti e regole di Telegram per i bot

Limiti secondo le FAQ di Telegram sui bot:

• Circa un messaggio al secondo in una singola chat, 20 messaggi al minuto in un gruppo e circa 30 messaggi al secondo in totale.
• File: il bot può inviare fino a 50 MB e scaricare fino a 20 MB.
• Solo una copia del bot alla volta può fare polling. Una seconda riceve Conflict: terminated by other getUpdates request: usa un token separato per i test.

Regole: i termini di Telegram per gli sviluppatori di bot vietano lo spam, i messaggi non richiesti e l'aggiramento dei limiti di invio. Un bot deve avere un'informativa sulla privacy (se non ne scrivi una tua vale quella standard di Telegram) e deve cancellare i dati di un utente quando lo richiede. Automatizzare un account personale invece di un bot, il cosiddetto userbot, è tutt'altra cosa, e Telegram banna gli account usati per flood o spam.

Hosting di bot Telegram su HytHost

I nostri piani di bot hosting eseguono bot Telegram oltre ai bot Discord:

1. Scegli un piano e il runtime: Python per python-telegram-bot o aiogram, Node.js per grammY. Seleziona Python 3.10 o successivo, oppure un Node.js recente, nella scheda Startup.
2. Carica il tuo codice con il file manager o via SFTP, insieme a requirements.txt o package.json.
3. Metti il token in un file .env o in una variabile d'ambiente, non nel codice.
4. Avvialo. Con il polling il bot non ha bisogno di dominio né di porta aperta; il pannello lo riavvia se va in crash.

Cosa consentono le nostre regole: bot creati con la Bot API ufficiale e un token di BotFather. Non sono consentiti: userbot che automatizzano un account personale, messaggi di massa non richiesti, lo scraping di utenti o gruppi e bot che scaricano e ridistribuiscono contenuti multimediali senza averne i diritti. Un bot che viola queste regole viene sospeso.

I piani includono un database MySQL e i backup. Stai creando anche un bot Discord? Leggi come creare un bot Discord.