Synchroniser les données Apple Health avec Home Assistant

Les automatisations Home Assistant vous permettent de synchroniser automatiquement vos données de santé avec Home Assistant sous forme d'états de capteurs. Cette intégration vous permet d'utiliser vos données de santé dans les automatisations Home Assistant, les tableaux de bord et autres intégrations.

Vue d'ensemble

Les automatisations Home Assistant envoient vos métriques de santé à l'API REST de Home Assistant, créant ou mettant à jour des états de capteurs qui peuvent être utilisés dans toute votre instance Home Assistant. Les données sont formatées spécifiquement pour l'API /states/ de Home Assistant.

Cas d'usage :

• Afficher les métriques de santé sur les tableaux de bord Home Assistant
• Créer des automatisations basées sur les données de santé
• Intégrer les données de santé avec d'autres appareils domotiques
• Suivre les tendances de santé au fil du temps dans Home Assistant

Fonctionnalités principales :

• Création automatique d'états de capteurs
• Format JSON uniquement (optimisé pour Home Assistant)
• Type de données Health Metrics uniquement
• Configuration d'URL simple

Limitations

• Accès aux données de santé : Les applications ne sont pas autorisées à accéder aux données de santé lorsque l'iPhone est verrouillé. Les automatisations ne s'exécuteront que pendant les périodes où votre appareil est déverrouillé. Cela peut affecter la fraîcheur des données. Consultez les instructions pour la synchronisation manuelle pour maintenir les données à jour.

• Traitement en arrière-plan : iOS limite le traitement en arrière-plan pour préserver l'autonomie de la batterie. Les automatisations dépendent de l'actualisation en arrière-plan des applications et peuvent ne pas s'exécuter immédiatement si :

  • L'actualisation en arrière-plan des applications est désactivée pour l'application
  • L'appareil est en mode économie d'énergie
  • L'appareil est resté inactif pendant de longues périodes
  • Les ressources système sont limitées
  • Plusieurs applications se disputent le temps d'exécution en arrière-plan

• Ne prend en charge que le type de données Health Metrics

• Format JSON uniquement (ne peut pas être modifié)

Prérequis

• Une instance Home Assistant en cours d'exécution et accessible sur votre réseau
• Token d'accès API Home Assistant (Token d'accès de longue durée)
• Connectivité réseau à votre instance Home Assistant
• Version de Home Assistant qui prend en charge l'API REST

Configuration

Accédez à l'écran Exports automatisés depuis la navigation principale, puis appuyez sur "Nouvelle automatisation" et sélectionnez "Home Assistant" comme Type d'automatisation.

Nom de l'automatisation

Entrez un nom descriptif pour votre automatisation. Ce nom sera utilisé pour générer l'ID d'entité du capteur dans Home Assistant.

Note : Le nom de l'automatisation sera converti en minuscules avec les espaces supprimés pour créer l'ID d'entité. Par exemple, "Mes données de santé" devient hae.mesdonneesdesante.

Notifications

Configurez quand vous souhaitez recevoir des notifications :

• Notifier lors de la mise à jour du cache - Recevez une notification lorsque les données en cache sont mises à jour
• Notifier lors de l'exécution - Recevez une notification à chaque exécution de l'automatisation

URL Home Assistant

Entrez l'URL de base de votre instance Home Assistant. Cela doit inclure le protocole et le port si vous n'utilisez pas celui par défaut.

Exemples d'URL :

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

Note : L'URL doit être accessible depuis votre appareil. Si vous utilisez HTTPS, assurez-vous que votre certificat est valide ou ajoutez une exception.

Point de terminaison généré automatiquement

L'application génère automatiquement le point de terminaison API complet basé sur le nom de votre automatisation :

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

Par exemple, si votre URL est http://homeassistant.local:8123 et que le nom de votre automatisation est "Métriques de santé", le point de terminaison sera :

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

Ce point de terminaison est affiché sous le champ URL pour référence.

Délai d'expiration de la requête

Sélectionnez un intervalle de délai d'expiration pour les requêtes HTTP vers Home Assistant.

Options de délai d'expiration disponibles :

• 60 secondes - Par défaut, adapté à la plupart des instances Home Assistant
• 300 secondes (5 minutes) - Pour les instances Home Assistant plus lentes
• 1800 secondes (30 minutes) - Pour un traitement très lent
• 3600 secondes (1 heure) - Délai d'expiration maximum recommandé

En-têtes HTTP

Ajoutez des en-têtes d'authentification pour l'accès à l'API Home Assistant. Vous devrez ajouter un en-tête Authorization avec votre Token d'accès de longue durée.

En-tête requis :

• Authorization: Bearer YOUR_LONG_LIVED_ACCESS_TOKEN

Pour obtenir un Token d'accès de longue durée :

1. Ouvrez Home Assistant
2. Allez dans votre profil (cliquez sur votre nom en bas à gauche)
3. Faites défiler jusqu'à "Tokens d'accès de longue durée"
4. Cliquez sur "Créer un token"
5. Donnez-lui un nom (par exemple, "Health Auto Export")
6. Copiez le token et collez-le dans le champ de valeur de l'en-tête

En-têtes optionnels :
Vous pouvez ajouter des en-têtes supplémentaires si nécessaire pour votre configuration Home Assistant.

Pour ajouter des en-têtes :

1. Appuyez sur "Ajouter des en-têtes"
2. Entrez la clé de l'en-tête dans le champ de gauche
3. Entrez la valeur de l'en-tête dans le champ de droite
4. Répétez pour les en-têtes supplémentaires

Important : Chaque clé d'en-tête doit avoir une valeur correspondante. Les en-têtes vides seront ignorés.

Paramètres du type de données

Type de données

Note : Les automatisations Home Assistant ne prennent en charge que le type de données Health Metrics. Ce paramètre ne peut pas être modifié et est automatiquement défini sur Health Metrics.

Configuration Health Metrics

Sélectionner Health Metrics - Choisissez quelles métriques spécifiques inclure. Vous pouvez sélectionner toutes les métriques disponibles ou choisir des métriques spécifiques.

Astuce : Sélectionner uniquement les métriques dont vous avez besoin peut améliorer le temps de traitement et réduire la taille des données envoyées à Home Assistant.

Sources préférées - Configurez quelles sources de données ont la priorité lorsque plusieurs sources fournissent la même métrique.

Paramètres d'exportation

Format d'exportation

Note : Les automatisations Home Assistant ne prennent en charge que le format JSON. Ce paramètre ne peut pas être modifié et est automatiquement défini sur JSON.

Version d'exportation

Note : La version d'exportation n'est pas disponible pour les automatisations Home Assistant car le format est optimisé spécifiquement pour l'API d'état de Home Assistant.

Plage de dates

Sélectionnez quand les données doivent être exportées :

• Par défaut - Synchronise les données pour la journée précédente complète plus les données jusqu'à la date et l'heure actuelles
• Aujourd'hui - Synchronise toutes les données pour la date actuelle jusqu'à l'heure actuelle
• Hier - Synchronise toutes les données pour la journée précédente complète

Note : Les automatisations Home Assistant ne prennent pas en charge les options "Temps réel", "Depuis la dernière synchronisation" ou "7 derniers jours".

Résumer les données

Activez ou désactivez Résumer les données pour Health Metrics.

• ON - Fournit des résumés de données agrégées (par défaut)
• OFF - Fournit des données désagrégées lorsque c'est possible

Note : Ce paramètre s'applique uniquement au type de données Health Metrics.

Regroupement temporel

Lorsque Résumer les données est activé, sélectionnez comment les données doivent être agrégées :

• Par défaut - Pas d'agrégation, points de données bruts
• Jours - Regroupe les données par jour (recommandé)

Fréquence de synchronisation

Configurez la fréquence à laquelle l'automatisation doit synchroniser les données avec Home Assistant :

Sélectionnez un nombre et un intervalle.

Tests et vérification

Tests manuels

1. Appuyez sur "Export manuel" dans l'écran de configuration de l'automatisation
2. Sélectionnez une plage de dates
3. Appuyez sur "Exporter" pour envoyer une requête de test
4. Vérifiez dans Home Assistant que l'état du capteur a été créé/mis à jour

Vérification dans Home Assistant

1. Ouvrez Home Assistant
2. Allez dans Outils de développement > États
3. Recherchez hae.{your_automation_name} (minuscules, sans espaces)
4. Vérifiez que l'état du capteur affiche vos données de santé
5. Vérifiez le timestamp "Dernière mise à jour" pour confirmer les synchronisations récentes

Consultation des journaux d'activité

1. Appuyez sur "Voir les journaux d'activité" dans l'écran de configuration de l'automatisation
2. Consultez les exécutions récentes de l'automatisation
3. Vérifiez s'il y a des erreurs ou des avertissements
4. Vérifiez les timestamps des requêtes et le statut de la réponse

Vérification des journaux Home Assistant

Si les données n'apparaissent pas dans Home Assistant :

1. Ouvrez Home Assistant
2. Allez dans Paramètres > Système > Journaux
3. Recherchez les erreurs liées à l'API REST ou aux états de capteurs
4. Vérifiez les erreurs d'authentification ou le format de données invalide

Dépannage

Problèmes courants

Erreurs d'authentification

• Vérifiez que votre Token d'accès de longue durée est correct
• Assurez-vous que l'en-tête Authorization est formaté comme : Bearer YOUR_TOKEN
• Vérifiez que le token n'a pas expiré ou été révoqué
• Vérifiez que le token a les permissions appropriées dans Home Assistant

Capteur n'apparaissant pas dans Home Assistant

• Vérifiez que le nom de l'automatisation ne contient pas de caractères spéciaux
• Vérifiez le format de l'ID d'entité : hae.{automation_name} (minuscules, sans espaces)
• Vérifiez les journaux Home Assistant pour les erreurs
• Assurez-vous que la requête API a réussi (vérifiez les Journaux d'activité)

Données ne se mettant pas à jour

• Vérifiez que l'automatisation est activée
• Consultez les Journaux d'activité pour les erreurs
• Assurez-vous de la connectivité réseau à Home Assistant

Délai d'expiration de connexion

• Vérifiez que Home Assistant est en cours d'exécution et accessible
• Vérifiez la connectivité réseau
• Augmentez le paramètre Délai d'expiration de la requête si Home Assistant répond lentement
• Vérifiez que l'URL et le port sont corrects

Messages d'erreur

L'application affichera des messages d'erreur si :

• L'URL est invalide ou inaccessible
• L'authentification échoue (vérifiez l'en-tête Authorization)
• Home Assistant renvoie un code d'état d'erreur
• La connectivité réseau n'est pas disponible

Consultez les Journaux d'activité pour des informations d'erreur détaillées, y compris les codes d'état HTTP et les messages d'erreur de Home Assistant.

Conseils d'intégration Home Assistant

Utiliser les données de santé dans les automatisations

Une fois vos données de santé synchronisées avec Home Assistant, vous pouvez les utiliser dans les automatisations :

automation:
  - alias: "Bonne qualité de sommeil"
    trigger:
      - platform: numeric_state
        entity_id: sensor.hae_myhealthdata_sleep_total
        above: 7
    action:
      - service: notify.mobile_app_your_phone
        data:
          message: "Excellent sommeil la nuit dernière !"

Créer des tableaux de bord

Ajoutez des métriques de santé à votre tableau de bord Home Assistant :

1. Allez sur votre tableau de bord
2. Ajoutez une nouvelle carte
3. Sélectionnez le type de carte "Entités" ou "Gauge"
4. Ajoutez les entités de capteurs hae.{your_automation_name}

Structure de l'état du capteur

L'état du capteur dans Home Assistant contient :

• state : La valeur ou le statut actuel
• attributes : Données supplémentaires incluant :
  • Informations de timestamp
  • Structure de données correspondant au format JSON exporté
  • Informations d'unités le cas échéant

Conseils et meilleures pratiques

1. Dénomination :

   • Évitez les caractères spéciaux qui pourraient causer des problèmes

2. Sélection des données :

   • Sélectionnez uniquement les métriques dont vous avez besoin