Un bot in un'ora: ChatGPT scrive il codice

Ecco il prompt che svolge l'80% del lavoro di questo corso. Tutto ciò di cui hai bisogno è un qualsiasi accesso a ChatGPT — il livello gratuito è sufficiente. Prima il prompt completo, poi perché ogni riga merita il suo posto — e come accettare il lavoro senza leggere il codice.

Il master prompt per il codice del bot

Scrivi un bot Telegram in Python (libreria python-telegram-bot).
Cosa fa: risponde al comando /start con un saluto,
e ripete educatamente qualsiasi messaggio di testo.
Requisiti: leggi il token dalla variabile d'ambiente BOT_TOKEN,
tieni tutto in un unico file bot.py, commenta ogni blocco di codice
con parole semplici che spieghino cosa fa. Aggiungi esattamente una
funzionalità alla volta: solo questa per ora, la estenderemo più tardi.
Non sono un programmatore: concludi con istruzioni di avvio passo-passo.

Perché il prompt è costruito così

• «in Python (python-telegram-bot)» — il linguaggio e la libreria più popolari per i bot: ChatGPT ha visto migliaia di progetti simili, quindi gli errori di generazione sono minimi. La popolarità dello stack = la qualità del codice che otterrai.
• «token da una variabile d'ambiente» — una variabile d'ambiente è un'impostazione nominata che il programma riceve dal sistema all'avvio anziché dal proprio testo. In questo modo il token (ricordi la chiave di accensione della lezione precedente?) non finisce mai nel testo del codice. Un'abitudine da acquisire subito: nel modulo 24/7 vedrai quale disastro previene.
• «commenta con parole semplici» — il codice diventa leggibile: vedi cosa succede dove senza conoscere Python.
• «una funzionalità alla volta» — il codice semplice si controlla semplicemente. Vuoi dieci funzionalità? Ordinale una per una, ciascuna nel suo messaggio di follow-up.
• «Non sono un programmatore: istruzioni di avvio» — fa passare ChatGPT in modalità mentore paziente, senza scaricare gergo.

Perché proprio python-telegram-bot

Una libreria è un kit di parti pronte da cui sono costruiti i programmi: invece di «spiegare a Telegram lettera per lettera quello che voglio» ottieni comandi pronti come «rispondi» e «mostra pulsanti». python-telegram-bot è stata sviluppata per oltre dieci anni e si aggiorna con ogni nuova versione dell'API Bot: la 10.0 è completamente supportata, il supporto per i Messaggi Ricchi dalla 10.1 è in arrivo. Per te questo significa che la libreria è viva, e il codice che ChatGPT genera non si sgretolerà per vecchiaia in un mese.

Cosa torna indietro — e un'insidia

ChatGPT risponderà al master prompt in tre parti: il codice stesso (un blocco, il file bot.py), una breve spiegazione di cosa c'è dentro e istruzioni di avvio passo-passo. Salva il codice in un file bot.py sul tuo computer — lo eseguiremo nella prossima lezione.

Un'insidia da conoscere in anticipo: ChatGPT a volte produce con sicurezza codice in uno stile obsoleto — le librerie dei bot sono cambiate negli anni, e internet è pieno di vecchi esempi. Il segnale di avvertimento: il codice menziona la libreria telebot o qualcosa che non hai richiesto. Una risposta lo risolve: «Usa python-telegram-bot specificamente, una versione recente, sintassi della versione 21 o più nuova». Sono proprio questi esempi obsoleti che fanno marcire i corsi video sui bot entro un anno — un testo e un prompt sono facili da aggiornare, registrare di nuovo cento video no.

Accettazione: tre domande da cliente

Il codice è arrivato. Non devi leggerlo — ma devi accettare il lavoro. Un cliente professionale non si sofferma sui progetti; chiede «cosa si rompe se…». Chiedi a ChatGPT direttamente nella stessa conversazione:

1. «Cosa farà il bot se un utente invia una foto o una nota vocale invece di testo?» — un controllo dei limiti: un buon codice non si blocca di fronte all'inaspettato.
2. «Cosa succede se internet cade per un minuto?» — un controllo di resilienza: il programma dovrebbe sopravvivere a un intoppo, non morire per sempre.
3. «Questo codice invia dati altrove oltre a Telegram?» — un controllo di onestà: non devono esserci destinatari extra nel codice.

Se una risposta non ti soddisfa, chiedi subito: «correggi il codice in modo che…». Questo è il tuo ruolo: sei il cliente e l'ispettore. Tu specifichi, esegui, controlli, richiedi correzioni. Questo è vibe coding (l'approccio in cui l'IA scrive il codice e l'umano imposta i compiti e accetta il lavoro) — tranne che qui il prodotto è un bot.

Provalo nella sandbox: anatomia del codice

Vedi come è costruito il codice del bot prima ancora di installare Python. Il prompt è auto-contenuto:

Tu sei ChatGPT e ti sto commissionando un bot. Il mio ordine: «Scrivi
un bot Telegram in Python (libreria python-telegram-bot).
Risponde a /start con un saluto e ripete educatamente qualsiasi testo.
Token dalla variabile d'ambiente BOT_TOKEN, un file bot.py,
ogni blocco commentato con parole semplici. Non sono un programmatore:
concludi con istruzioni di avvio».
Genera il codice, poi sezionarlo come un insegnante: mostra quale riga
legge il token; cos'è un handler e quali handler sono qui;
dove il bot inizia a «ascoltare» Telegram; e cosa si rompe
se ogni blocco viene rimosso a turno.

Dopo quella spiegazione, la parola handler (un pezzo di codice responsabile di un tipo di messaggio: il comando /start, testo semplice, la pressione di un pulsante) smette di essere magia — e qualsiasi bot è costruito precisamente da handler.

Cosa c'è dopo

Hai il prompt e il rituale di accettazione. Nella prossima lezione eseguiremo il codice generato sul tuo computer — e il bot ti risponderà su Telegram per la prima volta.