Sincronizzare i dati Apple Health con Home Assistant

Le automazioni di Home Assistant ti consentono di sincronizzare automaticamente i tuoi dati sanitari con Home Assistant come stati dei sensori. Questa integrazione ti permette di utilizzare i tuoi dati sanitari nelle automazioni di Home Assistant, nei dashboard e in altre integrazioni.

Panoramica

Le automazioni di Home Assistant inviano le tue metriche sanitarie all'API REST di Home Assistant, creando o aggiornando stati dei sensori che possono essere utilizzati in tutta la tua istanza di Home Assistant. I dati sono formattati specificamente per l'API /states/ di Home Assistant.

Casi d'uso:

• Visualizzare le metriche sanitarie sui dashboard di Home Assistant
• Creare automazioni basate sui dati sanitari
• Integrare i dati sanitari con altri dispositivi smart home
• Tracciare le tendenze sanitarie nel tempo in Home Assistant

Caratteristiche principali:

• Creazione automatica degli stati dei sensori
• Solo formato JSON (ottimizzato per Home Assistant)
• Solo tipo di dati Health Metrics
• Configurazione URL semplice

Limitazioni

• Accesso ai dati sanitari: Le app non possono accedere ai dati sanitari mentre l'iPhone è bloccato. Le automazioni verranno eseguite solo durante i periodi in cui il dispositivo è sbloccato. Questo può influire sulla freschezza dei dati. Consulta le istruzioni per la sincronizzazione manuale per mantenere i dati aggiornati.

• Elaborazione in background: iOS limita l'elaborazione in background per preservare la durata della batteria. Le automazioni dipendono dall'Aggiornamento app in background e potrebbero non essere eseguite immediatamente se:

  • L'Aggiornamento app in background è disabilitato per l'app
  • Il dispositivo è in Modalità risparmio energetico
  • Il dispositivo è stato inattivo per periodi prolungati
  • Le risorse di sistema sono limitate
  • Più app stanno competendo per il tempo di esecuzione in background

• Supporta solo il tipo di dati Health Metrics

• Solo formato JSON (non può essere modificato)

Prerequisiti

• Un'istanza di Home Assistant in esecuzione e accessibile sulla tua rete
• Token di accesso API di Home Assistant (Token di accesso a lungo termine)
• Connettività di rete alla tua istanza di Home Assistant
• Versione di Home Assistant che supporta l'API REST

Configurazione

Naviga alla schermata Esportazioni automatizzate dalla navigazione principale, quindi tocca "Nuova automazione" e seleziona "Home Assistant" come Tipo di automazione.

Nome dell'automazione

Inserisci un nome descrittivo per la tua automazione. Questo nome verrà utilizzato per generare l'ID entità del sensore in Home Assistant.

Nota: Il nome dell'automazione verrà convertito in minuscolo con spazi rimossi per creare l'ID entità. Ad esempio, "I miei dati sanitari" diventa hae.imieidatisanitari.

Notifiche

Configura quando vuoi ricevere notifiche:

• Notifica all'aggiornamento della cache - Ricevi una notifica quando i dati nella cache vengono aggiornati
• Notifica all'esecuzione - Ricevi una notifica ogni volta che l'automazione viene eseguita

URL di Home Assistant

Inserisci l'URL di base della tua istanza di Home Assistant. Questo dovrebbe includere il protocollo e la porta se non stai usando quella predefinita.

URL di esempio:

• http://homeassistant.local:8123
• http://192.168.1.100:8123

Nota: L'URL deve essere accessibile dal tuo dispositivo. Se usi HTTPS, assicurati che il tuo certificato sia valido o aggiungi un'eccezione.

Endpoint generato automaticamente

L'app genera automaticamente l'endpoint API completo basato sul nome della tua automazione:

{your_url}/api/states/hae.{automation_name}

Ad esempio, se la tua URL è http://homeassistant.local:8123 e il nome della tua automazione è "Metriche sanitarie", l'endpoint sarà:

http://homeassistant.local:8123/api/states/hae.metrichesanitarie

Questo endpoint viene visualizzato sotto il campo URL come riferimento.

