Come Costruire un Agente AI su Telegram (Guida 2026)

Vuoi un agente AI che vive su Telegram. Non una scheda del browser, non l'ennesima app mobile, ma un contatto nella tua barra laterale che risponde quando gli scrivi, ricorda quello che hai detto la settimana scorsa e sa fare cose concrete, non solo chiacchierare.

La buona notizia è che Telegram è la piattaforma di messaggistica più comoda per costruire qualcosa del genere. La Bot API è gratuita, si apre in due minuti con BotFather e non prevede costi per messaggio, a differenza di WhatsApp Business, che addebita ogni conversazione e richiede la verifica da parte di Meta. La notizia meno semplice è che "come costruire un agente AI su Telegram" si divide in almeno quattro percorsi diversi nel 2026, e quello giusto dipende da se sei uno sviluppatore a cui piace collegare stack o una persona non tecnica che vuole l'agente operativo entro stasera.

Questa guida ti accompagna attraverso quello che ti serve davvero, i quattro percorsi concreti e un decision tree onesto alla fine.

Cosa Significa Davvero "Un Agente AI su Telegram"

Prima di scegliere uno stack, conviene essere precisi su cosa stai costruendo. L'espressione copre uno spettro ampio:

Un semplice wrapper chat. Il bot inoltra i tuoi messaggi a un LLM e restituisce la risposta. Utile, ma dimentica tutto quando la chat scorre.
Un chatbot con memoria. Stesso flusso, ma con una memoria di sessione o un vector store per richiamare i messaggi precedenti.
Un agente. Un processo a lungo termine con una personalità, strumenti che può chiamare (ricerca web, calendario, email, le tue API), memoria persistente tra le sessioni e la capacità di svolgere lavori in più passaggi in autonomia.

La maggior parte dei tutorial "costruisci un bot Telegram" che si trovano online si ferma al wrapper chat. Va bene se vuoi solo chattare. Se vuoi che l'agente ricordi un progetto che hai descritto mercoledì scorso o che esegua un briefing mattutino giornaliero su un'agenda pianificata, ti servono memoria persistente e uno scheduler: sono le funzionalità che trasformano un bot in un agente.

Le dimensioni che fanno la differenza quando scegli uno stack:

Memoria tra sessioni - l'agente ti ricorda la settimana prossima, o ogni nuova chat riparte da zero?
Strumenti e skill - sa fare cose concrete (inviare email, cercare sul web, riassumere un PDF, chiamare la tua API) o si limita a chiacchierare?
BYOK - puoi puntarlo sulla tua chiave OpenAI, Anthropic o OpenRouter, o sei vincolato ai crediti del fornitore?
Hosting - SaaS hosted, cloud no-code, server self-hosted o runtime completamente gestito?
Allowlist - puoi limitare il bot al tuo user ID Telegram, o chiunque lo trovi può bruciare i tuoi crediti API?

La memoria è il fattore differenziante che conta di più. Un chatbot risponde alle domande; un agente personale le ricorda.

Passo Zero: Crea il Bot con BotFather

Tutti i percorsi qui sotto iniziano con lo stesso step da cinque minuti, quindi fallo subito.

Apri Telegram, cerca @BotFather e invia /newbot. BotFather ti chiederà due cose nell'ordine:

Un nome visualizzato (può contenere spazi, modificabile in seguito).
Un username, che deve terminare in bot ed è permanente.

Quando entrambi vengono accettati, BotFather risponde con un token API che assomiglia a 123456789:ABCdef.... Trattalo come una password: chiunque abbia questo token può inviare messaggi a nome del tuo bot. Salvalo in un gestore di password o in un file .env che non committi.

Alcuni comandi BotFather utili da conoscere fin dal primo giorno:

/setdescription - la breve introduzione che gli utenti vedono quando aprono la chat per la prima volta.
/setcommands - il menu di autocomplete dei comandi slash.
/setprivacy - nei gruppi, imposta su "Disable" se vuoi che il bot veda tutti i messaggi, non solo quelli che lo menzionano.

Due note finali che sorprendono i principianti. Prima: la Telegram Bot API è genuinamente gratuita, senza costi per messaggio, anche a scala. Seconda: per impostazione predefinita un bot su Telegram avvia la conversazione solo dopo che l'utente ha inviato il primo messaggio, quindi durante lo sviluppo scriviti tu stesso al bot prima di aspettarti una risposta.

Percorso 1: Python da Zero (BotFather + python-telegram-bot + OpenAI)

Il percorso classico per sviluppatori. Scrivi un piccolo servizio Python che collega la Telegram Bot API a un'API LLM e decide cosa succede nel mezzo.

Lo stack su cui convergono tutti:

