Sincronizar datos de Apple Health con Home Assistant

Las automatizaciones de Home Assistant te permiten sincronizar automáticamente tus datos de salud con Home Assistant como estados de sensores. Esta integración te permite usar tus datos de salud en automatizaciones de Home Assistant, paneles y otras integraciones.

Resumen

Las automatizaciones de Home Assistant envían tus métricas de salud a la API REST de Home Assistant, creando o actualizando estados de sensores que se pueden usar en toda tu instancia de Home Assistant. Los datos están formateados específicamente para la API /states/ de Home Assistant.

Casos de uso:

• Mostrar métricas de salud en los paneles de Home Assistant
• Crear automatizaciones basadas en datos de salud
• Integrar datos de salud con otros dispositivos de hogar inteligente
• Rastrear tendencias de salud a lo largo del tiempo en Home Assistant

Características principales:

• Creación automática de estados de sensores
• Solo formato JSON (optimizado para Home Assistant)
• Solo tipo de datos Health Metrics
• Configuración simple de URL

Limitaciones

• Acceso a datos de salud: Las aplicaciones no pueden acceder a los datos de salud mientras el iPhone está bloqueado. Las automatizaciones solo se ejecutarán durante los períodos en que tu dispositivo esté desbloqueado. Esto puede afectar la actualidad de los datos. Consulta las instrucciones para la sincronización manual para mantener los datos actualizados.

• Procesamiento en segundo plano: iOS limita el procesamiento en segundo plano para preservar la duración de la batería. Las automatizaciones dependen de Actualización de aplicaciones en segundo plano y pueden no ejecutarse inmediatamente si:

  • La Actualización de aplicaciones en segundo plano está deshabilitada para la aplicación
  • El dispositivo está en Modo de bajo consumo
  • El dispositivo ha estado inactivo durante períodos prolongados
  • Los recursos del sistema están limitados
  • Múltiples aplicaciones están compitiendo por tiempo de ejecución en segundo plano

• Solo admite el tipo de datos Health Metrics

• Solo formato JSON (no se puede cambiar)

Requisitos previos

• Una instancia de Home Assistant en ejecución y accesible en tu red
• Token de acceso a la API de Home Assistant (Token de acceso de larga duración)
• Conectividad de red a tu instancia de Home Assistant
• Versión de Home Assistant que admita la API REST

Configuración

Navega a la pantalla de Exportaciones automatizadas desde la navegación principal, luego toca "Nueva automatización" y selecciona "Home Assistant" como el Tipo de automatización.

Nombre de la automatización

Ingresa un nombre descriptivo para tu automatización. Este nombre se usará para generar el ID de entidad del sensor en Home Assistant.

Nota: El nombre de la automatización se convertirá a minúsculas con espacios eliminados para crear el ID de entidad. Por ejemplo, "Mis datos de salud" se convierte en hae.misdatosdesalud.

Notificaciones

Configura cuándo deseas recibir notificaciones:

• Notificar en actualización de caché - Recibe una notificación cuando se actualicen los datos en caché
• Notificar cuando se ejecute - Recibe una notificación cada vez que la automatización se ejecute

URL de Home Assistant

Ingresa la URL base de tu instancia de Home Assistant. Esto debe incluir el protocolo y el puerto si no estás usando el predeterminado.

URLs de ejemplo:

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

Nota: La URL debe ser accesible desde tu dispositivo. Si usas HTTPS, asegúrate de que tu certificado sea válido o agrega una excepción.

Endpoint generado automáticamente

La aplicación genera automáticamente el endpoint completo de la API basado en el nombre de tu automatización:

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

Por ejemplo, si tu URL es http://homeassistant.local:8123 y el nombre de tu automatización es "Métricas de salud", el endpoint será:

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

Este endpoint se muestra debajo del campo URL como referencia.

Tiempo de espera de la solicitud

