Come creare un bot su Telegram per automatizzare l'invio di messaggi?

Introduzione

Creare un bot Telegram per automatizzare l'invio di messaggi è una delle soluzioni più versatili per notifiche, promemoria e comunicazioni programmate. Tuttavia, in un contesto in cui la conformità normativa e la protezione dei dati sono priorità assolute, è fondamentale progettare il bot tenendo conto di auditabilità, consenso e minimizzazione dei dati. Questa guida ti accompagna dalla creazione del bot tramite BotFather fino alla gestione della sicurezza e della privacy, con un approccio pratico e verificabile. Prima di addentrarci nel codice, esaminiamo cosa ti servirà per iniziare.

Prerequisiti

Prima di iniziare, assicurati di avere un account Telegram attivo su smartphone o desktop. Non è richiesta alcuna conoscenza preliminare di programmazione, ma per automatizzare l'invio di messaggi sarà necessario scrivere codice in un linguaggio come Python, JavaScript o Go. In questa guida utilizzeremo Python e la libreria ufficiale python-telegram-bot (versione stabile più recente al momento della stesura).

Avrai bisogno anche di un server o di un ambiente cloud (es. Raspberry Pi, VPS, AWS Lambda) per eseguire il bot in modo continuativo. Per la fase di test, il tuo computer locale è sufficiente, ma tieni presente che il bot dovrà restare acceso per funzionare 24/7 in produzione.

Creazione del bot tramite BotFather

BotFather è il bot ufficiale di Telegram che permette di creare e gestire altri bot. Apri Telegram e cerca @BotFather, quindi avvia una chat. Invia il comando /newbot e segui le istruzioni: scegli un nome visualizzato (es. NotificheAziendaliBot) e uno username univoco che termina con bot (es. NotificheAziendaliBot). Al termine, BotFather ti fornirà un token API, una stringa di circa 40 caratteri. Conservala al sicuro: chiunque possieda il token può controllare il bot.

Subito dopo, puoi personalizzare il bot inviando /setdescription e /setabouttext per descrivere le funzionalità, utili anche per la trasparenza verso gli utenti. Per automatizzare l'invio di messaggi, non serve configurare il comando /setcommands a meno che non si voglia un'interfaccia interattiva. Esempio: se il bot deve solo inviare notifiche, puoi saltare questo passaggio; se invece prevedi comandi come /promemoria, allora impostali per chiarezza.

Configurazione dell'ambiente di sviluppo

Una volta ottenuto il token, installa Python 3.8 o superiore. Crea una directory per il progetto e imposta un ambiente virtuale. Installa la libreria con il comando pip install python-telegram-bot. Verifica l'installazione avviando l'interprete Python e importando from telegram import Bot.

Per motivi di sicurezza, non includere mai il token direttamente nel codice. Utilizza variabili d'ambiente o un file di configurazione esterno (es. .env) letto tramite python-dotenv. In questo modo, se il codice viene condiviso accidentalmente, il token rimane protetto. Ad esempio, crea un file .env con BOT_TOKEN=il_tuo_token e caricalo all'avvio dello script.

Scrittura del codice di base

Ecco un esempio minimale per avviare il bot e fargli rispondere al comando /start. Questo codice costituisce la base per qualsiasi automazione successiva.

from telegram import Update
from telegram.ext import Application, CommandHandler, ContextTypes

TOKEN = "IL_TUO_TOKEN"

async def start(update: Update, context: ContextTypes.DEFAULT_TYPE):
    await update.message.reply_text("Ciao! Sono un bot per invio automatico.")

def main():
    app = Application.builder().token(TOKEN).build()
    app.add_handler(CommandHandler("start", start))
    app.run_polling()

if __name__ == "__main__":
    main()

Avvia lo script con python bot.py. Apri Telegram, cerca il tuo bot e invia /start. Dovresti ricevere la risposta. Questo conferma che il bot è attivo e in ascolto. Se non ricevi risposta, controlla che il token sia corretto e che non ci siano errori nel codice.

