Skip to content

Primeros pasos ​

De la instalación a tu primer envío correcto en unos diez minutos.

1. Instala y concede acceso a Salud ​

Descarga Courier en el App Store (iOS 17 o posterior).

En el primer arranque, Courier pide acceso de solo lectura a entrenamientos y sueño. Concede las categorías que quieras que pueda ver.

iOS oculta la respuesta

Apple no permite a las apps consultar si el acceso de lectura fue concedido o denegado — una denegación se ve exactamente igual que "no hay datos". Si Courier se queda en Pendiente de imprimir, comprueba app Salud → tu perfil → Privacidad → Apps → Courier y asegúrate de que las categorías están activadas. La página La redacción → Fuente de datos de Courier enlaza directamente allí.

2. Hojea el número de hoy ​

La pestaña Hoy muestra el número actual: el sueño de anoche (fases, duración, puntuación, constantes vitales) y los entrenamientos de ayer (mapa, frecuencia cardiaca, ritmo, desnivel). Si tu iPhone acaba de sincronizarse con un Apple Watch, desliza hacia abajo para actualizar.

3. Añade tu primer suscriptor ​

Un suscriptor es un endpoint que recibe tus datos. Para una primera prueba no necesitas un servidor:

  1. Abre webhook.site en cualquier ordenador y copia tu URL única.
  2. En Courier: La redacción → Suscriptores → Añadir.
  3. Ponle un nombre (por ejemplo, Prueba), pega la URL y deja el método POST.
  4. Elige el tipo de datos que recibe este suscriptor: Entrenamiento, Sueño, Anotación o Tiempo. Elige Entrenamiento o Sueño — el que tenga datos.
  5. Guarda. La autenticación puede quedarse en Ninguna para webhook.site.

Un suscriptor recibe exactamente un tipo de datos. Para enviar entrenamientos y sueño, añade dos suscriptores (pueden compartir la misma URL).

4. Envía algo ​

Usa el botón Probar del editor de suscriptores para mandar una muestra al instante — la respuesta HTTP se muestra dentro de la app. Luego mira en webhook.site: ahí está el registro JSON canonical. Esa forma de JSON está documentada en Transformación en JavaScript — es exactamente lo que recibe tu servidor cuando no hay ningún script de transformación configurado.

Para datos reales, abre La redacción → Envío por lotes, elige un rango de fechas y envía manualmente — o simplemente espera: con el envío automático activado (el valor por defecto), el próximo entrenamiento o la próxima noche de sueño se entrega por sí solo.

5. Déjalo funcionar ​

  • Entrega en segundo plano: cuando Apple Salud recibe datos nuevos, iOS despierta brevemente a Courier y este envía automáticamente. El sistema regula los tiempos — de minutos a alrededor de una hora y, en el peor de los casos, la próxima vez que abras la app. Es una limitación de iOS, y Courier es honesto al respecto.
  • Notificaciones: La redacción → Notificaciones te permite elegir entre notificar siempre o solo fallos.
  • Fallos: todo lo que no se pueda entregar acaba en requiere atención con un motivo, a la espera de un reintento manual — nada se descarta en silencio, y nada se reintenta a tus espaldas.

6. Extras opcionales ​