ACLClouds
ACLClouds

Tutorial: creare un bot Telegram e ospitarlo gratis

Creare un bot Telegram con BotFather, scrivere il codice minimo in Python o in Node.js, poi ospitarlo gratis 24/7: ogni passaggio, con gli errori più

Per ospitare un bot Telegram gratis servono tre cose: un token fornito da BotFather, una decina di righe di codice in Python o in Node.js e una macchina che resti accesa al posto tuo. Questo tutorial segue questi tre passaggi in ordine, fino alla prima risposta del bot al comando /start. Usa il polling: il bot non ha bisogno né di un indirizzo pubblico né di un certificato HTTPS.

  • BotFather crea il bot e fornisce il suo token con il comando /newbot.
  • Il codice legge il token dalla variabile d'ambiente TELEGRAM_TOKEN, mai scritto direttamente in un file.
  • In polling, il bot non ha bisogno né di un indirizzo pubblico né di un certificato HTTPS.
  • Il piano Free di ACLClouds fa girare 1 bot Node.js o Python con 315 MB di RAM, senza carta di credito.
  • Un errore 409 Conflict significa che due copie del bot girano con lo stesso token.

Creare il bot con BotFather

In Telegram, apri una conversazione con @BotFather, l'account ufficiale che gestisce i bot, e invia /newbot. Chiede un nome da mostrare, poi un nome utente che deve terminare con bot, per esempio mon_premier_bot. Risponde con il token, una sequenza di cifre e lettere separate da due punti.

  • Il token dà il controllo completo del bot: non metterlo né nel codice né in uno screenshot.
  • Se è trapelato, invia /revoke a BotFather: il vecchio token smette di funzionare e ne viene creato uno nuovo.
  • In un gruppo, un bot riceve per impostazione predefinita solo i comandi. Per leggere tutti i messaggi, disattiva la modalità privacy con /setprivacy.

Il codice minimo in Python

La libreria più usata è python-telegram-bot. Crea un file requirements.txt che contiene la riga python-telegram-bot, poi un file bot.py. Il programma legge il token dalla variabile d'ambiente TELEGRAM_TOKEN, dichiara un comando /start e avvia la ricezione dei messaggi.

  • Crea l'applicazione: Application.builder().token(os.environ["TELEGRAM_TOKEN"]).build().
  • Scrivi una funzione asincrona start(update, context) che risponde con await update.message.reply_text("Ciao").
  • Collegala al comando con add_handler(CommandHandler("start", start)), poi termina con run_polling().
  • Il pacchetto da installare si chiama python-telegram-bot, mentre l'import si scrive from telegram.ext import Application, CommandHandler.

Lo stesso bot in Node.js

In Node.js, Telegraf e grammY fanno lo stesso lavoro. Con Telegraf, il package.json contiene la dipendenza telegraf e uno script start che esegue node index.js. Il file index.js sta in quattro righe.

  • Carica la libreria: const { Telegraf } = require("telegraf").
  • Crea il bot con il token letto dall'ambiente: const bot = new Telegraf(process.env.TELEGRAM_TOKEN).
  • Rispondi a /start con bot.start((ctx) => ctx.reply("Ciao")), poi esegui bot.launch().

Ospitare il bot gratis

Il piano Free dell'hosting di bot di ACLClouds fa girare un programma Node.js o Python in modo continuo, senza carta di credito. È presentato per Discord, ma un bot Telegram in polling funziona allo stesso modo: è un programma che apre una connessione in uscita. Al momento dell'ordine, scegli Python o Node.js, poi sostituisci il progetto di esempio con i tuoi file dalla scheda File o via SFTP sulla porta 2222.

  • Nella scheda Avvio, aggiungi una variabile d'ambiente chiamata TELEGRAM_TOKEN con il token di BotFather. Il campo «Token del bot Discord» resta vuoto.
  • Non caricare node_modules né .venv: le dipendenze vengono installate sul server a partire da requirements.txt o da package.json.
  • Per caricare i file con FileZilla, segui la guida caricare un bot via SFTP.

Avviare e provare

Avvia il bot dalla console, poi apri la conversazione con il tuo bot in Telegram e invia /start. La risposta arriva in uno o due secondi. Se non arriva niente, la console mostra la causa: leggi la prima riga di errore.

  • 401 Unauthorized: il token è sbagliato o è stato revocato. Copialo di nuovo da BotFather.
  • 409 Conflict: un'altra copia del bot gira già con lo stesso token, spesso sul tuo computer. Fermala. Se in passato è stato impostato un webhook, eliminalo con il metodo deleteWebhook.
  • No module named telegram: manca la riga python-telegram-bot in requirements.txt. Vedi la guida ModuleNotFoundError.
  • Nessun messaggio ricevuto in un gruppo: la modalità privacy è attiva, arrivano solo i comandi.

Cosa permette il piano Free

Un bot Telegram di comandi consuma poco: il piano Free gli basta nella maggior parte dei casi. I suoi limiti sono pubblici, e la contropartita della gratuità è un rinnovo da fare a mano.

  • 1 bot per account, 315 MB di RAM, 0,25 vCPU e 715 MB di spazio.
  • Rinnovo gratuito ogni 4 giorni dalla pagina del bot. Senza rinnovo, il bot viene sospeso.
  • Il bot non va in sospensione tra due messaggi, e si riavvia da solo dopo un arresto imprevisto.
  • Polling o webhook, frequenza degli invii e memoria: la guida bot Telegram 24/7 spiega queste scelte.

Domande frequenti

Un bot Telegram può girare su un piano pensato per Discord?

Sì. Il piano esegue un programma Node.js o Python: un bot Telegram in polling si avvia come un bot Discord. Cambia solo il nome della variabile del token.

Serve un nome di dominio o un certificato HTTPS?

No, non in polling: è il bot a interrogare Telegram. Un webhook, invece, richiede un indirizzo HTTPS raggiungibile da Internet.

Il bot risponde quando il mio computer è spento?

Sì. Gira sull'infrastruttura ACLClouds. Basta rinnovare gratis il piano Free ogni 4 giorni dalla pagina del bot.

Quale libreria scegliere per iniziare?

python-telegram-bot in Python, Telegraf o grammY in Node.js. Tutte e tre sono documentate e bastano per un bot di comandi. Scegli il linguaggio che conosci già.