Invio di messaggi automatici

L'automazione dell'invio di messaggi richiede due elementi: l'identificativo del destinatario (chat_id) e la logica di invio. Puoi ottenere il chat_id inviando un messaggio al bot e registrando l'update. In fase di sviluppo, puoi stampare update.effective_chat.id all'interno del gestore /start.

Una volta noto il chat_id, puoi inviare messaggi in modo asincrono usando il metodo await context.bot.send_message(chat_id=CHAT_ID, text="Messaggio automatico"). Questo può essere chiamato da qualsiasi funzione, anche al di fuori dei gestori, purché tu abbia accesso all'oggetto context.bot.

Per messaggi programmati, utilizza un loop all'interno del main() o integrato con un task scheduler esterno. Attenzione: se il bot viene eseguito in polling, non deve bloccarsi; utilizza asyncio.create_task per eseguire invii periodici. Esempio: se vuoi inviare un messaggio ogni ora, crea una funzione asincrona e avviala come task.

Automazione con task scheduler

Per inviare messaggi a orari fissi (es. ogni giorno alle 9:00), hai due strade principali. La prima è integrare una libreria di scheduling nel codice, come apscheduler. La seconda è utilizzare cron (su Linux) o Task Scheduler (su Windows) per eseguire uno script Python separato all'ora desiderata.

L'approccio con cron è più semplice e garantisce che il bot non resti in esecuzione continua, riducendo il consumo di risorse. Tuttavia, se il bot deve anche rispondere a comandi, conviene usare lo scheduling interno. In entrambi i casi, assicurati di gestire l'autenticazione del token in modo sicuro e di non inviare messaggi a utenti che non hanno interagito con il bot, poiché Telegram blocca i messaggi non richiesti. Esempio: con cron, imposta uno script che esegue python send_daily.py e gestisci il token tramite variabile d'ambiente.

Considerazioni sulla conformità e dati

Quando automatizzi l'invio di messaggi, devi rispettare le leggi sulla privacy come il GDPR. Ogni utente deve essere informato chiaramente su quali dati vengono raccolti e per quale scopo. Il bot dovrebbe registrare solo il chat_id e il timestamp dell'ultima interazione, evitando di memorizzare contenuti delle chat o informazioni personali non necessarie.

Implementa un comando /cancella che permetta all'utente di cancellare i propri dati dal tuo database. Per la conservazione, stabilisci un periodo di retention massimo (es. 30 giorni) e predisponi un processo di pulizia automatico. La documentazione di Telegram non offre API per cancellare messaggi inviati, ma è possibile implementare una logica lato server per eliminare i record. Esempio: se un utente invia /cancella, rimuovi il suo chat_id dal database e conferma l'operazione.

Gestione degli errori e limiti di velocità

Telegram impone limiti di velocità (rate limits) per evitare abusi. Se invii messaggi troppo rapidamente, il bot riceverà un errore 429 e dovrà attendere prima di ritentare. La libreria python-telegram-bot gestisce automaticamente i rate limit con retry, ma è opportuno prevedere un backoff esponenziale per invii massivi.

Un errore comune è dimenticare di gestire l'eccezione telegram.error.Forbidden quando un utente blocca il bot. In tal caso, il bot non può più inviare messaggi a quell'utente; è consigliabile rimuovere il chat_id dal database per evitare tentativi futuri. Esempio: avvolgi la chiamata a send_message in un try/except e, se solleva Forbidden, cancella il record corrispondente.

Best practice di sicurezza

Proteggi il token API: non esporlo in repository pubblici, usa variabili d'ambiente o servizi di secret management. Se sospetti una compromissione, rigenera immediatamente il token da BotFather con il comando /revoke.

Se utilizzi webhook (consigliato per bot in produzione), assicurati che l'endpoint sia HTTPS e che il certificato sia valido. Puoi impostare il webhook con l'API setWebhook. Per il polling, limita l'accesso all'IP del server se possibile.

