¿Cómo llevo los datos de Health Connect a n8n?

Instala Life Dashboard para Android, una app de código abierto, e introduce como webhook la URL de producción de un nodo Webhook de n8n. En n8n, activa la opción Raw Body del nodo Webhook, comprueba el HMAC de X-Signature en un nodo Code, responde 204 con un nodo Respond to Webhook y después guarda cada registro con su type y su uuid como clave. Los datos de Samsung Health, Garmin Connect, Google Health, Oura y Withings llegan así a n8n, porque esas apps los escriben en Health Connect en el teléfono.

La app para iPhone envía los datos de Apple Health en el mismo formato, así que un solo workflow recibe los dos teléfonos. Esta página cubre la parte de n8n. El payload en sí, los reintentos y la cola de salida están en Health Connect a un webhook.

Reloj o anilloSu appHealth ConnectApp Life Dashboardn8n

Por Owen Vogelaar, que mantiene Life Dashboard 11 min de lectura

Consigue la app para Android

Qué necesitas

  • Life Dashboard para Android con Android 9 o posterior y Health Connect. Está en Google Play por 4,99 € (4,99 USD), pago único, sin suscripción: la forma más cómoda, con actualizaciones automáticas, y al comprarla apoyas el desarrollo. Las vías gratuitas instalan la misma app con la misma clave de firma: el APK firmado de GitHub, Obtainium, que mantiene ese APK actualizado, y F‑Droid, que la compila a partir del código fuente.
  • O la app para iPhone con iOS 17 o posterior. Está en App Store por 6,99 € (5,99 USD), pago único, sin suscripción. Compilarla a partir del código fuente con Xcode no cuesta nada más si ya tienes una suscripción al Apple Developer Program.
  • n8n, en n8n Cloud o autoalojado, accesible desde el teléfono. Usa HTTPS. Para HTTP sin cifrar en tu propia red hay que activar Permitir webhooks con HTTP sin cifrar en Más > Avanzado en la app para Android; la app para iPhone solo permite HTTP sin cifrar hacia una dirección IP, un nombre .local o un nombre sin punto.
  • Margen para peticiones grandes. Permite al menos 10 MB por petición. n8n acepta hasta 16 MB de forma predeterminada, pero un proxy inverso delante de él también tiene que permitirlo: nginx permite 1 MB de forma predeterminada.
  • El módulo crypto en el nodo Code. n8n Cloud lo incluye. En n8n autoalojado, define NODE_FUNCTION_ALLOW_BUILTIN=crypto, en el task runner si usas uno.

El workflow de un vistazo

Webhook (POST, Raw Body)
  -> Code: check signature
  -> If: valid is true
       true  -> Respond to Webhook (204)
                  -> Code: records    -> Postgres: upsert
                  -> Code: deletions  -> Postgres: delete
       false -> Respond to Webhook (401)

La respuesta sale antes del trabajo con la base de datos, porque la app espera una respuesta 10 segundos como máximo.

Configura el nodo Webhook

  1. Agrega un nodo Webhook. Pon HTTP Method en POST y elige un Path, por ejemplo life-dashboard.
  2. Pon Respond en Using 'Respond to Webhook' Node. Con Immediately, n8n responde 200 antes de que se compruebe la firma, así que un payload con una firma incorrecta cuenta igualmente como entregado.
  3. En Options, agrega Raw Body y actívalo. El nodo entrega entonces los bytes tal como llegaron en la propiedad binaria data, junto al JSON ya interpretado en body y los encabezados en headers.
  4. Publica el workflow y copia la URL de producción. La URL de prueba solo escucha mientras el editor espera un evento de prueba, y la URL de producción solo funciona mientras el workflow está publicado. Una sincronización enviada en otro momento recibe un 404, y la app guarda ese payload y los siguientes hasta que la URL vuelve a responder.

