Sincronizzare i dati di Apple Health con Home Assistant
Integra i tuoi dati di salute con Home Assistant.
Ultimo aggiornamento: 31 ottobre 2026
In questa pagina
Impostazioni di esportazione
Impostazioni di esportazione Intervallo di dateRaggruppamento temporalePubblica metriche di salute in Home Assistant come stati di entità separati. Questa destinazione supporta solo metriche di salute.
Importante — limitazioni delle automazioni: Il dispositivo deve essere sbloccato per leggere i dati di salute, e iOS non garantisce esecuzioni in background alla frequenza che scegli. Rivedi le limitazioni delle automazioni prima di affidarti alle esportazioni automatiche.
Aprire l’automazione
Apri Esporta → Automatico su iPhone, oppure Automazioni nella barra laterale dell’iPad. Seleziona Nuova automazione, oppure apri una esistente per modificarla.
Nome, stato e notifiche
Inserisci un nome che identifichi questa automazione. Attivato consente le esecuzioni automatiche; lascialo disattivato finché non sei pronto.
Scegli le notifiche di esecuzione che vuoi:
- Notifica all’aggiornamento della cache indica che sono stati preparati i dati di esportazione.
- Notifica all’esecuzione indica una pubblicazione corretta in Home Assistant.
Consenti le notifiche quando richiesto. Queste notifiche informano sull’attività; non programmano un’esecuzione.
Collegare Home Assistant
- Scegli Home Assistant come Tipo di automazione.
- Inserisci l’URL di base della tua istanza Home Assistant, ad esempio
http://homeassistant.local:8123. - Crea un token di accesso a lunga durata nel tuo profilo Home Assistant.
- In Intestazioni HTTP, aggiungi
Authorizationcon il valoreBearer YOUR_LONG_LIVED_ACCESS_TOKEN.
La tua istanza Home Assistant deve essere accessibile dall’iPhone o iPad. Per HTTPS, usa un certificato di cui il dispositivo si fida.
Impostazioni delle metriche di salute
Apri Seleziona metriche di salute e scegli le letture da pubblicare.
Apri Origini preferite per selezionare le origini di ciascuna metrica. Usa Tutte per tutte le origini non escluse, oppure Origini escluse per ignorare un’origine in questa automazione. Le esclusioni hanno priorità, e le origini non selezionate non sostituiscono un’origine preferita senza dati. Seleziona Salva per applicare le opzioni oppure Annulla per scartarle.
Impostazioni di esportazione
Home Assistant usa il proprio formato JSON di stato dell’entità; non c’è scelta di formato file né di versione di esportazione.
Intervallo di date
- Predefinito: Include il giorno precedente e oggi fino all’ora dell’esecuzione.
- Oggi: Include oggi fino all’ora dell’esecuzione.
- Ieri: Include l’intero giorno precedente.
Raggruppamento temporale
Scegli Predefinito per mantenere le letture non raggruppate oppure Giorni per usare riepiloghi giornalieri. Home Assistant non ha l’interruttore Riepiloga dati.
Programma promemoria
Se vuoi un avviso per sbloccare e aprire l’app, attiva Attiva promemoria. Scegli Ogni ora, Tutti i giorni o Giorni selezionati e configura il minuto, l’ora e i giorni come appropriato. Consenti l’accesso alle notifiche quando richiesto; se viene rifiutato, usa Apri le impostazioni delle notifiche.
Un promemoria non esegue l’automazione né conferma una sincronizzazione corretta. Toccalo per aprire l’automazione, oppure usa Apri e sincronizza nella notifica per richiedere un’esecuzione. L’automazione deve essere abilitata; un promemoria può comparire anche dopo un’esecuzione in background corretta. Le modifiche ai promemoria si applicano al salvataggio.
Frequenza di sincronizzazione e salvataggio
Scegli un numero e Minuti oppure Ore in Frequenza di sincronizzazione. È una cadenza desiderata in background, non una pianificazione garantita.
Il dispositivo deve essere sbloccato quando vengono letti i dati di salute. Attiva Aggiornamento in background per Health Auto Export e disattiva la modalità Risparmio energetico per le esecuzioni automatiche. iOS può ritardare le esecuzioni se il dispositivo è rimasto inattivo o le risorse di sistema sono limitate.
Attiva Attivato quando sei pronto per le esecuzioni automatiche e seleziona Aggiorna per salvare l’automazione. Puoi caricare subito un intervallo di date con i passaggi seguenti.
Entità pubblicate
Ciascuna metrica selezionata può produrre una o più entità. L’identificatore inizia con hae., seguito dal nome dell’automazione in minuscolo senza spazi, poi la metrica e qualsiasi nome di componente.
Ad esempio, un’automazione chiamata Health Metrics può pubblicare i passi in:
http://homeassistant.local:8123/api/states/hae.healthmetrics_step_count
Lo stato è l’ultima lettura del giorno selezionato, con attributi di unità di misura. Metriche come la pressione arteriosa e la frequenza cardiaca usano entità di componente separate.
Quando un giorno non ha dati, i totali come passi e ore in piedi pubblicano 0. Altre letture, come peso o frequenza cardiaca, non vengono aggiornate finché non ci sono dati, così Home Assistant può continuare a mostrare l’ultimo valore ricevuto. All’inizio del giorno, i totali possono rimanere a 0 finché i dati dell’Apple Watch non arrivano all’iPhone.
Esportare dati storici o mancati
Usa Caricamento manuale quando configuri per la prima volta l’automazione per esportare dati storici, oppure più avanti per coprire date che la sincronizzazione automatica non ha raggiunto. Puoi anche usarla per verificare la configurazione.
- Apri l’automazione e seleziona Caricamento manuale in Esporta dati esistenti.
- Imposta le date di Inizio e Fine e seleziona Avvia esportazione.
- In Home Assistant, apri Strumenti per sviluppatori → Stati e cerca il prefisso
hae.della tua automazione. - Controlla i valori delle entità e le ore di aggiornamento.
Risoluzione dei problemi
- Errore di autenticazione: Controlla il token e l’intestazione
Authorization: Bearer .... - Errore di connessione: Controlla l’URL di base, la porta, l’accesso alla rete e la fiducia del certificato.
- Alcune letture mancanti: Rivedi il giorno selezionato, le origini e i registri attività. Un’esecuzione può aggiornare alcune entità mentre altre non riescono.
Apri l’automazione e seleziona Visualizza registri attività per controllare i passaggi non riusciti. Per il supporto, consulta Ottenere aiuto.