12. Notifiche

Le notifiche sono il modo in cui la tua casa ti parla. Fatte bene, sono il tuo miglior sensore: ti avvisano di cose che altrimenti non avresti mai visto. Fatte male, diventano un rumore di fondo che spegni dopo tre giorni, e da lì in avanti perdi anche le notifiche importanti. In questo capitolo vediamo i canali principali (mobile app, TTS, Telegram, persistent), come distinguerli per priorità, e la regola contro l’effetto “al lupo, al lupo”.

I canali di notifica

HA offre una decina di modi per notificare qualcosa. In un setup tipico servono tre o quattro canali.

Canale	Uso
notify.mobile_app_	Push notification sull’app HA installata sul telefono. Il canale principale.
TTS (Text to Speech)	Voce sugli speaker di casa (Google Home, Alexa, Sonos, HA Voice)
Telegram	Messaggi verso un bot Telegram, ricevuti su qualsiasi client Telegram loggato
persistent_notification	Notifica in-app HA (compare in un badge sulla sidebar)
notify.email	Mail (via SMTP configurato), utile per allegare foto o report lunghi
notify.file	Scrive su file (log persistente per audit)

L’app mobile HA è quasi obbligatoria: gestisce anche notifiche interattive (con pulsanti d’azione), notifiche critiche che bypassano il “non disturbare”, e le “location update” per la presenza.

Configurare la mobile app

Non serve installare nulla lato HA: quando accedi con l’app mobile HA (iOS o Android) per la prima volta, viene creata automaticamente l’integrazione Mobile App e appare un servizio notify.mobile_app_<nome_dispositivo>.

Da lì una notifica è una call service in automazione:

service: notify.mobile_app_iphone_di_ale
data:
  title: "Attenzione"
  message: "Finestra bagno aperta con caldaia accesa"

Opzioni utili nel data

• data.priority: high (Android) / data.push.sound.critical: 1 (iOS) → notifica che bypassa il Non Disturbare. Usa solo per cose veramente critiche.
• data.actions: [{action: "chiudi_finestra", title: "Chiudi"}] → pulsante nella notifica; il click genera un evento HA mobile_app_notification_action che puoi ascoltare come trigger.
• data.image: "http://.../snapshot.jpg" → allega un’immagine (es. snapshot di una telecamera).
• data.tag: "finestra_bagno" → sostituisce notifiche precedenti con lo stesso tag (evita di ricevere 10 avvisi ripetuti; il numero 10 viene “collapsato” in uno solo).

TTS: quando la voce è il canale giusto

Utile per informazioni contestuali e immediate: uno annuncia in cucina “sta arrivando qualcuno al cancello” mentre stai cucinando. Vale la pena quando:

• L’informazione è breve.
• Il momento è quello giusto (non alle 3 di notte).
• C’è qualcuno che può sentire e agire.

TTS lavora chiamando un servizio tts.* che a sua volta usa un media_player.

Esempio:

service: tts.google_translate_say
target:
  entity_id: media_player.echo_cucina
data:
  message: "Attenzione, il forno è pronto"

Alternative TTS locali (senza cloud): Piper (via Wyoming, integrato con HA Voice), qualità sorprendente e nessun dato che esce di casa.

Attenzione al volume: gli speaker Sonos/Alexa suonano al volume corrente. Se hai musica al 50%, il messaggio TTS arriva al 50%. Alcune integrazioni supportano announce: true che salva il volume corrente, alza per l’annuncio, poi ripristina.

Telegram: il canale “always-on”

Se vuoi ricevere notifiche anche quando non hai HA app installata (es. sul portatile al lavoro, o su un dispositivo di famiglia), un bot Telegram è la soluzione più semplice.

Setup una-tantum:

1. Su Telegram, chatti con @BotFather, comando /newbot, dai un nome, ricevi un token.
2. Cerchi il tuo bot su Telegram, gli scrivi /start (necessario per il bot per parlarti).
3. Trovi il tuo chat_id (via @userinfobot o simili).
4. In HA aggiungi l’integrazione Telegram Bot con token e chat_id.
5. Aggiungi un notifier: Impostazioni → Integrazioni → Telegram Broadcast (o simile).

