Come creare un bot su Telegram per automatizzare attività ripetitive?

Perché automatizzare con un bot Telegram

Gestire attività ripetitive su Telegram consuma tempo e attenzione; creare un bot permette di delegare promemoria, moderazione di gruppo, risposte automatiche e molto altro. Con le API ufficiali e librerie moderne, chiunque abbia una conoscenza base di programmazione può costruire un assistente su misura. In questo articolo vedremo come ottenere un token da BotFather, scrivere il codice essenziale, scegliere tra polling e webhook, e distribuire il bot in modo stabile.

Prerequisiti tecnici

Prima di iniziare, assicurati di avere un account Telegram attivo e un ambiente di sviluppo pronto. Non serve esperienza avanzata: sono sufficienti le basi di un linguaggio di scripting (Python, Node.js, PHP) e un editor di codice. Per il deploy ti serviranno un server o un servizio cloud sempre online; anche un Raspberry Pi può andare bene per i test. Se hai già dimestichezza con Git e terminale, il percorso sarà più agevole.

Ottenere il token dal BotFather

Il primo passo per creare un bot Telegram è interagire con @BotFather, il bot ufficiale per la gestione dei bot. Avvia una chat con BotFather e invia il comando /newbot. Segui le istruzioni: scegli un nome visualizzato (pubblico) e un username univoco che termini con 'bot' (es. MioPromemoriaBot). Al termine, BotFather ti restituirà un token di accesso, una stringa simile a 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11. Conservalo in un luogo sicuro e non condividerlo mai pubblicamente: chiunque possieda il token può controllare il bot.

Scegliere linguaggio e libreria

Telegram mette a disposizione API REST: puoi interagire via HTTP direttamente, ma le librerie ufficiali e della community semplificano il lavoro. Le scelte più comuni sono Python con python-telegram-bot (versione 20.x) oppure Node.js con node-telegram-bot-api. Entrambe offrono supporto per polling e webhook, gestiscono la serializzazione JSON e forniscono helper per inviare messaggi, foto e bottoni. Per questo tutorial useremo Python, perché richiede meno boilerplate per una struttura base.

Struttura di base del bot: polling

Il metodo più semplice per avviare un bot è il polling: il programma interroga periodicamente Telegram in cerca di nuovi aggiornamenti. È ideale per ambienti di test e bot a basso traffico. Crea un file bot.py e inserisci il seguente scheletro (usando python-telegram-bot 20.x):

from telegram.ext import Application, CommandHandler, MessageHandler, filters

TOKEN = 'IL_TUO_TOKEN'

async def start(update, context):
    await update.message.reply_text('Ciao! Sono un bot per automatizzare attività.')

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

if __name__ == '__main__':
    main()

Avvia lo script: il bot risponderà al comando /start con un messaggio di benvenuto. Puoi testarlo direttamente su Telegram cercando l'username del tuo bot.

Automazione di promemoria programmati

Uno degli usi più pratici per automatizzare attività ripetitive è l'invio di promemoria ricorrenti. Integra una libreria di scheduling come APScheduler per eseguire callback a intervalli fissi. Esempio: alle 9:00 di ogni giorno feriale, invia un messaggio a un gruppo con le attività pianificate. Il codice dev'essere eseguito in un loop asincrono, attento a non bloccare il polling. Ecco un frammento:

from apscheduler.schedulers.asyncio import AsyncIOScheduler
from datetime import time

async def remind(context):
    await context.bot.send_message(chat_id='-1001234567890', text='Buongiorno! Ricordati di aggiornare il report.')

scheduler = AsyncIOScheduler()
scheduler.add_job(remind, 'cron', day_of_week='mon-fri', hour=9, minute=0, kwargs={'context': context})
scheduler.start()

Attenzione: la variabile context dev'essere quella fornita dal framework. Assicurati di passarla correttamente o usa metodi alternativi. Con questa soluzione puoi automatizzare richiami settimanali, scadenze o controllo periodico di dati esterni.

