Come creare un bot Telegram con Claude Code o Codex (guida per principianti)

Non hai mai programmato un bot, ma vuoi automatizzare i messaggi su Telegram? Claude Code, Codex o altri assistenti di codifica con IA possono fare la maggior parte del lavoro tecnico al posto tuo, a patto di guidarli bene. In pochi passi, si passa da un’idea a un bot che funziona davvero. Ecco come procedere.

Crea il tuo bot su Telegram

Apri Telegram e parla con @BotFather, il bot ufficiale che crea bot. Digita /newbot, scegli un nome e un identificatore (che deve finire con “bot”). BotFather ti dà un token : una lunga stringa di caratteri che serve come chiave segreta per controllare il tuo bot. Conservalo con cura, non condividerlo mai pubblicamente — e se mai dovesse trapelare (pubblicato per errore su GitHub, per esempio), torna da BotFather per revocarlo e rigenerarne uno nuovo.

Apri il tuo assistente IA in una cartella di progetto

Crea una cartella vuota sul tuo computer, poi avvia l’assistente in un terminale in quella posizione. Lavora sempre nella cartella corrente: è lì che leggerà e scriverà i tuoi file.

Dagli un prompt iniziale preciso

Non serve un vocabolario tecnico, ma più la tua richiesta è precisa, migliore sarà il risultato. Ecco un prompt che puoi copiare e incollare così com’è (sostituendo i valori tra parentesi quadre):

Crea un bot Telegram in Python con la libreria python-telegram-bot.
Il bot deve inviare ogni mattina il meteo di [CITTÀ] alle [ORA].

Vincoli:
- Salva il token Telegram in un file .env, mai in chiaro nel codice.
- Crea un file .gitignore che escluda .env.
- Non inventare nessun valore segreto (token, chiave API): indicami chiaramente
  dove e come impostarli io stesso.
- Spiegami ogni passo prima di eseguirlo.
- Testa il bot prima di considerare il progetto concluso.

Per un messaggio inviato ogni giorno senza che tu debba scrivere al bot, devi anche conoscere il tuo chat ID (identificatore della tua conversazione con il bot). Chiedi semplicemente all’IA di spiegarti come recuperarlo — di solito inviando un primo messaggio al bot e poi leggendo la risposta dell’API di Telegram.

Proteggi il token fin dall’inizio

L’IA deve creare un file .env per memorizzare il token.

Lascia che l’IA esegua i comandi, con prudenza

L’IA può lanciare da sola i comandi di installazione (pip install, npm install, ecc.) e avviare il bot per testarlo. Ti chiederà l’autorizzazione prima di ogni azione importante. È normale, è una sicurezza. Quando un principiante non ha i riferimenti per giudicare “ciò che è logico”, basta una regola semplice: se un comando chiede la tua password, modifica file che non riconosci, o installa un software di cui non hai mai sentito parlare, chiedi prima all’IA di spiegarti cosa farà e perché, prima di accettare.

Testa il tuo bot

Una volta che il bot è avviato, apri Telegram e inviagli un messaggio. Se non risponde come previsto, descrivi semplicemente il problema all’IA (“il bot non risponde a /start” oppure “ho un errore XYZ”) : leggerà i messaggi di errore e correggerà il codice.

Aggiungi funzionalità poco alla volta

Una volta che la base funziona, arricchiscila bot progressivamente: risposte automatiche, promemoria programmati, integrazione con un’API esterna… Chiedi una funzionalità alla volta, testa, poi passa alla successiva. Se il tuo bot deve memorizzare utenti, le loro preferenze o dei promemoria, chiedi all’IA di prevedere un archivio persistente: un semplice file locale può bastare per un prototipo, ma non sopravvive sempre a un riavvio su un hosting, quindi diventa necessaria una piccola base di dati.

Ospita il tuo bot in modo continuo

Perché il bot funzioni anche quando il tuo computer è spento, devi ospitarlo su un server. Chiedi all’IA di spiegarti le opzioni attuali (piccolo server cloud, piattaforme come Railway o Fly.io, funzioni serverless come Cloudflare Workers) e di preparare il deployment. Verifica sempre le condizioni e le tariffe in vigore nel momento in cui leggi questo testo: le offerte gratuite di queste piattaforme cambiano regolarmente.

