Tasmota - Integrazione con Telegram

 

Ci sono alcuni passaggi da fare, ma è possibile fare una chat Telegram con un dispositivo con Tasmota a bordo, vediamo come!

Telegram e Tasmota? Si!

Telegram è una piattaforma di chat nota (tra le altre cose) per i suoi bot, ovvero dei programmi che rispondono agli input dell'utente. Tasmota è un firmware per dispositivi IoT che dialogano con l'utente.

Il merge era auspicabile, vediamo in questo post tutti i passaggi (in maniera chiara e semplice) per mettere questi due mondi in comunicazione!

Cosa serve lato Tasmota?

Lato Tasmota bisogna compilare il firmware aggiungendo queste due righe :

#define USE_TELEGRAM

#define USE_MQTT_TLS_CA_CERT

Se non sai come compilare il firmware, ti consiglio di fare come me!

Fatti un giro su HassioHelp, hanno un fantastico post intitolato "TasmoCompiler: Compilatore Online di Tasmota"

Io ho seguito la loro guida ed in 5 minuti avevo il firmware pronto, provate!

Dopo aver scaricato il firmware compilato con le due nuove opzioni, ovviamente, lo dovrete caricare su un dispositivo compatibile.

Direi che posso saltare questo passaggio, se sei arrivato qui immagino che tu sappia come fare il flash ad un dispositivo per installare Tasmota.

Cosa serve lato Telegram?

Bisogna creare un Bot, tutto gira attorno a quello. Non è una cosa difficile, anzi, ti aiuto io, basta che segui questi semplici passaggi!

• Apri Telegram e cerchi l'utenza @BotFather
• Apri una chat con l'utenza @BotFather e lanci il comando /start
• Lanci poi il comando /newbot
• A questo punto ti chiede lo username del tuo bot, ricordati che deve finire con il nome "bot" , quindi potrebbe essere una roba tipo "Tasmota_bot"

Ci sei, hai creato il tuo Bot!

Visto che era semplice e veloce?

BotFather a questo punto ti lascia un token alfanumerico, copia e salva questa chiave.

Potrebbe essere una cosa tipo questa :

9547231494:AAHzi--ik51GedFg45T8QLX4bbyNZni-MGc

Mi raccomando, salva questa stringa perchè ti servirà per Tasmota!

Ora ti colleghi a 

https://api.telegram.com/botXXXXXX/getMe

ed al posto di XXXXX ci metti il token.  Non dimenticarti la parte /getMe finale!

Se vuoi, funziona anche con https://api.telegram.org

Sarà quindi una cosa simile :

https://api.telegram.com/bot9547231494:AAHzi--ik51GedFg45T8QLX4bbyNZni-MGc/getMe

Lanci questo link e l'API ti risponde con una stringa visualizzata su una pagina web.

Adesso lanci questo link :

https://api.telegram.com/botXXXXXX/getupdates

ed al posto di XXXXX ci metti nuovamente il token . Non dimenticarti la parte /getupdates finale! Il tuo link quindi sarà circa così :

https://api.telegram.com/bot9547231494:AAHzi--ik51GedFg45T8QLX4bbyNZni-MGc/getupdates

Lanci questo link e l'API ti risponde con una stringa.

Adesso su Telegram apri un gruppo ed inviti l'utente bot che hai creato, lo trovi con la @ davanti al nome scelto.

Nel nostro caso sarà @Tasmota_bot, lo aggiungi lanciando il comando 

/join @Tasmota_Bot

A questo punto lanci nuovamente il secondo link , ovvero 

https://api.telegram.com/bot9547231494:AAHzi--ik51GedFg45T8QLX4bbyNZni-MGc/getupdates 

Nella risposta che ti arriva, cerchi il valore "chat":("id":-1111111111)

Salvati questa stringa numerica perchè è la ChatId , ovvero la chat che farai con il tuo bot!

Nel caso in esempio, il ChatID è 351671341

Come aprire un dialogo tra Tasmota e Telegram

Ora che hai il bot, il token ed il Chat Id, ci sei quasi!

Apri una console di Tasmota e digiti :

TmToken 9547231494:AAHzi--ik51GedFg45T8QLX4bbyNZni-MGc

Ecco cosa succede in console:

11:49:19 CMD: TmToken 9547231494:AAHzi--ik51GedFg45T8QLX4bbyNZni-MGc