Selecciona un intervalo de tiempo de espera para las solicitudes HTTP a Home Assistant.

Opciones de tiempo de espera disponibles:

• 60 segundos - Predeterminado, adecuado para la mayoría de las instancias de Home Assistant
• 300 segundos (5 minutos) - Para instancias de Home Assistant más lentas
• 1800 segundos (30 minutos) - Para procesamiento muy lento
• 3600 segundos (1 hora) - Tiempo de espera máximo recomendado

Encabezados HTTP

Agrega encabezados de autenticación para el acceso a la API de Home Assistant. Necesitarás agregar un encabezado Authorization con tu Token de acceso de larga duración.

Encabezado requerido:

• Authorization: Bearer YOUR_LONG_LIVED_ACCESS_TOKEN

Para obtener un Token de acceso de larga duración:

1. Abre Home Assistant
2. Ve a tu perfil (haz clic en tu nombre en la parte inferior izquierda)
3. Desplázate hacia abajo hasta "Tokens de acceso de larga duración"
4. Haz clic en "Crear token"
5. Dale un nombre (por ejemplo, "Health Auto Export")
6. Copia el token y pégalo en el campo de valor del encabezado

Encabezados opcionales:
Puedes agregar encabezados adicionales si es necesario para tu configuración de Home Assistant.

Para agregar encabezados:

1. Toca "Agregar encabezados"
2. Ingresa la clave del encabezado en el campo izquierdo
3. Ingresa el valor del encabezado en el campo derecho
4. Repite para encabezados adicionales

Importante: Cada clave de encabezado debe tener un valor correspondiente. Los encabezados vacíos se ignorarán.

Configuración del tipo de datos

Tipo de datos

Nota: Las automatizaciones de Home Assistant solo admiten el tipo de datos Health Metrics. Esta configuración no se puede cambiar y se establece automáticamente en Health Metrics.

Configuración de Health Metrics

Seleccionar Health Metrics - Elige qué métricas específicas incluir. Puedes seleccionar todas las métricas disponibles o elegir específicas.

Consejo: Seleccionar solo las métricas que necesitas puede mejorar el tiempo de procesamiento y reducir el tamaño de los datos enviados a Home Assistant.

Fuentes preferidas - Configura qué fuentes de datos tienen prioridad cuando múltiples fuentes proporcionan la misma métrica.

Configuración de exportación

Formato de exportación

Nota: Las automatizaciones de Home Assistant solo admiten formato JSON. Esta configuración no se puede cambiar y se establece automáticamente en JSON.

Versión de exportación

Nota: La versión de exportación no está disponible para las automatizaciones de Home Assistant ya que el formato está optimizado específicamente para la API de estado de Home Assistant.

Rango de fechas

Selecciona cuándo se deben exportar los datos:

• Predeterminado - Sincroniza datos del día anterior completo más datos hasta la fecha y hora actuales
• Hoy - Sincroniza todos los datos de la fecha actual hasta la hora actual
• Ayer - Sincroniza todos los datos del día anterior completo

Nota: Las automatizaciones de Home Assistant no admiten las opciones "Tiempo real", "Desde última sincronización" o "Últimos 7 días".

Resumir datos

Activa o desactiva Resumir datos para Health Metrics.

• ON - Proporciona resúmenes de datos agregados (predeterminado)
• OFF - Proporciona datos desagregados cuando es posible

Nota: Esta configuración solo se aplica al tipo de datos Health Metrics.

Agrupación por tiempo

Cuando Resumir datos está habilitado, selecciona cómo se deben agregar los datos:

• Predeterminado - Sin agregación, puntos de datos sin procesar
• Días - Agrupa datos por día (recomendado)

Frecuencia de sincronización

Configura con qué frecuencia la automatización debe sincronizar datos con Home Assistant:

Selecciona un número e intervalo.

Pruebas y verificación

Pruebas manuales