# requirements.txt
python-telegram-bot==22.1
openai==1.40.0
python-dotenv==1.0.1

Il loop minimale è:

from telegram.ext import Application, MessageHandler, filters
from openai import OpenAI
import os

client = OpenAI(api_key=os.environ["OPENAI_API_KEY"])

async def reply(update, context):
    msg = update.message.text
    answer = client.chat.completions.create(
        model="gpt-4o-mini",
        messages=[{"role": "user", "content": msg}],
    ).choices[0].message.content
    await update.message.reply_text(answer)

app = Application.builder().token(os.environ["TELEGRAM_BOT_TOKEN"]).build()
app.add_handler(MessageHandler(filters.TEXT & ~filters.COMMAND, reply))
app.run_polling()

Quel codice è un chatbot, non ancora un agente. Per trasformarlo in un agente aggiungi quattro elementi:

Memoria. Una tabella SQLite o Postgres con chiave chat_id per la cronologia a breve termine. Per il richiamo a lungo termine, un vector store come ChromaDB, Qdrant o pgvector.
Strumenti. Function-calling sull'LLM per poter chiamare le tue API, il web o il file system.
Allowlist. Controlla update.effective_user.id rispetto a una variabile d'ambiente ALLOWED_USERS in modo che un utente Telegram casuale non possa svuotare la tua chiave.
Un host. Qualcosa che tenga il processo attivo quando il tuo laptop dorme. Un VPS da $5/mese come Hetzner CX22 o un Raspberry Pi sono più che sufficienti: il modello gira sui server OpenAI, non sui tuoi.

Tempo per arrivare a "agente che ricorda e usa strumenti": un weekend se sei pratico con Python, di più altrimenti. Costo: token del provider (qualche dollaro al mese a uso personale) più l'host.

Più adatto per: sviluppatori che vogliono pieno controllo, nessun vendor lock-in e sono disposti a mantenere un servizio Python.

Percorso 2: No-Code con n8n (o Make)

Se non vuoi scrivere codice ma vuoi comunque pieno controllo sul workflow, n8n è l'opzione open source più solida nel 2026. È un builder di workflow visuale che puoi self-hostare su un VPS da $5 o usare su n8n.cloud.

La build consiste in circa quattro nodi:

Telegram Trigger - ascolta i nuovi messaggi sul tuo bot.
Nodo AI Agent - il nodo agente integrato di n8n, configurato con un LLM (OpenAI, Anthropic, Groq, ecc.) e un buffer di memoria.
Nodi strumento (facoltativi) - HTTP Request, Google Sheets, Postgres, le tue API.
Telegram Send Message - risponde nella stessa chat.

Il nodo AI Agent ha un'opzione Memory integrata. Scegli Window Buffer Memory per gli ultimi N turni, oppure collega un nodo memoria Postgres o Redis per la persistenza tra i riavvii di n8n.

Il compromesso su cui vale la pena essere onesti: n8n è prima di tutto uno strumento di workflow e solo in secondo luogo una piattaforma per agenti. È eccellente quando il bot è principalmente uno strato di triage sopra un workflow già esistente: intake di lead, registrazione spese, aggiornamenti CRM, pre-triage del supporto clienti. Comincia a faticare quando l'agente deve ragionare piuttosto che instradare. Nel momento in cui ti ritrovi ad aggiungere un quinto nodo IF per gestire i casi limite dell'input in linguaggio naturale, stai simulando il ragionamento con rami condizionali e l'agente perderà. Abbiamo approfondito il compromesso in Hermes Agent vs n8n.

Più adatto per: persone non tecniche, o sviluppatori che già usano n8n per altri workflow e vogliono una superficie Telegram per accedervi.

Percorso 3: Builder SaaS Hosted

Sono piattaforme che racchiudono l'intero stack dietro una UI web. Ti registri, incolli il token BotFather, trascini qualche blocco, clicchi pubblica e il bot è live. Voiceflow, Botpress, Mosaia, Lobster Father e una lunga coda di builder di nicchia vivono qui.

I compromessi sono quelli prevedibili:

Il setup è il più semplice del settore: spesso meno di un'ora, a volte meno di cinque minuti.
Il BYOK è raro. Di solito consumi i crediti raggruppati del fornitore con un markup, oppure esaurisci il piano gratuito entro un giorno.
La "memoria" pubblicizzata sulla pagina marketing è spesso limitata alla sessione, non cross-session. Verifica questo aspetto all'ottavo giorno prima di impegnarti.
I tuoi messaggi e quelli dei tuoi utenti transitano attraverso l'infrastruttura del fornitore. Leggi la privacy policy.

Questo percorso va bene quando il bot è una FAQ rivolta ai clienti o una superficie di lead capture e non hai bisogno di memoria personale persistente.

