Le point de départ est simple : les données existent sur le portail Eau du Grand Lyon, mais je voulais les retrouver directement dans mon environnement Home Assistant, avec l’historique, les statistiques et les automatisations qui vont avec.
L’intégration s’installe comme un custom component, via HACS ou manuellement, puis se configure depuis l’interface Home Assistant avec un compte client valide. Elle interroge le portail du fournisseur : elle reste donc dépendante de la disponibilité de ce service et de ses mécanismes anti-abus.
Ce qui fonctionne aujourd’hui
- détection des compteurs Téléo et standard ;
- consommations mensuelles et, lorsque le compte les expose, données journalières Téléo ;
- contrats, factures et montant TTC réel de la dernière facture lorsqu’il est fourni ;
- statistiques pour le Energy Dashboard, avec historique local persistant ;
- estimation des coûts selon plusieurs modes : dernière facture, grille 2026, tarif manuel ou entité dynamique ;
- export CSV et téléchargement du duplicata PDF quand le portail rend la facture téléchargeable ;
- ajout dynamique des nouveaux contrats sans recréer les entités existantes.
Conçu pour survivre aux pannes du portail
Le portail peut être indisponible, ralentir ou bloquer des requêtes trop fréquentes. L’intégration utilise donc un intervalle de mise à jour volontairement raisonnable, des retries avec backoff et un cache persistant hors-ligne. Si l’API ne répond plus, les dernières données connues restent disponibles dans Home Assistant et le statut passe en hors-ligne jusqu’au retour du service.
Une partie importante du travail récent a justement porté sur cette robustesse : erreurs HTTP typées, gestion du WAF, reconfiguration et réauthentification, contrats découverts dynamiquement, données optionnelles qui ne doivent pas faire tomber tout le coordinator, typage strict et tests de non-régression.
Téléo, énergie et données avancées
Avec un compteur Téléo compatible, l’intégration peut aller plus loin que le relevé mensuel : index journalier, consommation quotidienne et, en mode expérimental, certaines données horaires, le signal, l’état de pile ou l’estimation de fuite fournisseur lorsque ces champs sont réellement retournés par l’API.
Les statistiques Home Assistant permettent aussi d’alimenter l’historique de consommation d’eau et de coûts. Le cache local accumule les données dans le temps afin de ne pas dépendre uniquement de la fenêtre historique limitée du portail.
Ce qui reste volontairement indiqué comme expérimental
Tout ce qui apparaît dans le portail n’est pas garanti pour tous les comptes. Les données horaires, le signal, la batterie, les estimations de fuite fournisseur ou certaines informations de qualité de l’eau restent donc conditionnelles. Les prédictions, Eco-Score, coaching, CO₂e, calcaire ou sécheresse sont des calculs locaux indicatifs et ne sont pas présentés comme des données officielles.
Le projet reste également une intégration non officielle : une évolution du portail ou de ses endpoints peut nécessiter une adaptation. C’est précisément pour cela que le projet est encore marqué « en cours ».
État du projet
La version actuelle est la 3.5.3. Le dépôt déclare Home Assistant 2024.11.0 minimum, dispose d’une CI, d’un typage mypy strict et d’une couverture de tests supérieure à 95 % sur l’intégration. L’objectif est maintenant de continuer à durcir les cas réels tout en gardant une distinction claire entre données fournisseur, fonctionnalités conditionnelles et calculs locaux.