Home Assistant e Notifiche Telegram una coppia vincente

Telegram oramai sta coinvolgendo molti utenti, sia perchè è diventato uno strumento di comunicazione molto forte, ma anche perchè con una ricerca possiamo trovare tantissimi gruppi che parlano di argomenti di nostro interesse. Vedremo in questo articolo come far sposare la nostra domotica su Home Assistant con Telegram per essere avvertiti su ciò che accade in ambiente domestico con notifiche testuali, immagini o video. Già in passato Luigi Duchi, propose la stessa guida, reperibile a questo indirizzo: https://www.vincenzocaputo.com/home_assistant/home-assistant-aggiungiamo-le-notifiche-telegram-85 , ma dal 2018 ad oggi è cambiata qualcosina e ci ci sembrava doveroso poter aiutare con guide sempre aggiornate i nostri cari lettori, in modo tale da non dover sbattere la testa più di tanto con i vari cambiamenti.

Componenti necessari per il progetto:

• App Telegram istallata sullo smartphone (IOS , Android).
• Home Assistant.
• Addon Samba o Ftp Preinstallato.

1° Parte: Configurazione Telegram

• Aprite l'app Telegram dal vostro smartphone

1. Fate un tap o sull'icona della lente (posizionata in alto a destra dell'app) 
2. Digitate la keyword botfather
3. Cliccate sul simbolino del nonnino con lo smartphone in mano
4. Nella finestra di conversazione che si aprirà digitate /newbot 
5. Il bot vi risponderà in inglese chiedendovi di assegnare un nome al bot
6. Scegliete e digitate un nome a vostra scelta ex: ProvaBotTelegram
7. Il bot Grandfather ci risponderà in inglese indicandoci di inserire un Username che termini con la parola "bot"
8. Digitate e date conferma dell'Username scelto, ma fate attenzione perché se l'username è già stato scelto, il bot risponderà sempre in maniera automatica di ritentare modificando o riscrivendo quest'ultimo finché lo stesso risulti reperibile ( giocate un pò di fatasia magari sostituendo la a con @ o la i con 1 ) sino a ottenere una risposta positiva dal bot.
9. Annotate e salvate il token di accesso delle API HTTP che sarà utile successivamente per la configurazione su Home Assistant
10. Cliccate infine sul collegamento che il bot vi ha fornito nel primo paragrafo scritto in blu che inizia con t.me/nome_del_bot_assegnato 

• All'apertura della nuova finestra del bot appena creato cliccate su Start
• Scrivete una parola qualsiasi per far si che non abbiate problemi in futuro con l'integrazione.
• Successivamente ritornate alla ricerca dei contatti e digitate getidsbot e aprite la chat con questo nuovo bot 
• Date il comando /start o pigiate sul tasto START in basso alla pagina di conversazione.
• Questo nuovo Bot vi restituirà delle scritte che per noi saranno superflue ma verso la fine della pagina ci indicherà un parametro fondamentale il nostro id, quindi salvatelo perchè indispensabile nello step successivo. 

2° Parte: Configurazione Home Assistant

In questa parte abbiamo bisogno di due dati che abbiamo salvato in precedenza, ovvero l'id ricavato da getidsbot e il token di accesso delle Api HTTP. Dopo aver messo i dati in primo piano colleghiamoci su Home Assistant con Samba o Ftp.

• Aprire e modificare il file configuration.yaml di Home Assistant 
• Inserire in fondo alla configurazione questa parte di codice: 

telegram_bot:
  - platform: polling
    api_key: YOUR_API_KEY
    allowed_chat_ids:
      - 123456789 # (chat ID1)
      - 987654321 # (chat ID2)

Questo codice ovviamente dovrà essere modificato in base ai parametri sotto elencati:

• Accanto alla stringa api_key: inserite il codice alfa numerico che avete recuperato al punto 9 della parte precedente.
• Sotto ad allowed _chat_ids: inserite il codice numerico che avete ricavato con il bot getids
• Ovviamente se avete un altro membro della famiglia, che deve essere avvertito con delle notifiche potrete inserirlo dopo aver ricavato il suo Chat Ids dal bot sopra menzionato.

Dopo aver completato queste piccole modifiche scrivere il seguente codice:

notify:
  - platform: telegram
    name: NOTIFIER_NAME
    chat_id: CHAT_ID_1

In questo caso, le parti da cambiare sono NOTIFIER_NAME che indicherà il nome della persona che riceverà la notifica e CHAT_ID_1, ovvero il numero che abbiamo ricavato in precedenza dal bot getidsbot. Ovviamente ripetete questa parte di codice per tutti i componenti della famiglia su cui notificare un qualsiasi messaggio, come nell'esempio di seguito: 

notify:
  - name: Antonio
    platform: telegram
    chat_id: 245871258
  - name: Tyson
    platform: telegram
    chat_id: 25637021

- id: lavatrice_spenta
  alias: Lavatrice Spenta
  trigger:
  - entity_id: switch.lavatrice
    platform: state
    to: 'off'
  action:
  - service: notify.roberto
    data:
      message: La lavatrice ha terminato il lavaggio

Inviare Immagini con notifiche telegram: 

Per poter inviare le immagini, Home Assistant le potrà reperire o da un URL specifico, oppure dai file contenuti nel proprio sistema. Vediamo i due esempi di servizi e analizziamoli per comprendere il tutto:

  service: notify.roberto
  data:
    title: Invio immagine

automation:

- id: prova_foto
  alias: prova foto
  trigger:
  - entity_id: light.luce_studio
    platform: state
    to: 'on'
  action:
  - service: notify.antonio
    data:
      message: "ciao"
      data:
        photo:
        - file: /media/immagini/pippo.jpg

automation:

- id: prova_video
  alias: prova video
  trigger:
  - entity_id: light.luce_studio
    platform: state
    to: 'on'
  action:
  - service: notify.antonio
    data:
      message: "prova video"
      data:
        video:
        - url: http://192.168.1.48/camera.mp4