Come Collegare un Assistente IA a Telegram

Vuoi che lo stesso assistente che già usi in una scheda del browser viva dentro Telegram, così puoi scrivergli dal telefono che hai in tasca invece di aprire il laptop. La buona notizia: la parte idraulica è semplice, un token del bot, un loop di messaggi e un LLM. La parte meno ovvia è cosa serve per tenere in piedi quella pipeline dopo la prima risposta "hello world".

Perché mettere un assistente IA su Telegram

La maggior parte degli strumenti IA vive dietro una URL. Ci vai, digiti, leggi la risposta e chiudi la scheda. Il contesto svanisce nel momento in cui chiudi.

Telegram ribalta la cosa trattando il tuo assistente come qualsiasi altra conversazione nella lista contatti. Puoi mandargli una nota vocale dall'auto, inoltrargli un link da una chat di gruppo o incollare un errore mentre sei loggato da desktop. Dall'altra parte, lo stesso assistente conserva la memoria di ognuna di queste interazioni, perché a rispondere è un processo persistente e non una pagina che si ricarica.

Con questa cornice in testa, la domanda interessante non è più "posso far rispondere un bot Telegram?", a cui quasi ogni guida risponde in cinque minuti. La vera domanda è "chi è di turno quando il bot ammutolisce alle 23 di un martedì?".

Passo 1: Crea il bot in BotFather

Apri Telegram e cerca @BotFather. È l'account ufficiale con la spunta blu di verifica. Premi Avvia e invia:

/newbot

BotFather ti fa due domande:

Nome visualizzato: quello che compare sulla scheda contatto del bot. Modificabile dopo.
Username: l'@handle usato nei link e nelle menzioni. Deve avere da 5 a 32 caratteri, solo alfabeto latino, e finire in bot (per esempio miaia_assistente_bot).

Quando accetti uno username valido, BotFather ti rimanda un token. Ha questo aspetto:

7123456789:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw

Tratta quella stringa come se fosse una password. Non incollarla in screenshot, gruppi o repository pubblici. Se dovesse trapelare, scrivi /revoke a BotFather, seleziona il bot e te ne darà uno nuovo; il vecchio smette di funzionare all'istante.

Passo 2: Decidi chi pensa

Il token del bot serve solo a inviare e ricevere messaggi. Non decide cosa dire. Quello è compito del LLM. Hai tre grandi opzioni:

Una singola API LLM: puntare direttamente a OpenAI, Anthropic o Google. Semplice, ma ogni provider ha il suo SDK, il suo modello di auth e i suoi limiti.
Un router tipo OpenRouter: una sola chiave API che dà accesso a decine di modelli. Cambi modello a seconda del compito (veloce ed economico per la chat, modello grande per il ragionamento) senza destreggiarti tra account.
Un modello locale: Ollama o llama.cpp sul tuo hardware. Nessun costo per token, ma l'uptime è affar tuo.

Per un assistente personale che deve sembrare reattivo, la maggior parte finisce su un'API ospitata. La latenza verso un modello locale su hardware consumer di solito è peggiore di quella di una API commerciale ben connessa, e la qualità è ancora indietro sul ragionamento generale.

Qualunque provider tu scelga, genera ora la chiave dalla sua dashboard e mettila insieme al token del bot. Al prossimo passo ti serviranno entrambe.

Passo 3: Costruisci (o prendi in prestito) il loop di messaggi

Tra Telegram e il LLM serve un piccolo software che:

Faccia long polling (o usi webhook) contro l'API dei bot di Telegram per i nuovi messaggi.
Passi il testo del messaggio (e magari la cronologia della conversazione) al LLM.
Rimandi la risposta del LLM nello stesso chat di Telegram.
Gestisca gli errori così che un singolo problema non uccida il loop in silenzio.

Se te la cavi con Python, la libreria python-telegram-bot più l'SDK del provider ti danno un prototipo funzionante in circa 40 righe. Node ha pacchetti equivalenti. Per una strada strettamente no-code, strumenti come Make.com o n8n ti fanno trascinare un trigger Telegram e un'azione OpenAI su una tela e collegarli con una linea.

