02 — Telegram

Un bot Telegram che parla con le tue app

Un bot non è una chat: è una porta d'ingresso al telefono. Con un messaggio puoi chiedere un dato a un'app, creare un appuntamento, archiviare un file o farti avvisare quando qualcosa cambia.

In cantiere il telefono è in tasca, i guanti sono sporchi e il portatile è in studio. In quel momento serve una cosa sola: scrivere due righe e che il lavoro sia fatto. Un bot Telegram è esattamente questo — il citofono del palazzo, dove il palazzo è la tua app.

La confusione più comune è credere che il bot *sia* l'app. Non lo è. Il bot è la facciata: riceve il messaggio, lo passa all'app, l'app fa il lavoro e risponde. Capito questo, le possibilità si moltiplicano, perché dietro la facciata puoi mettere tutto quello che sai costruire.

01

Come funziona, senza gergo

Su Telegram cerchi @BotFather, gli chiedi un nuovo bot e ricevi un token: è la password del bot, e va tenuta come tale. Poi indichi a Telegram un indirizzo a cui consegnare i messaggi — il *webhook* — che è una pagina della tua app.

Da quel momento il giro è sempre lo stesso: tu scrivi, Telegram consegna il testo al tuo indirizzo, la tua app decide che cosa fare, e risponde usando lo stesso token. Non serve nessuna applicazione da installare, né per te né per i colleghi: Telegram è già sul telefono di tutti.

02

Perché in studio funziona meglio di un'app

Nessuna installazione. Chi deve usarlo non scarica niente e non crea account.

Dettatura. Il messaggio vocale diventa testo con un tocco: è il modo più veloce di prendere appunti con le mani occupate.

Foto e file. Dal cantiere mandi tre fotografie e una nota, e il bot le archivia nella cartella della commessa giusta — non nel rullino, dove non le troverai più.

Funziona su qualsiasi telefono, iPhone o Android, vecchio o nuovo. Ed è l'unica interfaccia che serve imparare: la chat.

03

Cinque cose che può fare davvero

Creare un appuntamento. «Visita Rossi giovedì alle 15:30, via Roma 12» e l'evento compare nel calendario dello studio.

Archiviare i file. Le foto del sopralluogo finiscono nella cartella della commessa sul Drive, rinominate con data e luogo.

Rispondere con i dati dell'app. «Quante ore ho sulla commessa Bianchi?» e il bot legge il database e risponde. Non è una chat che inventa: è una chat che chiede.

Riassumere un documento. Mandi il PDF del capitolato e ricevi i punti che riguardano le tue lavorazioni.

Avvisare. Una pratica cambia stato, un cliente risponde, una consegna sta per scadere: il bot ti scrive. È il verso opposto, e spesso il più utile.

04

Il giro minimo per provarlo

1. Crea il bot con BotFather e conserva il token. 2. Fatti costruire la rotta che riceve i messaggi e pubblica l'app: Telegram deve poterla raggiungere da internet. 3. Imposta il webhook passando l'indirizzo della rotta e un secret token: quel segreto è ciò che impedisce a chiunque di scrivere nella tua app. 4. Autorizza solo la tua chat: ogni messaggio da un altro utente viene ignorato. 5. Manda un messaggio di prova e guarda la risposta. Se non arriva, il log della rotta è il primo posto da aprire.

05

Le regole di sicurezza

Il token e il secret stanno nelle variabili d'ambiente del servizio, mai nel codice e mai in chat.

La chat è un canale non cifrato end-to-end rispetto all'app: non ci si mandano dati sanitari, dati di pagamento o atti riservati.

I log registrano che cosa è successo, non il contenuto dei messaggi: un registro che contiene tutto è un archivio che non volevi.

In una riga

Un bot Telegram è il telecomando delle tue app: la chat è l'interfaccia, l'app fa il lavoro. Il limite non è tecnologico, è solo l'immaginazione su cosa valga la pena comandare.