En la app, toca Agregar destino (si aún no hay nada configurado, Usar tu propio servidor) en la pestaña Salud, pega la URL de producción en URL del webhook y toca Agregar webhook. En la página que se abre, toca Generar en Secreto de firma HMAC (opcional), copia el secreto con Copiar secreto para el paso siguiente y toca Guardar.

Un destino de webhook en la app para Android, con su secreto de firma HMAC y sus encabezados

Comprueba la firma en un nodo Code

Cada petición lleva X-Signature: sha256=<hex>, el HMAC-SHA256 del cuerpo en bruto con tu secreto como clave. Agrega un nodo Code en JavaScript, en el modo Run Once for All Items:

const crypto = require('crypto');

// The secret as the app shows it. Use it as text: don't hex-decode it.
const SECRET = 'paste-the-secret-from-the-app';

const item = $input.first();
const raw = await this.helpers.getBinaryDataBuffer(0, 'data');
const expected = Buffer.from(
  'sha256=' + crypto.createHmac('sha256', SECRET).update(raw).digest('hex')
);
const presented = Buffer.from(item.json.headers['x-signature'] || '');
const valid = presented.length === expected.length &&
  crypto.timingSafeEqual(presented, expected);

return [{ json: { valid, payload: valid ? JSON.parse(raw.toString('utf8')) : null } }];
  • El HMAC se calcula sobre raw, los bytes que firmó la app. Calcularlo sobre body serializado de nuevo da una cadena distinta, y la comprobación falla.
  • n8n entrega los nombres de los encabezados en minúsculas, así que el encabezado es x-signature.
  • timingSafeEqual compara en tiempo constante y lanza un error con entradas de longitudes distintas, así que la comprobación de la longitud va primero.
  • Cualquiera que pueda abrir el workflow puede leer el secreto en el código. Si eso importa, la referencia del payload muestra la misma comprobación con un nodo Crypto, que guarda el secreto en una credencial de n8n.

Después agrega un nodo If con una sola condición: el booleano {{ $json.valid }} es verdadero.

Responde antes de la parte lenta

Termina cada rama del nodo If en su propio nodo Respond to Webhook, con Respond With en No Data. En Options, pon Response Code en 204 en la rama true y en 401 en la rama false.

  • 204. La app cuenta cualquier 2xx como entregado. Los nodos que van después del nodo Respond to Webhook se ejecutan igualmente, con el mismo elemento.
  • 401. La app no lo reintenta. Guarda el payload, y los siguientes, en su cola de salida y los entrega cuando los secretos coinciden.
  • 500. Si el workflow falla antes de que se ejecute un nodo Respond to Webhook, n8n responde 500. La app lo intenta 3 veces en total y después guarda el payload para la siguiente sincronización.

Convierte el payload en filas

Después del 204, un segundo nodo Code convierte el payload en un elemento por registro:

const p = $input.first().json.payload;
if (!p || p.test) return [];

const rows = [];
for (const [type, value] of Object.entries(p)) {
  if (type === 'deleted_records' || !Array.isArray(value)) continue;
  for (const r of value) {
    if (!r || !r.uuid) continue; // daily totals and buckets carry no uuid
    rows.push({ json: {
      type,
      uuid: r.uuid,
      source: r.source ?? null,
      time: r.time ?? r.start_time ?? r.session_end_time ?? null,
      data: r,
    } });
  }
}
return rows;

Un Enviar prueba desde la app no da ninguna fila, así que no se ejecuta nada después de este nodo. Las series que pones a 1, 5 o 15 minutos o por hora en Resolución de datos llegan como intervalos sin uuid y aquí se omiten: para este workflow, deja Resolución de datos en cada registro, o guarda los intervalos en una tabla propia con la serie y bucket_start como clave.

Guárdalo en Postgres, sin duplicados gracias al uuid

El mismo registro puede llegar más de una vez: después de un reintento, cuando su fuente lo edita y en cada backfill, el envío de todo tu historial anterior. Usa como clave de la tabla type y uuid, ambos como text:

CREATE TABLE health_records (
  type   text NOT NULL,
  uuid   text NOT NULL,
  source text,
  time   timestamptz,
  data   jsonb NOT NULL,
  PRIMARY KEY (type, uuid)
);

Agrega un nodo Postgres con la operación Execute Query:

INSERT INTO health_records (type, uuid, source, time, data)
VALUES ($1, $2, $3, $4::timestamptz, $5::jsonb)
ON CONFLICT (type, uuid) DO UPDATE
SET source = EXCLUDED.source, time = EXCLUDED.time, data = EXCLUDED.data;

En Options, agrega Query Parameters con esta expresión:

{{ [ $json.type, $json.uuid, $json.source, $json.time, JSON.stringify($json.data) ] }}
  • Pasa los valores como Query Parameters, nunca como {{ }} dentro del SQL. n8n pega una expresión en el SQL como texto sin más, así que una comilla en un valor rompe la consulta.
  • La clave es type más uuid, no uuid solo. Las muestras de frecuencia cardíaca y de temperatura de la piel tienen un uuid como <record id>#<epoch ms>, y un iPhone envía una misma muestra de energía activa tanto en active_calories como en total_calories.
  • Desde Android, un registro editado llega con el mismo uuid y valores nuevos, y el upsert sustituye la fila antigua. Apple Health no edita en el sitio: una edición llega como un borrado y un registro nuevo.

Aplica deleted_records

Un registro borrado en Health Connect o en Apple Health aparece en el deleted_records de un payload posterior, con su type y su uuid. Un tercer nodo Code, también después del 204:

const p = $input.first().json.payload;
return (p?.deleted_records ?? []).map(d => ({ json: { type: d.type, uuid: d.uuid } }));

Después, un nodo Postgres con Execute Query y los Query Parameters {{ [ $json.type, $json.uuid ] }}:

DELETE FROM health_records
WHERE type = $1 AND (uuid = $2 OR starts_with(uuid, $2 || '#'));

La segunda mitad borra las muestras de un registro de frecuencia cardíaca o de temperatura de la piel de Android. Desde un iPhone, un borrado de sueño nombra una fase de la noche, no la noche, así que esta consulta deja la noche donde está. De un tipo que aparece en deletions_unavailable no se puede responder en esa sincronización: lanza un backfill desde la app para conciliarlo.

Una vez que los registros están en Postgres, un modelo puede leerlos mediante un rol de solo lectura y un servidor MCP: Health Connect y Apple Health por MCP explica esa ruta. Si prefieres no montar el almacenamiento tú mismo, el receptor de el stack Life Dashboard elimina duplicados y borra de la misma manera, con dashboards, una API de solo lectura y un servidor MCP encima.

Google Sheets o Telegram como alternativa

Una fila por día en Google Sheets. Un nodo Code después del 204 toma los totales diarios, que cuentan un paseo una sola vez aunque lo hayan registrado tanto el teléfono como el reloj:

const p = $input.first().json.payload;
return (p?.daily_totals ?? []).map(d => ({ json: d }));

Después, un nodo Google Sheets con Append or Update Row, una hoja con las columnas date, steps, distance_meters, active_calories y total_calories, y date como la columna de coincidencia. La fila de hoy es un total acumulado y se actualiza con cada sincronización. En un día sin datos de un tipo, su campo no aparece.

Un mensaje de Telegram por cada peso nuevo. Después del nodo de registros, un nodo Filter conserva los elementos en los que {{ $json.type }} es weight. Un nodo Remove Duplicates con Remove Items Processed in Previous Executions, Keep Items Where en Value Is New y {{ $json.uuid }} como el valor con el que detectar duplicados evita un segundo mensaje cuando el mismo pesaje vuelve a llegar en un backfill. Después, un nodo Telegram con Send Message y el texto Weight: {{ $json.data.kilograms }} kg.