Da lì notify.telegram funziona come notify.mobile_app, con supporto Markdown, immagini, video, inline keyboard.

Vantaggio: sopravvive al riavvio del telefono, al reset dell’app HA, ai cambi di rete. Se HA app non riceve una push, Telegram di solito sì.

persistent_notification: quando non vuoi disturbare ma vuoi lasciare traccia

Non fa suonare nulla. Aggiunge una notifica al centro notifiche di HA (icona in alto a destra, con badge numerato).

Utile per:

• Warning non urgenti che vuoi vedere quando apri HA (“batteria del sensore cucina sotto il 20%”).
• Report di operazioni (“backup notturno completato con successo alle 03:12”).
• Errori diagnostici (“integrazione X non risponde da un’ora”).

service: persistent_notification.create
data:
  title: "Backup"
  message: "Backup completato: 240 MB"
  notification_id: "backup_status"

Se metti sempre lo stesso notification_id, la nuova sostituisce la vecchia: non si accumulano.

Il principio del “boy who cried wolf”

Il singolo consiglio che salva dal disastro delle notifiche:

Ogni notifica che ricevi e ignori è un piccolo veleno per la prossima notifica che riceverai.

Dopo tre “batteria al 30%” ignorate perché tanto puoi cambiare quando vuoi, la quarta notifica (“Allarme! Fumo in cucina!”) avrà una probabilità un po’ più bassa di essere letta subito. Con dieci notifiche ignorate al giorno, l’app HA diventa rumore, e disattiverai le push del tutto.

Regole pratiche per evitarlo:

1. Dividi per priorità. Almeno tre livelli:
   • Critiche (sicurezza, danni): mobile app con priority: high + suono override.
   • Attenzione (batteria, aggiornamenti, avvisi): Telegram o persistent, silenziose.
   • Informative (backup ok, report giornalieri): persistent o file, mai push.
2. Non notificare mai quello che sarà evidente comunque. “La luce si è accesa” non è una notifica, è rumore.
3. Aggregare invece che spammare. Invece di “batteria X sotto 20%”, “batteria Y sotto 20%”, “batteria Z sotto 20%” nell’arco di una settimana, fai un’automazione settimanale che ti manda una notifica “Batterie da controllare: X, Y, Z”.
4. Usa il tag sulle notifiche ricorrenti, così si sovrascrivono invece di accumularsi.
5. Se ricevi una notifica e non hai fatto nulla per una settimana, disattivala. Non ti serve.

Il pattern “riepilogo del giorno”

Un modo utile di gestire il rumore è raccogliere i piccoli avvisi in un unico messaggio giornaliero.

Un’automazione alle 8:00 controlla:

• Batterie sotto soglia
• Sensori unavailable da >24h
• Backup fallito
• Aggiornamenti HACS disponibili

E manda una notifica con il riepilogo. Cose serie (allarme, sicurezza, danni acqua) restano push immediate, il resto arriva in un blocco leggibile al mattino.

Combinato con un template che skippa il messaggio se “niente da segnalare”, ricevi la notifica solo quando c’è davvero qualcosa.

Azioni interattive dalle notifiche

Un piccolo trucco molto utile: le notifiche interattive con actions. Esempio: “Finestra bagno rimasta aperta con caldaia accesa” con due pulsanti “Ignora” e “Spegni caldaia”. Il click sul pulsante genera un evento mobile_app_notification_action con action: spegni_caldaia. Un’automazione ascolta l’evento e reagisce.

Molto potente per notifiche di sicurezza / attenzione: invece di guardare la notifica → aprire HA → cercare l’entità → spegnere, fai tutto dalla notifica.

Ricapitolando

• Almeno tre canali: mobile app (critico), Telegram o persistent (attenzione), TTS (contestuale immediato).
• Le notifiche interattive con actions chiudono il loop notifica → azione senza aprire HA.
• Usa tag per non ricevere cascate della stessa notifica.
• Ogni notifica ignorata degrada quelle future: se non serve, spegnila.
• Aggrega gli avvisi non urgenti in un riepilogo giornaliero.