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

Buscar temas de ayuda

Sincronizar datos de Apple Health con MQTT

Publica datos de salud en un broker MQTT.

Última actualización: 31 de octubre de 2026

En esta página
Abrir la automatizaciónNombre, estado y notificacionesConfigurar la conexión
Ajustes del tipo de datos Ajustes del tipo de datos Métricas de saludEntrenamientos
Ajustes de exportación Ajustes de exportación Versión de exportaciónIntervalo de fechasResumir datos y agrupación temporal
Programar recordatoriosFrecuencia de sincronización y guardarExportar datos históricos o omitidosSolución de problemas

Publica exportaciones de salud como JSON en un tema de tu broker MQTT.

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 el broker.

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

Configurar la conexión

  1. Elige MQTT como Tipo de automatización.
  2. Ingresa el nombre de host o la dirección IP del broker y el puerto. El puerto predeterminado es 1883.
  3. Ingresa el Tema, por ejemplo health/metrics.
  4. Establece un ID de cliente único para cada automatización e ingresa un nombre de usuario y una contraseña si el broker lo requiere.

El broker debe ser accesible desde tu dispositivo. Los suscriptores deben usar el tema exacto, incluidas las mayúsculas. Reutilizar un ID de cliente puede hacer que las conexiones del broker se sustituyan entre sí.

Ajustes del tipo de datos

Selecciona un Tipo de datos para esta automatización: Métricas de salud, Entrenamientos, Síntomas, ECG, Notificaciones de frecuencia cardiaca, Estado de ánimo, Seguimiento del ciclo o Medicamentos. Estado de ánimo requiere iOS 18 o posterior; Medicamentos requiere iOS 26 o posterior y acceso aparte a medicamentos.

Métricas de salud

Elige Métricas de salud, abre Seleccionar métricas de salud y selecciona las mediciones que necesites.

Para limitar las lecturas a apps o dispositivos concretos, abre Orígenes preferidos, elige una métrica y selecciona sus orígenes. Todos permite todos los orígenes que no se hayan excluido. Usa Orígenes excluidos para ignorar un origen en las métricas de salud de esta automatización. Las exclusiones tienen prioridad; no se sustituye un origen no seleccionado cuando el preferido no tiene datos. Selecciona Guardar para aplicar las opciones de origen o Cancelar para descartarlas.

Entrenamientos

Elige Entrenamientos para exportar registros de entrenamiento. Incluir datos de ruta agrega los puntos de ruta disponibles a los datos JSON del entrenamiento. No crea cargas GPX independientes.

Para la Versión 2, activa Incluir métricas del entrenamiento para agregar lecturas como frecuencia cardiaca, energía activa y pasos. Elige Minutos o Segundos para la Agrupación temporal de métricas del entrenamiento; los segundos producen más detalle y exportaciones más grandes. La Versión 1 siempre incluye métricas del entrenamiento.

Ajustes de exportación

MQTT publica solo JSON. Los mensajes usan QoS 0 para la publicación en primer plano y QoS 1 para la publicación en segundo plano. Los mensajes no se retienen.

Versión de exportación

Elige Versión 2 para la estructura de datos actual. Usa Versión 1 cuando un flujo existente dependa del formato anterior.

Intervalo de fechas

Selección Datos incluidos
Predeterminado El día anterior y hoy hasta la hora de la ejecución
Desde la última sincronización Desde la sincronización anterior hasta la hora de la ejecución
Hoy Hoy hasta la hora de la ejecución
Ayer El día completo anterior
Últimos 7 días Los siete días completos anteriores

Resumir datos y agrupación temporal

Para JSON + Métricas de salud, activa Resumir datos para combinar lecturas en grupos temporales, o desactívalo para lecturas individuales cuando estén disponibles. El resumen depende de la métrica—por ejemplo, los pasos se suman y las lecturas de peso se promedian. Las exportaciones CSV de métricas de salud usan datos resumidos.

Cuando esté disponible Agrupación temporal, elige cuánto detalle conservar. Los grupos por hora o por día producen menos filas que los de minuto o segundo. Las opciones disponibles dependen del intervalo de fechas y del formato. La agrupación temporal de entrenamientos se configura por separado en Entrenamientos.

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, Horas, Días o Semanas en Frecuencia de sincronización—por ejemplo, cada 15 minutos. 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.

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. Conecta un suscriptor MQTT a tu broker y suscríbete al tema configurado.
  2. En Health Auto Export, abre la automatización y selecciona Carga manual en Exportar datos existentes.
  3. Establece las fechas de Inicio y Fin y selecciona Iniciar exportación.
  4. Comprueba el JSON recibido y sus fechas.

La carga útil sigue el formato de exportación JSON. Por ejemplo:

{
  "data": {
    "metrics": [
      {
        "name": "step_count",
        "units": "count",
        "data": [{"date": "2024-02-06 00:00:00 -0800", "qty": 8500}]
      }
    ]
  }
}

Solución de problemas

  • Error de conexión: Comprueba el host, el puerto, el acceso a la red y los requisitos de conexión del broker.
  • Error de autenticación: Comprueba las credenciales y el permiso para publicar en el tema.
  • Ningún mensaje: Confirma que el suscriptor usa el mismo broker y el tema exacto, y revisa los registros de actividad.
  • Mensaje demasiado grande: Selecciona menos métricas, un intervalo más corto o una agrupación temporal más gruesa.

Abre la automatización y selecciona Ver registros de actividad para revisar una ejecución. Las advertencias señalan posibles problemas como una recuperación de datos lenta; los errores identifican pasos fallidos. Para ayuda al informar de un problema, consulta Obtener ayuda.