Rispondere automaticamente a messaggi con parole chiave

Un'altra attività ripetitiva è rispondere a domande frequenti o attivare funzioni in base a pattern testuali. Utilizza un MessageHandler con filtro filters.TEXT e verifica nel corpo del messaggio con espressioni regolari. Esempio: se un utente scrive 'orari', il bot risponde con gli orari di apertura. Questo evita di digitare sempre la stessa risposta e può funzionare anche su gruppi.

import re

async def keyword_reply(update, context):
    text = update.message.text.lower()
    if re.search(r'\borari\b', text):
        await update.message.reply_text('Siamo aperti dalle 9:00 alle 18:00, dal lunedì al venerdì.')
    elif 'prezzo' in text:
        await update.message.reply_text('Il listino prezzi è disponibile su www.esempio.com/prezzi')

Importante: gestisci la priorità degli handler. I comandi esatti (es. /prezzi) dovrebbero essere catturati con CommandHandler prima del gestore testuale generico, per evitare conflitti.

Integrazione con API esterne

Un bot diventa potente quando può attingere a servizi esterni. Ad esempio, collegati a un'API meteo per fornire previsioni su richiesta, o a un database per registrare lead. Usa le librerie requests (Python) o axios (Node). Attenzione alla gestione degli errori: se l'API esterna è irraggiungibile, il bot deve rispondere con un messaggio amichevole e loggare l'errore. Ricorda di non esporre chiavi segrete nel codice: utilizza variabili d'ambiente.

Moderazione automatica in gruppi

Se gestisci gruppi con centinaia di utenti, alcune attività ripetitive possono essere gestite dal bot: rimuovere messaggi con link indesiderati, dare il benvenuto ai nuovi iscritti, o bannare utenti che inviano spam. Per filtrare, usa i permessi del bot (da configurare in @BotFather come admin del gruppo) e i filtri filters.StatusUpdate. Esempio di handler per nuovo membro:

from telegram.ext import ChatMemberHandler

async def welcome(update, context):
    for member in update.chat_member.new_chat_members:
        await update.effective_chat.send_message(f'Benvenuto, {member.first_name}! Leggi le regole in messaggio fissato.')

app.add_handler(ChatMemberHandler(welcome, ChatMemberHandler.CHAT_MEMBER))

Attenzione: il bot deve avere i permessi di inviare messaggi e vedere i membri. Rivedi le impostazioni di gruppo dopo averlo aggiunto.

Webhook vs polling: quando usare cosa

Per bot in produzione con volumi di messaggi elevati, il webhook è più efficiente: Telegram invia gli aggiornamenti direttamente al tuo server tramite una richiesta POST, senza polling periodico. Richiede un dominio HTTPS pubblico e una configurazione del server web. In cambio riduci latenza e traffico. Se usi un servizio cloud come Heroku o Railway, spesso forniscono un dominio HTTPS e facilitano l'implementazione. Valuta il compromesso: il polling è più semplice e funziona anche su hosting senza dominio, ma consuma più risorse per richieste frequenti.

Deploy e hosting del bot

Per mantenere il bot attivo 24/7, devi eseguirlo su un server. Opzioni comuni:

• VPS (DigitalOcean, Linode, o un server personale): massimo controllo, ma richiede manutenzione.
• Servizi serverless (AWS Lambda con API Gateway, Cloudflare Workers): ideali per webhook, ma gestisci tempi di esecuzione limitati.
• Piattaforme PaaS (Heroku, Railway, PythonAnywhere): deploy semplice tramite Git, alcune offrono SSL automatico.
• Raspberry Pi in locale: se hai un IP statico e configuri il port forwarding, puoi ospitare il bot a costo zero.

Indipendentemente dalla scelta, avvia il bot con un process manager (systemd, supervisor, pm2) per riavvii automatici in caso di crash. Non dimenticare di aggiornare il token e le variabili d'ambiente.

Gestione degli errori e logging