1. Toca "Exportación manual" en la pantalla de configuración de automatización
2. Selecciona un rango de fechas
3. Toca "Exportar" para enviar una solicitud de prueba
4. Verifica en Home Assistant que el estado del sensor se haya creado/actualizado

Verificación en Home Assistant

1. Abre Home Assistant
2. Ve a Herramientas de desarrollador > Estados
3. Busca hae.{your_automation_name} (minúsculas, sin espacios)
4. Verifica que el estado del sensor muestre tus datos de salud
5. Verifica la marca de tiempo "Última actualización" para confirmar sincronizaciones recientes

Ver registros de actividad

1. Toca "Ver registros de actividad" en la pantalla de configuración de automatización
2. Revisa las ejecuciones recientes de automatización
3. Verifica si hay errores o advertencias
4. Verifica las marcas de tiempo de solicitud y el estado de respuesta

Verificación de registros de Home Assistant

Si los datos no aparecen en Home Assistant:

1. Abre Home Assistant
2. Ve a Configuración > Sistema > Registros
3. Busca errores relacionados con la API REST o estados de sensores
4. Verifica errores de autenticación o formato de datos inválido

Solución de problemas

Problemas comunes

Errores de autenticación

• Verifica que tu Token de acceso de larga duración sea correcto
• Asegúrate de que el encabezado Authorization esté formateado como: Bearer YOUR_TOKEN
• Verifica que el token no haya expirado o sido revocado
• Verifica que el token tenga permisos apropiados en Home Assistant

Sensor que no aparece en Home Assistant

• Verifica que el nombre de la automatización no contenga caracteres especiales
• Verifica el formato del ID de entidad: hae.{automation_name} (minúsculas, sin espacios)
• Verifica los registros de Home Assistant para errores
• Asegúrate de que la solicitud de API fue exitosa (verifica los Registros de actividad)

Datos que no se actualizan

• Verifica que la automatización esté habilitada
• Revisa los Registros de actividad para errores
• Asegúrate de la conectividad de red a Home Assistant

Tiempo de espera de conexión

• Verifica que Home Assistant esté en ejecución y accesible
• Verifica la conectividad de red
• Aumenta la configuración de Tiempo de espera de solicitud si Home Assistant responde lentamente
• Verifica que la URL y el puerto sean correctos

Mensajes de error

La aplicación mostrará mensajes de error si:

• La URL es inválida o inaccesible
• La autenticación falla (verifica el encabezado Authorization)
• Home Assistant devuelve un código de estado de error
• La conectividad de red no está disponible

Verifica los Registros de actividad para obtener información detallada de errores, incluidos los códigos de estado HTTP y los mensajes de error de Home Assistant.

Consejos de integración con Home Assistant

Usar datos de salud en automatizaciones

Una vez que tus datos de salud estén sincronizados con Home Assistant, puedes usarlos en automatizaciones:

automation:
  - alias: "Buena calidad de sueño"
    trigger:
      - platform: numeric_state
        entity_id: sensor.hae_myhealthdata_sleep_total
        above: 7
    action:
      - service: notify.mobile_app_your_phone
        data:
          message: "¡Excelente sueño anoche!"

Crear paneles

Agrega métricas de salud a tu panel de Home Assistant:

1. Ve a tu panel
2. Agrega una nueva tarjeta
3. Selecciona el tipo de tarjeta "Entidades" o "Gauge"
4. Agrega las entidades de sensores hae.{your_automation_name}

Estructura del estado del sensor

El estado del sensor en Home Assistant contiene:

• state: El valor o estado actual
• attributes: Datos adicionales que incluyen:
  • Información de marca de tiempo
  • Estructura de datos que coincide con el formato JSON exportado
  • Información de unidades cuando corresponda

Consejos y mejores prácticas

1. Nomenclatura:

   • Evita caracteres especiales que puedan causar problemas

2. Selección de datos:

   • Selecciona solo las métricas que necesitas