Centro de ayuda HealthyApps
Español (Latinoamérica)
Centro de ayuda
Sitio principal ↗

Buscar temas de ayuda

Sincronizar datos de Apple Health con Home Assistant

Integra tus datos de salud con Home Assistant.

Última actualización: 31 de octubre de 2026

En esta página
Abrir la automatizaciónNombre, estado y notificacionesConectar Home AssistantAjustes de métricas de salud
Ajustes de exportación Ajustes de exportación Intervalo de fechasAgrupación temporal
Programar recordatoriosFrecuencia de sincronización y guardarEntidades publicadasExportar datos históricos o omitidosSolución de problemas

Publica métricas de salud en Home Assistant como estados de entidad separados. Este destino solo admite métricas de salud.

Importante — limitaciones de las automatizaciones: El dispositivo debe estar desbloqueado para leer datos de salud, e iOS no garantiza ejecuciones en segundo plano a la frecuencia que elijas. Revisa las limitaciones de las automatizaciones antes de confiar en exportaciones automáticas.

Abrir la automatización

Abre Exportar → Automatizado en iPhone, o Automatizaciones en la barra lateral del iPad. Selecciona Nueva Automatización, o abre una existente para editarla.

Nombre, estado y notificaciones

Ingresa un nombre que identifique esta automatización. Activado permite ejecuciones automáticas; déjalo desactivado hasta que estés listo.

Elige las notificaciones de ejecución que quieras:

  • Notificar al actualizar la caché indica que se prepararon los datos de exportación.
  • Notificar al ejecutarse indica una publicación correcta en Home Assistant.

Permite las notificaciones cuando se te pida. Estas notificaciones informan de la actividad; no programan una ejecución.

Conectar Home Assistant

  1. Elige Home Assistant como Tipo de automatización.
  2. Ingresa la URL base de tu instancia de Home Assistant, por ejemplo http://homeassistant.local:8123.
  3. Crea un token de acceso de larga duración en tu perfil de Home Assistant.
  4. En Encabezados HTTP, agrega Authorization con el valor Bearer YOUR_LONG_LIVED_ACCESS_TOKEN.

Tu instancia de Home Assistant debe ser accesible desde el iPhone o iPad. Para HTTPS, usa un certificado en el que confíe el dispositivo.

Ajustes de métricas de salud

Abre Seleccionar métricas de salud y elige las lecturas que publicar.

Abre Orígenes preferidos para seleccionar orígenes de cada métrica. Usa Todos para todos los orígenes no excluidos, u Orígenes excluidos para ignorar un origen en esta automatización. Las exclusiones tienen prioridad, y los orígenes no seleccionados no sustituyen a un origen preferido sin datos. Selecciona Guardar para aplicar las opciones o Cancelar para descartarlas.

Ajustes de exportación

Home Assistant usa su propio formato JSON de estado de entidad; no hay elección de formato de archivo ni de versión de exportación.

Intervalo de fechas

  • Predeterminado: Incluye el día anterior y hoy hasta la hora de la ejecución.
  • Hoy: Incluye hoy hasta la hora de la ejecución.
  • Ayer: Incluye el día completo anterior.

Agrupación temporal

Elige Predeterminado para mantener las lecturas sin agrupar o Días para usar resúmenes diarios. Home Assistant no tiene el interruptor Resumir datos.

Programar recordatorios

Si quieres un aviso para desbloquear y abrir la app, activa Activar recordatorios. Elige Por hora, Todos los días o Días seleccionados y configura el minuto, la hora y los días según corresponda. Permite el acceso a notificaciones cuando se te pida; si se deniega, usa Abrir la configuración de notificaciones.

Un recordatorio no ejecuta la automatización ni confirma una sincronización correcta. Tócalo para abrir la automatización, o usa Abrir y sincronizar en la notificación para solicitar una ejecución. La automatización debe estar habilitada; un recordatorio puede aparecer incluso después de una ejecución en segundo plano correcta. Los cambios de recordatorio se aplican al guardar.

Frecuencia de sincronización y guardar

Elige un número y Minutos u Horas en Frecuencia de sincronización. Es una cadencia deseada en segundo plano, no un horario garantizado.

El dispositivo debe estar desbloqueado cuando se lean los datos de salud. Activa la Actualización en segundo plano para Health Auto Export y desactiva el modo de bajo consumo para las ejecuciones automáticas. iOS puede retrasar las ejecuciones si el dispositivo ha estado inactivo o los recursos del sistema son limitados.

Activa Activado cuando estés listo para ejecuciones automáticas y selecciona Actualizar para guardar la automatización. Puedes cargar de inmediato un intervalo de fechas con los pasos siguientes.

Entidades publicadas

Cada métrica seleccionada puede producir una o más entidades. El identificador empieza por hae., seguido del nombre de la automatización en minúsculas sin espacios, luego la métrica y cualquier nombre de componente.

Por ejemplo, una automatización llamada Health Metrics puede publicar pasos en:

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

El estado es la última lectura del día seleccionado, con atributos de unidad de medida. Métricas como la presión arterial y la frecuencia cardiaca usan entidades de componente separadas.

Cuando un día no tiene datos, totales como pasos y horas de pie publican 0. Otras lecturas, como peso o frecuencia cardiaca, no se actualizan hasta que haya datos, de modo que Home Assistant puede seguir mostrando el último valor recibido. Al principio del día, los totales pueden permanecer en 0 hasta que los datos del Apple Watch lleguen al iPhone.

Exportar datos históricos o omitidos

Usa Carga manual al configurar por primera vez la automatización para exportar datos históricos, o más adelante para cubrir fechas que la sincronización automática no alcanzó. También puedes usarla para comprobar la configuración.

  1. Abre la automatización y selecciona Carga manual en Exportar datos existentes.
  2. Establece las fechas de Inicio y Fin y selecciona Iniciar exportación.
  3. En Home Assistant, abre Herramientas para desarrolladores → Estados y busca el prefijo hae. de tu automatización.
  4. Comprueba los valores de las entidades y las horas de actualización.

Solución de problemas

  • Error de autenticación: Comprueba el token y el encabezado Authorization: Bearer ....
  • Error de conexión: Comprueba la URL base, el puerto, el acceso a la red y la confianza del certificado.
  • Faltan algunas lecturas: Revisa el día seleccionado, los orígenes y los registros de actividad. Una ejecución puede actualizar algunas entidades mientras otras fallan.

Abre la automatización y selecciona Ver registros de actividad para comprobar los pasos fallidos. Para soporte, consulta Obtener ayuda.