Più adatto per: piccole aziende che vogliono un bot Telegram rivolto ai clienti con il minimo overhead operativo e non necessitano di memoria personale cross-session.

Percorso 4: Un Agent Runtime Self-Hosted

Questa è la categoria più recente e quella che si adatta meglio al caso d'uso "agente personale su Telegram". Un agent runtime self-hosted è un processo a lungo termine costruito appositamente per essere un agente: include memoria strutturata, uno strato di skill, uno scheduler e il supporto nativo su Telegram (e altre piattaforme di messaggistica) già integrato.

Le due opzioni open source concrete:

OpenClaw archivia tutto come file Markdown e YAML nel tuo workspace. Local-first, trasparente; le skill sono portabili tra macchine perché sono semplicemente file.
Hermes Agent è quello che conosciamo meglio, dato che Hermify ne è la versione gestita. Mantiene un profilo e una memoria persistente tra le sessioni, crea e migliora automaticamente le skill mentre lavora, gira su un VPS da $5 o un Raspberry Pi e ha supporto nativo per Telegram, inclusi enforcement dell'allowlist, modalità vocale e pianificazione in linguaggio naturale. Per una guida passo-passo su Hermes, vedi How To Deploy Hermes Agent On Telegram.

La struttura di costo è simile al Percorso 1 (lo host tu) con il vantaggio che il runtime fa il lavoro pesante su memoria, skill e affidabilità. Punta il tuo token OpenAI o Anthropic, inserisci il token BotFather nella configurazione e hai un agente che ricorda e agisce, senza servizi Python da mantenere.

Più adatto per: utenti che vogliono un vero agente personale (ricorda, impara, fa cose), tengono a possedere lo stack e sono a proprio agio su un VPS da $5 o su un Pi.

Come Scegliere

Un breve decision tree, ordinato per quello di cui la maggior parte delle persone ha effettivamente bisogno:

La tua situazione	Percorso
Vuoi un chatbot, non ti interessa la memoria o gli strumenti	SaaS hosted (Percorso 3). Gratuito o quasi, immediato.
Usi già n8n / Make per altri workflow	n8n (Percorso 2). Usa i nodi Telegram trigger + AI Agent.
Sei uno sviluppatore Python e vuoi pieno controllo	Python da zero (Percorso 1). Pianifica un weekend.
Vuoi un vero agente personale che ricorda e impara	Agent runtime self-hosted (Percorso 4).
Vuoi il Percorso 4 senza gestire un server	Runtime gestito: è quello che fa Hermify.

Un controllo di sanità mentale prima di impegnarti: costruisci il bot, scrivici per una settimana, poi all'ottavo giorno guarda cosa ricorda quando torni. Se riesce a richiamare il progetto che hai descritto mercoledì scorso, hai un agente. Se non può, hai un chatbot. Non c'è niente di sbagliato in un chatbot, ma dovresti sapere con quale delle due cose hai finito.

Perché Telegram e Non WhatsApp o Discord

Questa è la seconda domanda più frequente e vale una paragrafo. Telegram ha vinto per gli agenti personali perché tre fattori si allineano: la Bot API è gratuita e immediata (nessun costo per messaggio, nessuna verifica aziendale, nessuna approvazione di template), la piattaforma consente bot di terze parti senza attriti, e la UX della chat (risposte, allegati file, messaggi vocali, tastiere inline) è abbastanza ricca da supportare interazioni in stile agente. WhatsApp Business addebita ogni conversazione e richiede la verifica Meta con template pre-approvati: gestibile per il servizio clienti transazionale, scomodo per un agente personale a $19/mese. Discord è una valida alternativa quando la tua community ci vive; lo trattiamo in una guida di distribuzione separata.

Abbiamo anche scritto un confronto più approfondito su Best AI Assistant For Telegram se vuoi un'analisi affiancata delle principali opzioni invece di costruirne una tu stesso.

Conclusione

Il percorso più semplice, il SaaS hosted, va benissimo per un chatbot. Python da zero è la risposta giusta se ti piace collegare stack e vuoi che ogni riga di codice sia tua. n8n è la risposta giusta se il tuo bot è principalmente plumbing di workflow. Un agent runtime self-hosted è la risposta giusta se vuoi che l'assistente sia uno strumento a lungo termine che migliora più lo usi.

Se vuoi la versione agente personale senza gestire un server, inizia con Hermify. È la versione gestita di Hermes Agent: memoria persistente, BYOK, consegna su Telegram, enforcement dell'allowlist, nessun Docker da accudire.

Qualunque percorso scegli, il premio è lo stesso: un assistente che vive nell'app che già controlli cinquanta volte al giorno.