Home / Blog / Come dare al tuo assistente AI un bot Telegram tutto suo

Come dare al tuo assistente AI un bot Telegram tutto suo (non un numero di telefono)

Due cose che suonano identiche e non lo sono. Un numero di telefono Telegram per la tua AI — una SIM vera collegata a un account vero — è la versione da film. Un bot Telegram per la tua AI — una piccola identità creata con BotFather, raggiungibile con @username — è la versione che funziona davvero, è legale e si configura in dieci minuti.

Cosa intendono di solito le persone quando lo chiedono

«Dai un numero Telegram alla mia AI» raramente significa una scheda SIM. Significa fammi parlare con lei su Telegram come con una persona. La stessa interfaccia che uso già per la famiglia e il lavoro. Gli stessi inoltri, gli stessi messaggi vocali, lo stesso trascinamento dei file. Solo, punta quell'indirizzo verso il mio assistente invece che verso un essere umano.

Telegram ti offre due porte per farlo. Solo una delle due è onesta per un assistente personale.

Le due porte, una accanto all'altra

Porta uno — lo userbot. Colleghi un account Telegram vero a una libreria di automazione (Telethon, MTProto, TDLib). Compare nella tua app come un contatto ordinario, vede la stessa cronologia dei messaggi che vedi tu e può fare tutto quello che può fare una persona. Potente. Ma anche: ha bisogno di una SIM vera per registrarsi, viola i Termini di servizio di Telegram nel momento stesso in cui fa qualcosa di palesemente automatico, viene segnalato e bloccato quando il rilevatore di pattern se ne accorge, e mescola l'attività del tuo assistente nella stessa cartella delle tue chat private. È la porta che prendi se stai costruendo strumenti di sorveglianza o se ti sta bene che l'account muoia ogni poche settimane. Per un'AI personale è la porta sbagliata.

Porta due — il bot. Apri una chat con @BotFather, esegui /newbot, scegli un nome visualizzato e un username, ricevi un token. Quel token è un'identità Telegram di prima classe a sé stante — non una persona, un bot. Raggiungibile con @nome_del_tuo_bot. Funziona dentro contratti ufficiali: i bot non possono iniziare conversazioni con estranei, non possono raccogliere in silenzio la cronologia, non possono fingere di essere un utente. Noioso, sicuro ed esattamente quello che serve a un assistente personale.

Il resto di questo articolo riguarda la porta due.

La configurazione in dieci minuti

  1. Parla con BotFather. Apri @BotFather. Invia /newbot. Scegli un nome visualizzato (è quello che le persone vedono nelle intestazioni delle chat). Scegli un username che finisca in bot — è l'@handle permanente. BotFather risponde con un token che assomiglia a 1234567890:AA....
  2. Conserva il token come una password. Mettilo nel file .env del tuo assistente, sul server che ospiterà il bot. Mai dentro git, mai in uno screenshot, mai incollato in un'altra chat. Se trapela, esegui /revoke in BotFather e ruotalo.
  3. Avvia il processo che parla con Telegram. Al tuo assistente serve un processo in esecuzione che apra un long-poll o un webhook contro il token. Un solo processo. Due processi sullo stesso token si annullano a vicenda con errori 409 Conflict dall'API di Telegram — un classico guasto del primo giorno.
  4. Saluta. Scrivi al tuo bot dal tuo Telegram. Dovrebbe rispondere. Se non lo fa, il token è sbagliato, il processo è morto, oppure qualcos'altro sta già occupando il token.
  5. Attiva le funzioni che vuoi. Di nuovo in BotFather: /setuserpic per l'avatar, /setdescription per la presentazione del profilo, /setabouttext per la bio breve, /setcommands per il menu dei comandi slash, /setprivacy se pensi di usare il bot nei gruppi e vuoi che veda tutti i messaggi invece delle sole menzioni.

Cosa dà davvero alla tua AI «un bot tutto suo»

Cosa non ti dà (e perché va benissimo così)

Un bot non può scrivere a freddo a estranei, non può leggere le chat in cui non si trova, non può vedere i messaggi inviati prima del suo ingresso in un gruppo. Sono le regole di Telegram ed esistono perché l'alternativa è una landa desolata di spam. Per un assistente personale questi vincoli sono regali: significano che il bot sente solo te, parla solo con te e vede solo quello che gli mostri deliberatamente.

Un bot non ha nemmeno un numero di telefono collegato. È proprio questa la caratteristica. Nessuna SIM da perdere, nessun account da farsi bannare, nessun «dispositivo principale» da tenere in vita. Solo un token e il processo che lo esegue.

Tre errori comuni del primo giorno

  1. Riusare un solo bot per molti lavori. Il primo bot funziona così bene che si finisce per attaccare ogni nuovo progetto allo stesso token. Poi il trascrittore automatico, gli avvisi di trading, l'aiutante della chat di famiglia e il funnel di vendita vivono tutti sotto un solo nome. Separali: un bot per ogni scopo, un token per ogni bot, un processo per ogni token. Non costa niente e mantiene piccole le superfici di guasto.
  2. Committare il token. Il token è tutta l'autenticazione. Chiunque lo possieda diventa il bot. Tienilo in .env (che sta nel tuo .gitignore) oppure in un gestore di segreti. Se compare anche solo una volta in un commit, in un log di GitHub o in uno screenshot condiviso — revocalo e ruotalo subito in BotFather.
  3. Far girare due copie del bot. Due processi che interrogano lo stesso token si fanno concorrenza e ricevono entrambi 409 Conflict. Sintomo: il bot risponde al tuo messaggio, poi qualche secondo dopo risponde di nuovo, poi ammutolisce. Rimedio: un processo, un host. Se distribuisci una versione nuova, ferma prima la vecchia.

Dove si colloca tutto questo in una configurazione AI personale

Il bot è la porta d'ingresso. Dietro c'è l'assistente vero e proprio: un modello, un po' di memoria, un insieme di skill, uno scheduler e un po' di collante che trasforma ogni aggiornamento di Telegram in una risposta reale. Puoi costruire tutto questo da zero — il token è standard, l'API è documentata, gli SDK sono maturi. Oppure puoi installare un sistema che arriva già cablato: su Avelina, il bot installer ti accompagna attraverso BotFather, prende il tuo token, distribuisce l'assistente sul tuo VPS e ti restituisce una chat funzionante nel giro di una serata. Stessa porta, meno collante.

Qualunque strada tu prenda, il bot non è l'assistente — è l'indirizzo a cui l'assistente risponde. Azzeccare l'indirizzo al primo colpo vale i dieci minuti.

Letture correlate