Centro assistenza HealthyApps
Italiano
Centro assistenza
Sito principale ↗

Cerca argomenti di assistenza

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
Aprire l’automazioneNome, stato e notificheCollegare Home AssistantImpostazioni delle metriche di salute
Impostazioni di esportazione Impostazioni di esportazione Intervallo di dateRaggruppamento temporale
Programma promemoriaFrequenza di sincronizzazione e salvataggioEntità pubblicateEsportare dati storici o mancatiRisoluzione dei problemi

Pubblica 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

  1. Scegli Home Assistant come Tipo di automazione.
  2. Inserisci l’URL di base della tua istanza Home Assistant, ad esempio http://homeassistant.local:8123.
  3. Crea un token di accesso a lunga durata nel tuo profilo Home Assistant.
  4. In Intestazioni HTTP, aggiungi Authorization con il valore Bearer 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.

  1. Apri l’automazione e seleziona Caricamento manuale in Esporta dati esistenti.
  2. Imposta le date di Inizio e Fine e seleziona Avvia esportazione.
  3. In Home Assistant, apri Strumenti per sviluppatori → Stati e cerca il prefisso hae. della tua automazione.
  4. 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.