Timeout della richiesta

Seleziona un intervallo di timeout per le richieste HTTP a Home Assistant.

Opzioni di timeout disponibili:

• 60 secondi - Predefinito, adatto per la maggior parte delle istanze di Home Assistant
• 300 secondi (5 minuti) - Per istanze di Home Assistant più lente
• 1800 secondi (30 minuti) - Per elaborazione molto lenta
• 3600 secondi (1 ora) - Timeout massimo raccomandato

Intestazioni HTTP

Aggiungi intestazioni di autenticazione per l'accesso all'API di Home Assistant. Dovrai aggiungere un'intestazione Authorization con il tuo Token di accesso a lungo termine.

Intestazione richiesta:

• Authorization: Bearer YOUR_LONG_LIVED_ACCESS_TOKEN

Per ottenere un Token di accesso a lungo termine:

1. Apri Home Assistant
2. Vai al tuo profilo (clicca sul tuo nome in basso a sinistra)
3. Scorri verso il basso fino a "Token di accesso a lungo termine"
4. Clicca su "Crea token"
5. Dagli un nome (ad esempio, "Health Auto Export")
6. Copia il token e incollalo nel campo valore dell'intestazione

Intestazioni opzionali:
Puoi aggiungere intestazioni aggiuntive se necessario per la tua configurazione di Home Assistant.

Per aggiungere intestazioni:

1. Tocca "Aggiungi intestazioni"
2. Inserisci la chiave dell'intestazione nel campo sinistro
3. Inserisci il valore dell'intestazione nel campo destro
4. Ripeti per intestazioni aggiuntive

Importante: Ogni chiave dell'intestazione deve avere un valore corrispondente. Le intestazioni vuote verranno ignorate.

Impostazioni del tipo di dati

Tipo di dati

Nota: Le automazioni di Home Assistant supportano solo il tipo di dati Health Metrics. Questa impostazione non può essere modificata ed è automaticamente impostata su Health Metrics.

Configurazione Health Metrics

Seleziona Health Metrics - Scegli quali metriche specifiche includere. Puoi selezionare tutte le metriche disponibili o scegliere quelle specifiche.

Suggerimento: Selezionare solo le metriche di cui hai bisogno può migliorare il tempo di elaborazione e ridurre la dimensione dei dati inviati a Home Assistant.

Fonti preferite - Configura quali fonti di dati hanno la priorità quando più fonti forniscono la stessa metrica.

Impostazioni di esportazione

Formato di esportazione

Nota: Le automazioni di Home Assistant supportano solo il formato JSON. Questa impostazione non può essere modificata ed è automaticamente impostata su JSON.

Versione di esportazione

Nota: La versione di esportazione non è disponibile per le automazioni di Home Assistant poiché il formato è ottimizzato specificamente per l'API di stato di Home Assistant.

Intervallo di date

Seleziona quando i dati devono essere esportati:

• Predefinito - Sincronizza i dati per l'intero giorno precedente più i dati fino alla data e ora correnti
• Oggi - Sincronizza tutti i dati per la data corrente fino all'ora corrente
• Ieri - Sincronizza tutti i dati per l'intero giorno precedente

Nota: Le automazioni di Home Assistant non supportano le opzioni "Tempo reale", "Dall'ultima sincronizzazione" o "Ultimi 7 giorni".

Riassumi dati

Attiva o disattiva Riassumi dati per Health Metrics.

• ON - Fornisce riassunti di dati aggregati (predefinito)
• OFF - Fornisce dati disaggregati quando possibile

Nota: Questa impostazione si applica solo al tipo di dati Health Metrics.

Raggruppamento temporale

Quando Riassumi dati è abilitato, seleziona come i dati devono essere aggregati:

• Predefinito - Nessuna aggregazione, punti dati grezzi
• Giorni - Raggruppa i dati per giorno (consigliato)

Frequenza di sincronizzazione

Configura con quale frequenza l'automazione deve sincronizzare i dati con Home Assistant:

Seleziona un numero e un intervallo.

Test e verifica

Test manuali

