Telegram permette di creare gratuitamente dei bot che possono inviare notifiche direttamente sullo smartphone. Sono molto utili nei progetti con Arduino, ESP32, Raspberry e altri dispositivi connessi a Internet, ad esempio per segnalare allarmi, inviare notifiche o cambiamenti di stato.

In questa guida vediamo rapidamente come creare un bot e recuperare i due dati che ci serviranno nei nostri progetti:

• Bot Token
• Chat ID

Creare il bot con BotFather

Apri Telegram e cerca @BotFather, il bot ufficiale utilizzato per creare e gestire i bot. Attenzione che ci sono molti bot non ufficiali e di simile nome!!

Avvia la chat e invia:

/newbot

BotFather chiederà di inserire un nome per il bot e successivamente uno username.

Lo username deve essere univoco e terminare con bot, ad esempio:

CavvaMonitorBot

Terminata la procedura, BotFather creerà il bot e fornirà il relativo Token API, simile a questo:

1234567890:AAxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Copialo e conservalo: servirà per permettere ad Arduino di utilizzare il bot.

Attenzione: il Token è una credenziale privata. Non pubblicarlo all’interno di sketch, articoli o repository pubblici. Se viene accidentalmente divulgato, revocalo tramite BotFather e generane uno nuovo.

Recuperare il Chat ID

Ora apri la chat con il bot appena creato, premi Avvia e inviagli un qualsiasi messaggio, ad esempio:

Ciao

A questo punto apri il browser e inserisci questo indirizzo, sostituendo TOKEN con il Token ricevuto da BotFather:

https://api.telegram.org/botTOKEN/getUpdates

Telegram mostrerà una risposta simile a questa:

"chat":{"id":123456789,"first_name":"..."}

Il numero indicato dopo "id": è il tuo Chat ID.

Se compare:

{"ok":true,"result":[]}

significa generalmente che Telegram non ha ancora ricevuto messaggi destinati al bot. Torna su Telegram, invia un nuovo messaggio al bot e aggiorna la pagina del browser.

I dati necessari

A questo punto abbiamo tutto quello che serve:

BOT_TOKEN = 1234567890:AAxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

CHAT_ID = 123456789

Questi due valori potranno essere utilizzati nei nostri sketch per inviare notifiche Telegram.

Quando pubblichiamo un progetto online è buona norma non inserire mai il vero Token nel codice scaricabile, ma utilizzare un file separato per le credenziali oppure dei valori di esempio.

Fatto!

Il bot Telegram è pronto.

Da questo momento potremo utilizzarlo nei nostri progetti Arduino per ricevere sul telefono allarmi e notifiche automatiche.

Un esempio pratico dove l’ho utilizzato è il progetto Monitoraggio temperatura sala server con Arduino UNO R4 WiFi, dove Telegram viene utilizzato per avvisare automaticamente quando la temperatura supera la soglia preimpostata.