11:49:19 RSL: RESULT = {"TmToken":"9547231494:AAHzi--ik51GedFg45T8QLX4bbyNZni-MGc"}

Ok, adesso devi inserire il ChatId con questo comando :

TmChatId 351671341

Ecco cosa succede in console:

11:49:26 CMD: TmChatId 351671341

11:49:26 RSL: RESULT = {"TmChatId":"351671341"}

Ok, ci siamo, mancano ancora un paio di passaggi!

Lancia adesso il comando TmState 5

Questo comando abilita l'echo locale di quanto viene mandato dal bot.

La risposta di Tasmota è la seguente :

11:28:14 CMD: TmState 5

11:28:14 RSL: RESULT = {"TmState":{"Send":"OFF","Receive":"OFF","Echo":"ON"}}

11:28:14 TGM: Started

Dopo circa 1 minuto si noterà sul Bot che viene lanciato il comando /start

Se non succede, non ti preoccupare, vuol dire che il tuo bot è già stato avviato.

Adesso bisogna levare l'echo locale del bot, basta lanciare TmState4 :

11:30:43 CMD: TmState 4

11:30:43 RSL: RESULT = {"TmState":{"Send":"OFF","Receive":"OFF","Echo":"OFF"}}

Ci siamo quasi, penultimo passaggio!Adesso bisogna lanciare il comando TmState 1

11:33:15 CMD: TmState 1

11:33:15 RSL: RESULT = {"TmState":{"Send":"ON","Receive":"OFF","Echo":"OFF"}}

Per inviare un comando da Tasmota a Telegram, basta lanciare il comando TmSend seguito dal testo che si vuole mostrare :

TmSend Prova invio da Tasmota

11:50:28 CMD: TmSend Prova invio da Tasmota

11:50:29 RSL: RESULT = {"TmSend":"Done"}

Direi che è andata a buon fine!

Alziamo un pochino l'asticella, riceviamo comandi da Telegram su Tasmota!

EDIT:

Dall'utente mosix76 è stato rilevato che 

 i comandi inviati da telegram vengono ricevuti solo se preceduti dal carattere "/". Es: "/power on", "/power off", "/quellochevuoi"

Evidentemente lui ha una release più aggiornata della mia e qualcosa è cambiato.

Comunque, la possibilità di ricevere comandi è prevista, lanciando il comando della console Tasmota Tmstate 3

11:36:36 CMD: tmstate 3

11:36:36 RSL: RESULT = {"TmState":{"Send":"ON","Receive":"ON","Echo":"OFF"}}

Ora, nella chat con il nostro bot scriviamo Power On

Ed anche questo è andato a buon fine!

Ma se volessimo lanciare tipo un comando di stato?

Basta scrivere nella chat Telegram "status 5", per esempio, ed ecco il risultato :

Direi semplicemente perfetto!!!

Nota: 

Se ti pare che ci mettano troppo tempo i comandi da Tasmota a Telegram e viceversa, puoi modificare il valore.

Basta lanciare il comando TmPoll seguito da un numero di secondi a tuo piacimento. Non sono accettati valori inferiori ai 4 secondi nè superiori a 300 secondi.

Conclusioni

Con un pochino di sbattimento (ma è più lo scriverlo che il farlo) abbiamo messo in comunicazione Tasmota e Telegram, direi quindi che la cosa è andata a buon fine!

Come sempre, l'ottimo Theo ha implementato una cosa davvero utile in Tasmota!

Per ora il supporto non è inserito ufficialmente nella Wiki, sono passati circa 2 mesi dall'implementazione.

NOTA : 

Tieni presente che tutti i parametri TmState non sono persistenti in memoria, quindi ad ogni riavvio sono da ripassare.

Questo potrebbe essere un lavoro per le Rule, ma ne parleremo più avanti...

Per ora, la soluzione grezza e veloce è lanciare questo comando :

backlog tmstate 5; tmstate 4; tmstate 1; tmstate 3

Spero che questo post ti sia piaciuto e che ti sia servito, se vuoi leggere altro a tema Tasmota, ho raccolto qui tutti i post che ne parlano!

Se non riesci a fare qualcosa di quanto scritto sopra, lascia un messaggio e ti darò volentieri una mano, vedrai che con un pochino di aiuto ci riuscirai!

Come interfacciare Tasmota con Telegram, in pochi e semplici passaggi!