DomotiCasa

La tua guida alla casa intelligente

Guida completa a Telegram su Home Assistant

Guida completa a Telegram su Home Assistant: come configurare notifiche e automazioni passo passo

Giovanni Provenzano06 mins

La ricezione di notifiche in tempo reale è un aspetto chiave per monitorare efficacemente il funzionamento della tua smart home. Home Assistant offre numerose opzioni per inviare avvisi in caso di eventi, ma uno dei metodi più stabili, versatili e ampiamente utilizzati è la configurazione di Telegram.

Con quasi 800 milioni di utenti attivi, Telegram si distingue per la sua sicurezza, rapidità e possibilità di creare bot personalizzati che dialogano direttamente con il sistema domotico. Questa guida ti accompagnerà passo dopo passo, coprendo tutte le modalità di configurazione, dall’installazione dell’integrazione ufficiale al setup YAML, fino alle automazioni più avanzate e ai trucchi per messaggi interattivi.

Passo 1 – Creare un Bot Telegram tramite BotFather

Telegram offre un servizio ufficiale chiamato BotFather, che consente di generare bot e ottenere un token API, indispensabile per la comunicazione tra Home Assistant e Telegram.

Come fare

  1. Cerca su Telegram il bot “@BotFather” e avvia la chat.

  2. Digita il comando /newbot e segui le istruzioni:

    • Scegli un nome per il bot (es: “DomoticaCasaBot”)

    • Scegli uno username univoco e che termini con “bot” (es: “domoticacasabot”)

  3. Al termine, riceverai un token, una lunga stringa alfanumerica, da usare per configurare l’integrazione.

Conserva con attenzione questo token, perché rappresenta la chiave d’accesso per il tuo bot.

Passo 2 – Ottenere il proprio User ID Telegram

Per ricevere i messaggi, devi fornire a Home Assistant il tuo User ID Telegram o l’ID del gruppo a cui vuoi inviare notifiche.

Metodo rapido per user ID personale

  • Cerca su Telegram il bot: @userinfobot

  • Clicca su Start e aspetta la risposta che contiene il tuo User ID (numero intero)

Passo 3 – Installare e configurare Telegram in Home Assistant

Metodo 1: Integrazione ufficiale Home Assistant

  1. Vai su Impostazioni > Dispositivi e Servizi > Aggiungi Integrazione

  2. Cerca Telegram

  3. Inserisci il token bot ottenuto da BotFather

  4. Inserisci il tuo ID utente o gruppo

  5. Conferma e completa la configurazione

Questa modalità è veloce, non richiede modifiche manuali al file YAML e funziona immediatamente.

Metodo 2: Configurazione YAML (ideale per utenti avanzati)

Nel file configuration.yaml, aggiungi:

telegram_bot:
  - platform: polling
    api_key: "TOKEN_BOT_TELEGRAM"
    allowed_chat_ids:
      - 123456789  # tuo user ID o ID gruppo

Riavvia Home Assistant per applicare.

Passo 4 – Verifica della configurazione

Apri Strumenti per sviluppatori > Servizi e seleziona:

  • telegram_bot.send_message

Imposta i parametri:

  • message: "Messaggio di prova Home Assistant"

  • target: 123456789 (opzionale se già configurato)

Clicca su CHIAMA SERVIZIO. Se ricevi il messaggio su Telegram, la configurazione è corretta.

Passo 5 – Creare automazioni con notifiche Telegram

Esempio base

Invio di messaggio alla rilevazione di apertura porta:

automation:
  - alias: "Avviso apertura porta"
    trigger:
      platform: state
      entity_id: binary_sensor.door_sensor
      to: "on"
    action:
      service: telegram_bot.send_message
      data:
        message: "Attenzione, la porta è stata aperta!"

Passo 6 – Funzionalità avanzate

Invio foto e video

Puoi inviare immagini con il servizio telegram_bot.send_photo:

action:
  service: telegram_bot.send_photo
  data:
    photo: "/config/www/camera_ingresso.jpg"
    caption: "Video sorveglianza ingresso"

Oppure da URL remoto:

photo: "https://example.com/immagine.jpg"

Messaggi con pulsanti Inline

Telegram supporta messaggi con pulsanti per comandi rapidi:

telegram_bot.send_message:
  data:
    message: "Scegli un'opzione"
    inline_keyboard:
      - "[[Accendi luce, accendi_luce], [Spegni luce, spegni_luce]]"

Passo 7 – Ricevere comandi Telegram da Home Assistant

La configurazione consente anche di interagire con bot per eseguire comandi da Telegram direttamente su Home Assistant. Si possono creare chatbot personalizzati, risposte automatiche e controlli vocali avanzati.

Consigli pratici

  • Crea gruppi dedicati di notifica per separare messaggi di sicurezza, clima, luci e altri

  • Usa filtri e condizioni nei trigger per non saturare con troppe notifiche

  • Imposta notifiche con priorità diverse per eventi critici (fumo, allarme) e meno urgenti (porte aperte)

  • Cambia periodicamente il token Telegram per sicurezza

  • Usa password e autenticazione a due fattori su Home Assistant e Telegram

Titoli Correlati