Le eccezioni sono inevitabili. Un bot robusto deve catturare errori di rete, API e input inattesi. In Python, avvolgi le chiamate API in blocchi try/except e logga con il modulo logging. Utilizza livelli diversi (INFO per eventi normali, ERROR per malfunzionamenti). Per bot con webhook, gestisci risposte HTTP non 200. Un buon logging ti permette di diagnosticare problemi senza dover monitorare costantemente la console.

Sicurezza: proteggere il token e validare input

Il token è la chiave del tuo bot: non commetterlo su repository pubblici; usa file .env o variabili d'ambiente del server. Se per sbaglio lo esponi, revocalo immediatamente con BotFather (/revoke). Per i webhook, assicurati che il segreto (webhook secret) sia condiviso solo tra Telegram e il tuo server. Inoltre, non fidarti mai dell'input utente: controlla che chat_id, username e text siano del tipo atteso per evitare SQL injection o crash.

Risoluzione dei problemi comuni

Il bot non risponde ai comandi: verifica che il token sia corretto, che lo script sia in esecuzione e che non ci siano errori in console. Se usi webhook, controlla che il certificato SSL sia valido e che il webhook sia registrato (curl -F "url=https://tuosito.com/telegram-webhook" https://api.telegram.org/bot<token>/setWebhook).

Rate limiting: Telegram limita il numero di messaggi per chat al secondo. Se invii molte notifiche contemporaneamente, potresti ricevere l'errore 429. Implementa una coda o un ritardo tra gli invii.

Bot disconnesso da BotFather: raramente il token può scadere; se sospetti, prova a rigenerarlo con /revoke e aggiorna il tuo codice.

Esempi di automazione avanzate

Oltre ai casi base, puoi integrare web scraping, interazione con database, controllo remoto di dispositivi IoT o notifiche da monitoraggio di server. La struttura rimane la stessa: ricevi un comando, esegui una logica, rispondi. Scegli attività che ripeti spesso: un bot non è magico, ma per compiti ripetitivi può risparmiare ore alla settimana.

FAQ

Devo saper programmare per creare un bot Telegram per automatizzare attività ripetitive?

Sì, è necessaria almeno una conoscenza base di un linguaggio di programmazione (Python, Node.js, PHP) e dimestichezza con il terminale. Tuttavia, chi non programma può utilizzare bot già pronti senza doverne creare uno proprio.

Qual è la differenza tra polling e webhook?

Con polling il bot interroga continuamente Telegram per nuovi messaggi; con webhook Telegram invia una richiesta HTTP a un URL pubblico quando ci sono aggiornamenti. Il webhook è più efficiente per bot in produzione, ma richiede un server con HTTPS.

Posso creare un bot Telegram senza un server sempre acceso?

Sì, utilizzando servizi serverless (AWS Lambda, Cloudflare Workers) con webhook. Tuttavia, il bot sarà offline se il provider ha limiti di esecuzione. Per attività critiche è meglio un server 24/7.

Come faccio a rendere il bot admin di un gruppo?

Aggiungi il bot al gruppo, poi tramite le impostazioni del gruppo (Info gruppo > Amministratori) promuovilo ad admin. Alcune azioni (cancellare messaggi, bannare) richiedono permessi espliciti.

Quanto costa mantenere un bot Telegram attivo?

L'uso delle API Telegram è gratuito. I costi dipendono dall'hosting: da €0 se usi un Raspberry Pi a casa, a circa €5–€10 al mese per un VPS di base. I servizi serverless hanno costi variabili in base alle richieste.

Considerazioni finali

Creare un bot Telegram per automatizzare attività ripetitive è un investimento iniziale che paga in efficienza. Inizia con un piccolo progetto (un promemoria, una risposta automatica) e amplia gradualmente. Ricorda di documentare il codice, mantenere il bot aggiornato e monitorare i log. Con l'ecosistema di librerie e servizi moderni, oggi è più accessibile che mai. Se incontri difficoltà, la community di sviluppatori Telegram è attiva e fornisce supporto su gruppi dedicati.