Integración externa - Withings

Desarrollo
1

¡Hola a todos :waving_hand:

Os presento una nueva integración externa Withings para Gladys. Recupera los datos de vuestras balanzas, tensiómetros, relojes y analizadores de sueño Withings, y los hace utilizables en los paneles y las escenas.

Qué hace

Un dispositivo « Withings health » que agrupa vuestros datos:

  • peso y composición corporal (grasa, músculos, huesos, agua, grasa visceral);
  • presión arterial y pulso;
  • oxígeno en sangre (SpO2), temperatura corporal;
  • pasos, distancia, desnivel y calorías del día;
  • sueño de la última noche (duración, sueño profundo / ligero / REM, puntuación, despertares);
  • estado « en la cama » con un Sleep Analyzer.

Las funcionalidades se adaptan a lo que realmente medís: con solo un tensiómetro, no tendréis veinte casillas vacías de composición corporal.

Cada medida se registra en su fecha real: un peso sincronizado una hora más tarde se coloca en el momento correcto en el historial.

Un dispositivo por dispositivo Withings con pilas, con una alerta « Batería baja ».

Escenas (Gladys 5.1+)

Disparadores:

  • Nueva medida Withings (filtrable: peso, presión, temperatura, oxígeno…);
  • Acostado / Levantado (Sleep Analyzer);
  • Resumen de la noche disponible;
  • Objetivo de pasos alcanzado (una vez al día, objetivo ajustable).

Acciones:

  • Actualizar los datos Withings;
  • Leer el último valor Withings (peso, presión, sueño…), para usarlo en el resto de la escena.

Ejemplo: cuando llega un peso, enviarme « Peso: {{triggerEvent.data.weight}} kg ».

Widgets del panel

  • Salud Withings: peso, pasos, sueño, presión en directo, última medida, estado de las pilas y un botón « Actualizar »;
  • Evolución del peso: la curva en una semana, un mes, tres meses o un año.

Tiempo real con Gladys Plus

  • Sin Gladys Plus: Withings se lee cada 30 minutos (ajustable de 5 min a 24 h).
  • Con Gladys Plus: Withings avisa a Gladys tan pronto como llega un dato, las medidas están ahí en unos segundos. Los eventos « Acostado / Levantado » del Sleep Analyzer solo funcionan con Gladys Plus.

Qué necesitas

  • Gladys 5.1 o más reciente;
  • una cuenta Withings, con vuestros dispositivos sincronizados en la aplicación Withings;
  • una aplicación desarrollador Withings (gratuita, 5 minutos para crear en developer.withings.com). Proporciona el Client ID y el Client secret para pegar en Gladys.

Instalación en breve

  1. Crea tu aplicación en developer.withings.com (tipo Public API integration).
  2. Pega el Client ID y el Client secret en la configuración de la integración, luego guarda.
  3. Haz clic en Conectar. La primera vez, Withings rechaza la dirección de retorno: es normal. Haz clic en Probar la conexión, copia la URL mostrada y añádela en tu aplicación Withings.
  4. Haz clic de nuevo en Conectar. Los dispositivos aparecen en la pestaña Descubrimiento.

La documentación paso a paso (FR, EN, DE, ES) está aquí: gladys-withings/docs/fr.md at main · prohand/gladys-withings · GitHub

Privacidad

  • Los datos van del cloud Withings directamente a tu Gladys, a través de tu aplicación desarrollador.
  • Gladys Plus solo reenvía las notificaciones « nuevo dato », sin ninguna medida dentro.
  • El Client secret y los tokens nunca se muestran ni se escriben en los registros.

Enlaces

Es una primera versión: vuestros comentarios son bienvenidos, especialmente si tenéis dispositivos que no he podido probar (Body Scan, ScanWatch, Thermo, BPM Core…). ¡No dudéis en compartir vuestras escenas! :slightly_smiling_face: