Synchroniser les données Apple Santé avec Home Assistant
Intégrez vos données de santé avec Home Assistant.
Dernière mise à jour: 31 octobre 2026
Sur cette page
Publiez des indicateurs de santé dans Home Assistant sous forme d’états d’entité séparés. Cette destination ne prend en charge que les indicateurs de santé.
Important — limitations des automatisations : Votre appareil doit être déverrouillé pour lire les données de santé, et iOS ne garantit pas les exécutions en arrière-plan à la fréquence que vous choisissez. Consultez les limitations des automatisations avant de vous fier aux exportations automatiques.
Ouvrir l’automatisation
Ouvrez Exporter → Automatisé sur iPhone, ou Automatisations dans la barre latérale de l’iPad. Sélectionnez Nouvelle automatisation, ou ouvrez une automatisation existante pour la modifier.
Nom, état et notifications
Saisissez un nom qui identifie cette automatisation. Activé autorise les exécutions automatiques ; laissez-le désactivé jusqu’à ce que vous soyez prêt.
Choisissez les notifications d’exécution que vous souhaitez :
- Notifier lors de la mise à jour du cache signale que les données d’exportation ont été préparées.
- Notifier à l’exécution signale une publication réussie dans Home Assistant.
Autorisez les notifications lorsque cela vous est demandé. Ces notifications signalent l’activité ; elles ne planifient pas une exécution.
Connecter Home Assistant
- Choisissez Home Assistant comme Type d’automatisation.
- Saisissez l’URL de base de votre instance Home Assistant, par exemple
http://homeassistant.local:8123. - Créez un jeton d’accès de longue durée dans votre profil Home Assistant.
- Dans En-têtes HTTP, ajoutez
Authorizationavec la valeurBearer YOUR_LONG_LIVED_ACCESS_TOKEN.
Votre instance Home Assistant doit être accessible depuis l’iPhone ou l’iPad. Pour HTTPS, utilisez un certificat auquel l’appareil fait confiance.
Réglages des indicateurs de santé
Ouvrez Sélectionner les indicateurs de santé et choisissez les lectures à publier.
Ouvrez Sources préférées pour sélectionner les sources de chaque indicateur. Utilisez Toutes pour toutes les sources non exclues, ou Sources exclues pour ignorer une source dans cette automatisation. Les exclusions priment, et les sources non sélectionnées ne remplacent pas une source préférée sans données. Sélectionnez Enregistrer pour appliquer les options ou Annuler pour les abandonner.
Réglages d’exportation
Home Assistant utilise son propre format JSON d’état d’entité ; il n’y a pas de choix de format de fichier ni de version d’exportation.
Plage de dates
- Par défaut : Inclut la veille et aujourd’hui jusqu’à l’heure d’exécution.
- Aujourd’hui : Inclut aujourd’hui jusqu’à l’heure d’exécution.
- Hier : Inclut la journée complète précédente.
Groupement temporel
Choisissez Par défaut pour conserver les lectures non groupées ou Jours pour utiliser des résumés quotidiens. Home Assistant n’a pas l’interrupteur Résumer les données.
Planifier des rappels
Si vous souhaitez une invite pour déverrouiller et ouvrir l’app, activez Activer les rappels. Choisissez Toutes les heures, Tous les jours ou Jours sélectionnés, puis définissez la minute, l’heure et les jours le cas échéant. Autorisez l’accès aux notifications lorsque cela vous est demandé ; si l’accès est refusé, utilisez Ouvrir les réglages de notification.
Un rappel n’exécute pas l’automatisation et ne confirme pas une synchronisation réussie. Appuyez dessus pour ouvrir l’automatisation, ou utilisez Ouvrir et synchroniser sur la notification pour demander une exécution. L’automatisation doit être activée ; un rappel peut encore apparaître après une exécution en arrière-plan réussie. Les modifications de rappel s’appliquent lorsque vous enregistrez.
Fréquence de synchronisation et enregistrement
Choisissez un nombre et Minutes ou Heures sous Fréquence de synchronisation. Il s’agit d’une cadence souhaitée en arrière-plan, pas d’un horaire garanti.
Votre appareil doit être déverrouillé lorsque les données de santé sont lues. Activez l’Actualisation en arrière-plan pour Health Auto Export et désactivez le mode Économie d’énergie pour les exécutions automatiques. iOS peut encore retarder les exécutions lorsque l’appareil a été inactif ou que les ressources système sont limitées.
Activez Activé lorsque vous êtes prêt pour les exécutions automatiques, puis sélectionnez Mettre à jour pour enregistrer l’automatisation. Vous pouvez téléverser immédiatement une plage de dates sélectionnée à l’aide des étapes ci-dessous.
Entités publiées
Chaque indicateur sélectionné peut produire une ou plusieurs entités. L’identifiant commence par hae., suivi du nom de l’automatisation en minuscules sans espaces, puis de l’indicateur et de tout nom de composant.
Par exemple, une automatisation nommée Health Metrics peut publier les pas à :
http://homeassistant.local:8123/api/states/hae.healthmetrics_step_count
L’état est la dernière lecture du jour sélectionné, avec des attributs d’unité de mesure. Des indicateurs comme la tension artérielle et la fréquence cardiaque utilisent des entités de composant séparées.
Lorsqu’un jour n’a pas de données, les totaux comme les pas et les heures debout publient 0. Les autres lectures, comme le poids ou la fréquence cardiaque, ne sont pas mises à jour tant qu’il n’y a pas de données, de sorte que Home Assistant peut continuer à afficher la dernière valeur reçue. En début de journée, les totaux peuvent rester à 0 jusqu’à ce que les données de l’Apple Watch atteignent l’iPhone.
Exporter des données historiques ou manquées
Utilisez Téléversement manuel lors de la première configuration de l’automatisation pour exporter des données historiques, ou plus tard pour couvrir les dates manquées par la synchronisation automatique. Vous pouvez aussi l’utiliser pour vérifier votre configuration.
- Ouvrez l’automatisation et sélectionnez Téléversement manuel sous Exporter les données existantes.
- Définissez les dates de Début et de Fin, puis sélectionnez Commencer l’exportation.
- Dans Home Assistant, ouvrez Outils de développement → États et recherchez le préfixe
hae.de votre automatisation. - Vérifiez les valeurs des entités et les heures de mise à jour.
Dépannage
- Erreur d’authentification : Vérifiez le jeton et l’en-tête
Authorization: Bearer .... - Erreur de connexion : Vérifiez l’URL de base, le port, l’accès réseau et la confiance du certificat.
- Certaines lectures manquent : Examinez le jour sélectionné, les sources et les journaux d’activité. Une exécution peut mettre à jour certaines entités tandis que d’autres échouent.
Ouvrez l’automatisation et sélectionnez Voir les journaux d’activité pour vérifier les étapes échouées. Pour le support, voir Obtenir de l’aide.