Samsung Health, Garmin y Apple Health en un solo workflow

  • El source de cada registro es el nombre de paquete de la app que lo escribió, como com.sec.android.app.shealth para Samsung Health, com.garmin.android.apps.connectmobile para Garmin Connect o com.fitbit.FitbitMobile para Google Health. Filtra por él para encaminar una sola marca.
  • El source de nivel superior es health_connect desde Android y healthkit_ios desde un iPhone. En un iPhone, el source de un registro es el nombre que Apple Health da a la app o al dispositivo.
  • La variabilidad de la frecuencia cardíaca (HRV) es RMSSD desde Android y SDNN desde un iPhone, bajo la misma clave. Si los dos teléfonos envían a este workflow, guarda el source de nivel superior con cada registro para que las dos queden separadas.
  • Qué tipos escribe cada app, y cuáles se guarda, está en Tipos de datos de Health Connect, app por app.

Limitaciones

  • n8n no puede pedirle al teléfono un intervalo de fechas. Inicia un backfill en el teléfono, desde 30 días hasta Todo el historial, con Enviar historial, en Qué enviar dentro de la pestaña Salud.
  • Como el 204 sale primero, dos payloads pueden guardarse al mismo tiempo. Los payloads llevan además un sequence que solo aumenta: Health Connect a un webhook explica cómo usarlo cuando el orden importa, por ejemplo para daily_totals.
  • El tiempo de pantalla llega como un payload propio con "source": "screen_time", desde las URL de la pestaña Tiempo de pantalla. No tiene uuid de registro, así que el nodo de registros de arriba lo omite.

Life Dashboard

Instala la app, pon en ella la URL de producción de tu workflow publicado y toca Enviar prueba. La referencia del payload tiene la misma comprobación con un nodo Crypto.

Disponible en Google Play

4,99 €, pago único, en Google Play: la forma más cómoda, con actualizaciones automáticas, y así apoyas el desarrollo.

O gratis, la misma app con la misma clave de firma: APK en GitHub · Obtainium · F‑Droid

Descárgala en App Store

6,99 €, pago único, en App Store, sin suscripción.

Compilar con Xcode

Consigue la app para Android n8n en la referencia del payload

Las apps de código abierto que usa esta guía, para Android y iPhone. Sin cuenta y sin nube. Más sobre Android y iPhone.

Preguntas frecuentes

¿Funciona esto en n8n Cloud?

Sí. La URL de producción de un workflow publicado es HTTPS pública, y n8n Cloud ofrece el módulo crypto al nodo Code. n8n autoalojado necesita NODE_FUNCTION_ALLOW_BUILTIN=crypto para el mismo código.

¿Por qué falla la comprobación de la firma en cada petición?

Normalmente por una de tres cosas: Raw Body está desactivado, así que no hay ningún data binario sobre el que calcular el hash; el HMAC se calcula sobre el body interpretado en lugar de sobre los bytes en bruto; o el secreto de n8n es distinto del de la app. Copia el secreto otra vez y úsalo como texto sin más.

¿Puedo prescindir de la firma?

Sí. Sin un secreto, la app no envía ningún X-Signature. Protege la URL de otra forma, por ejemplo con Header Auth en el nodo Webhook y el mismo encabezado en Encabezados, en la página de esa dirección dentro de la app.

¿Llegan a n8n los datos de Samsung Health?

Sí, una vez que Samsung Health los comparte con Health Connect: pasos, ejercicio, sueño con sus fases, frecuencia cardíaca, presión arterial, peso y más. Samsung Health no comparte con Health Connect la variabilidad de la frecuencia cardíaca ni la frecuencia cardíaca en reposo, así que esas no llegan.

¿Puedo ver un payload antes de construir el workflow?

Sí. Vista previa del payload, en Qué enviar dentro de la pestaña Salud de la app, muestra lo que enviaría la siguiente sincronización. En n8n, la URL de prueba con Listen for Test Event muestra una petición real en el editor.