Intégration externe - Withings

Développement
1

Bonjour à tous :waving_hand:

Je vous présente une nouvelle intégration externe Withings pour Gladys. Elle récupère les données de vos balances, tensiomètres, montres et Sleep Analyzer Withings, et les rend utilisables dans les tableaux de bord et les scènes.

Ce qu’elle fait

Un appareil « Withings health » qui regroupe vos données :

  • poids et composition du corps (masse grasse, muscles, os, eau, graisse viscérale) ;
  • tension artérielle et pouls ;
  • oxygène sanguin (SpO2), température corporelle ;
  • pas, distance, dénivelé et calories du jour ;
  • sommeil de la dernière nuit (durée, sommeil profond / léger / paradoxal, score, réveils) ;
  • état « au lit » avec un Sleep Analyzer.

Les fonctionnalités s’adaptent à ce que vous mesurez vraiment : avec seulement un tensiomètre, vous n’aurez pas vingt cases vides de composition corporelle.

Chaque mesure est enregistrée à sa vraie date : une pesée synchronisée une heure plus tard est placée au bon moment dans l’historique.

Un appareil par appareil Withings à piles, avec une alerte « Batterie faible ».

Scènes (Gladys 5.1+)

Déclencheurs :

  • Nouvelle mesure Withings (filtrable : pesée, tension, température, oxygène…) ;
  • Couché / Levé (Sleep Analyzer) ;
  • Résumé de la nuit disponible ;
  • Objectif de pas atteint (une fois par jour, objectif réglable).

Actions :

  • Actualiser les données Withings ;
  • Lire la dernière valeur Withings (poids, tension, sommeil…), pour l’utiliser dans la suite de la scène.

Exemple : quand une pesée arrive, m’envoyer « Poids : {{triggerEvent.data.weight}} kg ».

Widgets du tableau de bord

  • Santé Withings : poids, pas, sommeil, tension en direct, dernière mesure, état des piles et un bouton « Actualiser » ;
  • Évolution du poids : la courbe sur une semaine, un mois, trois mois ou un an.

Temps réel avec Gladys Plus

  • Sans Gladys Plus : Withings est lu toutes les 30 minutes (réglable de 5 min à 24 h).
  • Avec Gladys Plus : Withings prévient Gladys dès qu’une donnée arrive, les mesures sont là en quelques secondes. Les événements « Couché / Levé » du Sleep Analyzer ne fonctionnent qu’avec Gladys Plus.

Ce qu’il faut

  • Gladys 5.1 ou plus récent ;
  • un compte Withings, avec vos appareils synchronisés dans l’application Withings ;
  • une application développeur Withings (gratuite, 5 minutes à créer sur developer.withings.com). Elle fournit le Client ID et le Client secret à coller dans Gladys.

Installation en bref

  1. Créez votre application sur developer.withings.com (type Public API integration).
  2. Collez le Client ID et le Client secret dans la configuration de l’intégration, puis enregistrez.
  3. Cliquez sur Connecter. La première fois, Withings refuse l’adresse de retour : c’est normal. Cliquez sur Tester la connexion, copiez l’URL affichée et ajoutez-la dans votre application Withings.
  4. Cliquez à nouveau sur Connecter. Les appareils apparaissent dans l’onglet Découverte.

La doc pas à pas (FR, EN, DE, ES) est ici : gladys-withings/docs/fr.md at main · prohand/gladys-withings · GitHub

Vie privée

  • Les données vont du cloud Withings directement à votre Gladys, via votre application développeur.
  • Gladys Plus relaie seulement les notifications « nouvelle donnée », sans aucune mesure dedans.
  • Le Client secret et les jetons ne sont jamais affichés ni écrits dans les journaux.

Liens

C’est une première version : vos retours sont les bienvenus, surtout si vous avez des appareils que je n’ai pas pu essayer (Body Scan, ScanWatch, Thermo, BPM Core…). N’hésitez pas à partager vos scènes ! :slightly_smiling_face: