Hilfezentrum HealthyApps
Deutsch
Hilfezentrum
Hauptwebsite ↗

Hilfethemen suchen

Apple-Health-Daten mit Home Assistant synchronisieren

Integriere deine Gesundheitsdaten mit Home Assistant.

Zuletzt aktualisiert: 31. Oktober 2026

Auf dieser Seite
Automation öffnenName, Status und BenachrichtigungenHome Assistant verbindenEinstellungen für Gesundheitsmetriken
Exporteinstellungen Exporteinstellungen DatumsbereichZeitgruppierung
Erinnerungen planenSynchronisierungsfrequenz und speichernVeröffentlichte EntitätenHistorische oder verpasste Daten exportierenFehlerbehebung

Veröffentliche Gesundheitsmetriken in Home Assistant als separate Entitätszustände. Dieses Ziel unterstützt nur Gesundheitsmetriken.

Wichtig — Einschränkungen der Automationen: Das Gerät muss entsperrt sein, um Gesundheitsdaten zu lesen, und iOS garantiert keine Hintergrundausführungen mit der von dir gewählten Frequenz. Lies die Einschränkungen der Automationen, bevor du dich auf automatische Exporte verlässt.

Automation öffnen

Öffne Exportieren → Automatisiert auf dem iPhone oder Automationen in der Seitenleiste des iPad. Wähle Neue Automation oder öffne eine bestehende zum Bearbeiten.

Name, Status und Benachrichtigungen

Gib einen Namen ein, der diese Automation identifiziert. Aktiviert erlaubt automatische Ausführungen; lasse es ausgeschaltet, bis du bereit bist.

Wähle die Ausführungsbenachrichtigungen, die du möchtest:

  • Bei Cache-Aktualisierung benachrichtigen zeigt an, dass Exportdaten vorbereitet wurden.
  • Bei Ausführung benachrichtigen zeigt eine erfolgreiche Veröffentlichung in Home Assistant an.

Erlaube Benachrichtigungen, wenn du dazu aufgefordert wirst. Diese Benachrichtigungen melden Aktivität; sie planen keine Ausführung.

Home Assistant verbinden

  1. Wähle Home Assistant als Automationstyp.
  2. Gib die Basis-URL deiner Home-Assistant-Instanz ein, z. B. http://homeassistant.local:8123.
  3. Erstelle einen langlebigen Zugriffstoken in deinem Home-Assistant-Profil.
  4. Unter HTTP-Header füge Authorization mit dem Wert Bearer YOUR_LONG_LIVED_ACCESS_TOKEN hinzu.

Deine Home-Assistant-Instanz muss vom iPhone oder iPad erreichbar sein. Für HTTPS verwende ein Zertifikat, dem das Gerät vertraut.

Einstellungen für Gesundheitsmetriken

Öffne Gesundheitsmetriken auswählen und wähle die zu veröffentlichenden Messwerte.

Öffne Bevorzugte Quellen, um Quellen für jede Metrik auszuwählen. Verwende Alle für alle nicht ausgeschlossenen Quellen oder Ausgeschlossene Quellen, um eine Quelle in dieser Automation zu ignorieren. Ausschlüsse haben Vorrang, und nicht ausgewählte Quellen ersetzen keine bevorzugte Quelle ohne Daten. Wähle Sichern, um die Optionen anzuwenden, oder Abbrechen, um sie zu verwerfen.

Exporteinstellungen

Home Assistant verwendet sein eigenes JSON-Format für Entitätszustände; es gibt keine Dateiformat- oder Exportversionswahl.

Datumsbereich

  • Standard: Enthält den Vortag und heute bis zur Ausführungszeit.
  • Heute: Enthält heute bis zur Ausführungszeit.
  • Gestern: Enthält den vollständigen Vortag.

Zeitgruppierung

Wähle Standard, um Messwerte ungruppiert zu behalten, oder Tage für tägliche Zusammenfassungen. Home Assistant hat keinen Schalter Daten zusammenfassen.

Erinnerungen planen

