Qué necesitas
- Life Dashboard 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 iPhone. Usa HTTPS. iOS solo permite
http://sin cifrar hacia una dirección IP, un nombre.localo un nombre sin punto, y pide una vez acceso a la red local: permítelo si tu n8n está en casa. - Margen para peticiones grandes. 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
cryptoen el nodo Code. n8n Cloud lo incluye. En n8n autoalojado, defineNODE_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: la app abandona un intento cuando la conexión lleva 10 segundos parada.
Configura el nodo Webhook
- Agrega un nodo Webhook. Pon HTTP Method en
POSTy elige un Path, por ejemplolife-dashboard. - 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.
- 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 enbodyy los encabezados enheaders. - Publica el workflow y copia la URL de producción. La URL de prueba solo escucha mientras el editor espera un evento de prueba. Una sincronización enviada cuando nada escucha recibe un 404, y el iPhone guarda ese payload y los siguientes en su cola hasta que la URL vuelve a responder.
En la app, toca Agregar destino en la pestaña Salud, introduce la URL de producción y toca Agregar webhook. En la hoja que se abre, toca Generar en Secreto de firma HMAC, toca Copiar secreto para el paso siguiente y después toca Guardar.

Comprueba la firma en un nodo Code
El iPhone firma exactamente igual que la app para Android: 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 sobrebodyserializado 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. - Cualquiera que pueda abrir el workflow puede leer el secreto en el código. 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. Lo que hace el iPhone con cada respuesta:
- 204. Cualquier 2xx cuenta como entregado. Los nodos que van después del nodo Respond to Webhook se ejecutan igualmente, con el mismo elemento.
- 401. No se reintenta dentro de la sincronización. El payload se queda en la cola del iPhone, los siguientes esperan detrás, y salen cuando los secretos coinciden: en la siguiente sincronización o con Reintentar ahora.
- 500. Si el workflow falla antes de que se ejecute un nodo Respond to Webhook, n8n responde 500. El iPhone lo intenta 3 veces en total, con 1 y luego 2 segundos de separación, y después guarda el payload para la siguiente sincronización.
Dos cosas cambian respecto a Android: un payload que tu workflow rechaza con 400, 413 o 422 se vuelve a ofrecer una vez al día en lugar de en cada sincronización, y un payload de más de 7 días se descarta en la siguiente entrega a la que n8n responde con un error.
Convierte el payload en filas
Después del 204, un segundo nodo Code convierte el payload en un elemento por registro. Es el mismo código que para Android:
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;
- Enviar prueba y el Ping de prueba de la configuración inicial llevan
"test": truey ningún registro, así que no se ejecuta nada después de este nodo. - En un iPhone, el
sourcede un registro es el nombre que Apple Health da a la app o al dispositivo que lo escribió, comoAlex's Apple Watch, no un nombre de paquete. A menudo incluye el nombre del propietario. - El
uuidde una noche de sueño viene de su fase más temprana, así que no cambia mientras la noche crece, y el upsert de más abajo sustituye la noche cuando vuelve más larga. Las fases de una noche llevan su propiouuidy su propiosourcedentro dedata. - Un alimento es un único registro
nutritioncon todos sus nutrientes, y con sunamecuando la app le dio uno. - Las series que pones a 1, 5 o 15 minutos o por hora en Resolución de datos llegan como intervalos sin
uuidy aquí se omiten. Para este workflow, deja todos los tipos en cada registro, que es el valor predeterminado.
Guárdalo en Postgres, sin duplicados gracias al uuid
El mismo registro puede llegar más de una vez: en cada backfill, el envío de todo tu historial anterior, y otra vez desde la cola después de una entrega que iOS cortó. 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, como la deAlex's Apple Watch, rompe la consulta. - La clave es
typemásuuid, nouuidsolo: un iPhone envía una misma muestra de energía activa tanto enactive_caloriescomo entotal_calories. - Apple Health no edita un registro en el sitio. Una edición llega como el borrado del
uuidantiguo y un registro nuevo, de lo que se ocupa el paso siguiente.
Aplica deleted_records
Un registro borrado 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 || '#'));
Los uuid de un iPhone nunca llevan un #, así que para un iPhone solo importa la primera mitad; la segunda es para las muestras de frecuencia cardíaca y de temperatura de la piel de Android, y permite que un solo workflow sirva para ambos. Un uuid borrado que no tienes no borra nada, que es lo que pide la página del payload de iOS.
Hay un caso de iPhone que la consulta anterior no cubre: un borrado de sueño nombra una fase de la noche, por su uuid en stages, no la noche. Para quitar esa fase de la noche guardada, agrega un segundo nodo Postgres con los mismos Query Parameters:
UPDATE health_records
SET data = jsonb_set(data, '{stages}', (
SELECT coalesce(jsonb_agg(s), '[]'::jsonb)
FROM jsonb_array_elements(data->'stages') AS s
WHERE s->>'uuid' IS DISTINCT FROM $2))
WHERE type = 'sleep' AND $1 = 'sleep'
AND data->'stages' @> jsonb_build_array(jsonb_build_object('uuid', $2::text));
El duration_seconds de la noche se queda como se envió. De un tipo que aparece en deletions_unavailable no se puede responder en esa sincronización: lanza un backfill desde la app para conciliarlo.
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 Apple Health cuenta como lo hace la app Salud, así que un paseo registrado por el iPhone y por el reloj cuenta una sola vez:
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. Cada payload lleva hoy y los dos días anteriores, así que la fila de hoy se actualiza con cada sincronización. En un iPhone, total_calories solo llega en los días con energía en reposo, que un iPhone sin Apple Watch no suele registrar.
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.
Un iPhone y un teléfono Android en un solo workflow
- El
sourcede nivel superior eshealthkit_iosdesde un iPhone yhealth_connectdesde Android. - La variabilidad de la frecuencia cardíaca (HRV) es SDNN desde un iPhone y RMSSD desde Android, bajo la misma clave. Guarda el
sourcede nivel superior con cada registro para que las dos queden separadas. - El
typede un entrenamiento es un nombre comorunningdesde un iPhone, y el número de Health Connect como cadena, por ejemplo"56", desde Android. - Las fases del sueño de un iPhone incluyen
in_bed, el tiempo en la cama alrededor de las fases. - El tiempo de pantalla solo viene de Android, como un payload propio.
Los pasos de registros, upsert y borrado de esta página vienen del workflow de Health Connect a n8n. Los nodos Code y el SQL se comprobaron aquí con un payload de iPhone en Node.js y Postgres, no en un n8n en marcha con un iPhone enviándole datos, así que pruébalo con Enviar prueba y Sincronizar ahora antes de confiar en él.
Limitaciones
- n8n no puede pedirle al iPhone un intervalo de fechas. Inicia un backfill en el iPhone, desde 30 días hasta Todo el historial, con Enviar historial en Qué enviar.
- iOS decide cuándo se ejecuta la app en segundo plano, así que las sincronizaciones pueden llegar más tarde de lo que dice el horario. Para una hora exacta, una automatización de Atajos ejecuta Sincronizar datos de salud.
- Como el 204 sale primero, dos payloads pueden guardarse al mismo tiempo. Los payloads llevan un
sequenceque solo aumenta; úsalo cuando el orden importe, por ejemplo paradaily_totals.
Life Dashboard para iPhone
Instala la app, pon en ella la URL de producción de tu workflow publicado y toca Ping de prueba. La referencia del payload tiene la misma comprobación con un nodo Crypto.
Consigue la app para iPhone n8n en la referencia del payload
La app de código abierto para iPhone que usa esta guía. Sin cuenta, y los datos solo van adonde tú indiques. Más sobre la app.
Preguntas frecuentes
¿Es distinto el workflow del de Android?
Solo en los detalles de esta página. El nodo Webhook, la comprobación de la firma, las respuestas y el upsert son los mismos, así que un solo workflow puede recibir los dos teléfonos. El paso adicional es el borrado de una fase del sueño, que solo envía un iPhone.
¿Funciona 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 todas las peticiones?
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.
¿Llegan a n8n los datos del Apple Watch?
Sí. El reloj escribe en Apple Health en el iPhone, y la app los envía una vez que el reloj se ha sincronizado con el iPhone. Apple Watch en Home Assistant enumera lo que suele registrar un reloj.
¿Puedo ver un payload antes de montar el workflow?
Sí. Vista previa del payload, en Qué enviar dentro de la app, muestra los últimos 7 días como un payload. En n8n, la URL de prueba con Listen for Test Event muestra una petición real en el editor.