Due dettagli che quasi sicuramente vorrai aggiungere prima di considerarlo usabile:

Una lista di utenti autorizzati, così sconosciuti che indovinano l'handle del bot non ti bruciano il budget API. I bot sono ricercabili su Telegram; senza allowlist, il tuo bot risponde a chiunque.
Una memoria di conversazione, così l'assistente ricorda i turni precedenti nella stessa chat invece di trattare ogni messaggio come il primo. Persisti la cronologia in un database indicizzato per chat_id, oppure usa un framework di agenti con memoria integrata.

Passo 4: Tieni vivo il processo

È qui che muoiono in silenzio la maggior parte dei progetti da weekend.

Il tuo bot Telegram risponde solo finché il loop di messaggi è in esecuzione. Se gira in un terminale sul laptop, si ferma nel momento in cui il laptop va in sospensione. Se è un python bot.py su un VPS economico, si ferma alla prossima caduta del processo, al prossimo reboot del VPS per un aggiornamento del kernel o alla prossima eccezione non gestita alle 3 del mattino.

La risposta abituale è poco glamour:

Incarta il processo in systemd (o Docker con restart: unless-stopped) così che il sistema operativo lo rimetta su dopo un crash o un riavvio.
Manda i log in un posto dove davvero li andrai a guardare (un file ruotato da logrotate o un servizio di log ospitato).
Aggiungi un health check che ti avvisi se il bot non riceve un update da Telegram da N minuti.
Metti token del bot e chiavi API in un secret store, non in un config.yaml sullo stesso disco del codice.

Niente di tutto questo è difficile preso singolarmente. È semplicemente una responsabilità continua, ed è la parte che decide se "assistente IA su Telegram" diventa uno strumento quotidiano piacevole o un progetto da rimettere online ogni poche settimane.

La scorciatoia: usare un Hermes Agent gestito

Se ti piace l'idea dell'assistente IA su Telegram ma non quella di amministrare un server Linux, la scorciatoia è delegare i due passi centrali e tenerti quelli che ti interessano davvero.

Hermify esegue un Hermes Agent gestito come contatto Telegram per te. Tu porti:

Il tuo token del bot (dal passo 1)
Una chiave del provider del modello (dal passo 2), oppure un piano che include l'accesso al modello

Hermify si occupa del loop di messaggi, del supervisore di processo, dei file di memoria che persistono tra le conversazioni e dello storage sicuro delle credenziali. Il bot è attivo nel tuo Telegram in circa un minuto, e quando il processo deve riavviarsi si riavvia da solo, così te ne accorgi da una dashboard e non da una chat silenziosa. Inizia con Hermify per provare la strada gestita.

L'Hermes Agent sottostante è open source, quindi non sei bloccato sull'hosting: puoi spostare la stessa configurazione sul tuo VPS più avanti se decidi che l'onere operativo ne vale la pena. La maggior parte scopre di non farlo mai.

Scegliere tra DIY e gestito

Entrambe le strade funzionano. La decisione riguarda dove vuoi spendere attenzione:

DIY se già gestisci questa classe di infrastruttura, vuoi controllo totale su modello, file di memoria e prompt, e vedi la parte operativa come parte del divertimento.
Gestito se vuoi che l'assistente sia semplicemente un contatto Telegram a cui scrivere da qualsiasi posto, senza manutenzione nel weekend.

In entrambi i casi il guadagno di UX nel fondo è lo stesso: il tuo assistente smette di essere una URL e diventa qualcuno a cui mandare un messaggio. Quando vive dentro Telegram, lo usi davvero.

Se vuoi confrontare i passi di setup con una distribuzione concreta, la guida al deploy su Telegram percorre una configurazione completa da capo a piedi. Se vuoi la scorciatoia, inizia con Hermify e il tuo assistente è attivo su Telegram in circa un minuto.