Wenn du einen Hinweis zum Entsperren und Öffnen der App möchtest, aktiviere Erinnerungen aktivieren. Wähle Stündlich, Täglich oder Ausgewählte Tage und konfiguriere Minute, Uhrzeit und Tage entsprechend. Erlaube Benachrichtigungszugriff, wenn du dazu aufgefordert wirst; bei Ablehnung verwende Benachrichtigungseinstellungen öffnen.

Eine Erinnerung führt die Automation nicht aus und bestätigt keine erfolgreiche Synchronisierung. Tippe darauf, um die Automation zu öffnen, oder verwende Öffnen und synchronisieren in der Benachrichtigung, um eine Ausführung anzufordern. Die Automation muss aktiviert sein; eine Erinnerung kann auch nach einer erfolgreichen Hintergrundausführung erscheinen. Erinnerungsänderungen gelten beim Speichern.

Synchronisierungsfrequenz und speichern

Wähle eine Zahl und Minuten oder Stunden unter Synchronisierungsfrequenz. Das ist eine gewünschte Hintergrundkadenz, kein garantierter Zeitplan.

Das Gerät muss entsperrt sein, wenn Gesundheitsdaten gelesen werden. Aktiviere die Hintergrundaktualisierung für Health Auto Export und deaktiviere den Energiesparmodus für automatische Ausführungen. iOS kann Ausführungen verzögern, wenn das Gerät inaktiv war oder Systemressourcen begrenzt sind.

Aktiviere Aktiviert, wenn du für automatische Ausführungen bereit bist, und wähle Aktualisieren, um die Automation zu speichern. Du kannst sofort einen Datumsbereich mit den folgenden Schritten hochladen.

Veröffentlichte Entitäten

Jede ausgewählte Metrik kann eine oder mehrere Entitäten erzeugen. Die Kennung beginnt mit hae., gefolgt vom Automationsnamen in Kleinbuchstaben ohne Leerzeichen, dann der Metrik und jedem Komponentenname.

Zum Beispiel kann eine Automation namens Health Metrics Schritte veröffentlichen unter:

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

Der Zustand ist der letzte Messwert des ausgewählten Tages, mit Maßeinheitsattributen. Metriken wie Blutdruck und Herzfrequenz verwenden separate Komponentenentitäten.

Wenn ein Tag keine Daten hat, veröffentlichen Summen wie Schritte und Stehzeiten 0. Andere Messwerte, wie Gewicht oder Herzfrequenz, werden erst aktualisiert, wenn Daten vorhanden sind, sodass Home Assistant den zuletzt empfangenen Wert weiter anzeigen kann. Am Tagesbeginn können Summen bei 0 bleiben, bis Apple-Watch-Daten das iPhone erreichen.

Historische oder verpasste Daten exportieren

Verwende Manueller Upload bei der ersten Einrichtung der Automation, um historische Daten zu exportieren, oder später, um Daten abzudecken, die die automatische Synchronisierung nicht erreicht hat. Du kannst ihn auch verwenden, um die Konfiguration zu prüfen.

  1. Öffne die Automation und wähle Manueller Upload unter Vorhandene Daten exportieren.
  2. Lege die Daten für Start und Ende fest und wähle Export starten.
  3. Öffne in Home Assistant Entwicklertools → Zustände und suche das Präfix hae. deiner Automation.
  4. Prüfe die Entitätswerte und Aktualisierungszeiten.

Fehlerbehebung

  • Authentifizierungsfehler: Prüfe den Token und den Header Authorization: Bearer ....
  • Verbindungsfehler: Prüfe die Basis-URL, den Port, den Netzwerkzugriff und das Zertifikatsvertrauen.
  • Einige Messwerte fehlen: Prüfe den ausgewählten Tag, die Quellen und die Aktivitätsprotokolle. Eine Ausführung kann einige Entitäten aktualisieren, während andere fehlschlagen.

Öffne die Automation und wähle Aktivitätsprotokolle anzeigen, um fehlgeschlagene Schritte zu prüfen. Für Support siehe Hilfe erhalten.