Ripara e mantieni il tuo bot

Un bot che funziona oggi può smettere di funzionare domani: dipendenza aggiornata, hosting che cambia le sue regole, token scaduto… Tieni traccia di ciò che l’IA ha messo in piedi (chiedile di documentare claude.md) per poterle ridare facilmente il contesto. In caso di guasto, copia e incolla semplicemente il messaggio di errore all’IA: spesso basta perché identifichi e corregga il problema.

Rispondere, programmare o diffondere: tre logiche diverse

Un bot Telegram può fare tre cose ben distinte: rispondere a un messaggio ricevuto, inviare un messaggio programmato a un’ora fissa, oppure diffondere una notifica a più utenti. Quest’ultimo caso è più impegnativo: bisogna gestire la lista delle persone che hanno avviato una conversazione con il bot, le loro preferenze, e rispettare i limiti di invio imposti da Telegram. Un bot non può scrivere spontaneamente a qualsiasi account Telegram; ogni utente deve prima aver avviato la conversazione.

Cosa è gratuito, cosa è a pagamento

Creare un bot con BotFather è gratuito, e l’API Bot Telegram generalmente non viene fatturata a chiamata, ma Telegram impone dei limiti di velocità, e alcune funzionalità possono avere le proprie condizioni. Dal lato dell’assistente IA, l’uso dipende dal tuo piano: un abbonamento tipo Claude Pro o Max o ChatGPT Pro include un utilizzo dello strumento.

Sul fronte hosting, diverse piattaforme (Cloudflare Workers, Railway, Fly.io…) offrono in genere un livello gratuito adatto a un piccolo bot personale a basso traffico. Ma queste offerte cambiano regolarmente e variano in base all’uso reale del tuo bot : verifica sempre le condizioni attuali prima di impegnarti. In sintesi: è del tutto possibile far girare un primo bot Telegram senza spendere un centesimo.

Qualche idea di bot Telegram

Monitoraggio prezzi & shopping

Avviso calo di prezzo: monitora un prodotto e ti avvisa non appena scende sotto una soglia stabilita.
Comparatore prezzi carburante: avvisa quando una stazione vicina scende sotto un certo prezzo al litro.
Monitoraggio disponibilità: avvisa non appena un articolo esaurito torna disponibile.

Finanza & mercati

Quotazioni azioni / crypto: invia il prezzo del Bitcoin, di un’azione o di un ETF, oppure avvisa in caso di forti variazioni.
Monitoraggio portafoglio: calcola ogni giorno il valore totale dei tuoi investimenti.
Tassi di cambio: avvisa quando una coppia di valute raggiunge una soglia interessante.

Meteo & ambiente

Meteo quotidiano per la tua città, inviato ogni mattina.
Avviso meteo in caso di temporale, pioggia intensa o gelo previsto.
Qualità dell’aria / pollini.

Produttività & vita personale

Bot personale per le attività: aggiungi, elimina e ricevi promemoria delle attività direttamente su Telegram.
Bot di monitoraggio RSS: controlla diversi siti e invia solo i nuovi articoli.
Bot di riepilogo: invia un articolo o un testo al bot e ricevi un riepilogo.
Bot di notifiche per il tuo sito: nuovo ordine, nuovo modulo, errore del server.
Bot di monitoraggio domotica: avvisa quando un dispositivo o un sensore cambia stato.
Bot di diario personale: salva rapidamente delle note e ritrovale tramite ricerca.
Monitoraggio pacchi: raccoglie lo stato delle tue consegne in un unico bot.

Da ricordare

Non hai bisogno di saper programmare per creare un bot Telegram funzionante. Il ruolo dell’IA è tradurre le tue idee in codice, eseguire i comandi tecnici e correggere gli errori. Il tuo ruolo, invece, è descrivere chiaramente cosa deve fare il bot, proteggere i tuoi accessi, fare domande, chiedere all’IA se ha domande e testare il risultato. È un vero lavoro di squadra tra la tua visione e l’esecuzione tecnica dell’IA.