Infine, valuta l'uso di un bot token per ogni bot e non riutilizzare token tra ambienti di sviluppo e produzione. La separazione riduce il rischio di incidenti. Esempio: tieni due file .env, uno per sviluppo e uno per produzione, con token diversi.

Casi d'uso pratici

Un esempio concreto: un'azienda utilizza un bot per inviare promemoria di scadenze ai dipendenti. Ogni notte, un cron job esegue uno script che legge un file CSV con i dati e invia messaggi personalizzati. Per rispettare la privacy, il CSV non contiene numeri di telefono ma solo chat_id, e i dati vengono cancellati dopo 30 giorni.

Un altro scenario è l'invio di notifiche di monitoraggio server. Il bot, integrato con un sistema di alert, invia messaggi a un canale o a un gruppo quando si verifica un evento critico. In questo caso, il bot non deve interagire con singoli utenti, ma può essere aggiunto a un gruppo come amministratore. È importante non inviare messaggi a utenti che non hanno interagito preventivamente, pena il blocco da parte di Telegram.

Limitazioni e alternative

Il bot Telegram non può inviare messaggi a un utente finché questi non ha avviato una conversazione (inviato almeno un comando) o non è stato aggiunto a un gruppo. Questa limitazione è voluta per prevenire spam. Per messaggi broadcast, valuta l'uso di canali: i bot possono pubblicare messaggi in canali di cui sono amministratori, e gli iscritti ricevono le notifiche in modo passivo, senza bisogno di interazione.

Inoltre, i bot non possono accedere alla rubrica telefonica dell'utente né inviare messaggi a numeri sconosciuti. Per comunicazioni one-to-one su larga scala, è necessario chiedere agli utenti di avviare il bot, ad esempio tramite un link https://t.me/TuoBot?start=parametro. Queste limitazioni, sebbene stringenti, garantiscono un ecosistema più sicuro e rispettoso della privacy.

Domande frequenti (FAQ)

Posso inviare messaggi a un utente che non ha mai interagito con il bot?

No, Telegram non lo permette. L'utente deve aver avviato il bot almeno una volta. Puoi incoraggiare l'iscrizione tramite link di invito o bottoni di terze parti, ma non puoi forzare l'invio.

È sicuro lasciare il token nel codice sorgente?

No. Il token deve essere trattato come una password. Usa variabili d'ambiente o servizi di secret management. Non committare mai il token in repository pubblici.

Quanti messaggi posso inviare al minuto?

I limiti non sono documentati ufficialmente, ma in pratica si aggirano intorno a 30 messaggi al secondo per chat. Per invii massivi, distribuisci i messaggi su più chat o utilizza un canale.

Il bot può inviare messaggi in un gruppo?

Sì, se il bot è membro del gruppo e ha i permessi necessari. Può inviare messaggi usando l'ID del gruppo come chat_id. Assicurati che il bot non sia limitato dai permessi del gruppo.

Come posso verificare che il bot funzioni correttamente?

Puoi inviare un messaggio di test manuale o utilizzare un servizio di monitoring come UptimeRobot. Inoltre, abilita il logging nel codice per tracciare errori e invii riusciti.

Conclusione

Creare un bot Telegram per l'automazione dell'invio di messaggi è un processo accessibile, ma richiede attenzione alla sicurezza e alla conformità normativa. Seguendo i passaggi illustrati, potrai realizzare un sistema affidabile, rispettoso della privacy e facilmente estendibile. Ricorda di testare sempre in ambiente di sviluppo prima di passare in produzione, e di mantenere il codice aggiornato con le ultime versioni delle librerie.

Per approfondire, consulta la documentazione ufficiale di Telegram Bot API e il repository di python-telegram-bot. Buon sviluppo! Con una solida base, potrai adattare il bot a qualsiasi esigenza, dalle notifiche aziendali ai promemoria personali.