1. Tocca "Esportazione manuale" nella schermata di configurazione dell'automazione
2. Seleziona un intervallo di date
3. Tocca "Esporta" per inviare una richiesta di test
4. Controlla in Home Assistant che lo stato del sensore sia stato creato/aggiornato

Verifica in Home Assistant

1. Apri Home Assistant
2. Vai a Strumenti sviluppatore > Stati
3. Cerca hae.{your_automation_name} (minuscolo, senza spazi)
4. Verifica che lo stato del sensore mostri i tuoi dati sanitari
5. Controlla il timestamp "Ultimo aggiornamento" per confermare le sincronizzazioni recenti

Visualizzazione dei log di attività

1. Tocca "Visualizza log di attività" nella schermata di configurazione dell'automazione
2. Rivedi le esecuzioni recenti dell'automazione
3. Controlla eventuali errori o avvisi
4. Verifica i timestamp delle richieste e lo stato della risposta

Controllo dei log di Home Assistant

Se i dati non compaiono in Home Assistant:

1. Apri Home Assistant
2. Vai a Impostazioni > Sistema > Log
3. Cerca errori relativi all'API REST o agli stati dei sensori
4. Controlla errori di autenticazione o formato dati non valido

Risoluzione dei problemi

Problemi comuni

Errori di autenticazione

• Verifica che il tuo Token di accesso a lungo termine sia corretto
• Assicurati che l'intestazione Authorization sia formattata come: Bearer YOUR_TOKEN
• Controlla che il token non sia scaduto o revocato
• Verifica che il token abbia le autorizzazioni appropriate in Home Assistant

Sensore che non appare in Home Assistant

• Controlla che il nome dell'automazione non contenga caratteri speciali
• Verifica il formato dell'ID entità: hae.{automation_name} (minuscolo, senza spazi)
• Controlla i log di Home Assistant per errori
• Assicurati che la richiesta API sia stata completata con successo (controlla i Log di attività)

Dati che non si aggiornano

• Verifica che l'automazione sia abilitata
• Rivedi i Log di attività per errori
• Assicurati della connettività di rete a Home Assistant

Timeout di connessione

• Verifica che Home Assistant sia in esecuzione e accessibile
• Controlla la connettività di rete
• Aumenta l'impostazione Timeout della richiesta se Home Assistant risponde lentamente
• Verifica che l'URL e la porta siano corretti

Messaggi di errore

L'app visualizzerà messaggi di errore se:

• L'URL non è valido o non raggiungibile
• L'autenticazione fallisce (controlla l'intestazione Authorization)
• Home Assistant restituisce un codice di stato di errore
• La connettività di rete non è disponibile

Controlla i Log di attività per informazioni dettagliate sugli errori, inclusi i codici di stato HTTP e i messaggi di errore di Home Assistant.

Suggerimenti per l'integrazione con Home Assistant

Utilizzare i dati sanitari nelle automazioni

Una volta che i tuoi dati sanitari sono sincronizzati con Home Assistant, puoi utilizzarli nelle automazioni:

automation:
  - alias: "Buona qualità del sonno"
    trigger:
      - platform: numeric_state
        entity_id: sensor.hae_myhealthdata_sleep_total
        above: 7
    action:
      - service: notify.mobile_app_your_phone
        data:
          message: "Ottimo sonno la scorsa notte!"

Creare dashboard

Aggiungi le metriche sanitarie al tuo dashboard di Home Assistant:

1. Vai al tuo dashboard
2. Aggiungi una nuova scheda
3. Seleziona il tipo di scheda "Entità" o "Gauge"
4. Aggiungi le entità dei sensori hae.{your_automation_name}

Struttura dello stato del sensore

Lo stato del sensore in Home Assistant contiene:

• state: Il valore o stato corrente
• attributes: Dati aggiuntivi inclusi:
  • Informazioni sul timestamp
  • Struttura dei dati corrispondente al formato JSON esportato
  • Informazioni sulle unità quando applicabile

Suggerimenti e best practice

1. Denominazione:

   • Evita caratteri speciali che potrebbero causare problemi

2. Selezione dei dati:

   • Seleziona solo le metriche di cui hai bisogno