Intégration domotique ista Web'conso (France), gratuite et open source
Répartiteurs de chauffage et compteurs d'eau relevés par ista, depuis le portail résident Web'conso.
Publiée par guim31
- Appareils
- Version 1.0.2
- Nécessite Gladys >=5.1.0
- ★ 0
Amène dans Gladys les relevés qu'ista fait à distance dans votre immeuble : les répartiteurs de frais de chauffage de vos radiateurs et, quand le portail les fournit, vos compteurs d'eau. Les données viennent du portail résident ista ista-webconso.fr (« Mon espace résident »).
Non affiliée à ista. ista et Web'conso sont des marques de leurs propriétaires. Cette intégration est un projet indépendant.
Développée sans compte : retours bienvenus. Personne ne l'a encore essayée sur un vrai compte Web'conso. C'est le type d'intégration le plus fragile : il n'y a pas d'API publique, elle lit donc le portail comme le fait votre navigateur, et peut cesser de fonctionner le jour où ista modifie son site.
Ce que vous obtenez
Un appareil, Logement ista, avec :
| Fonctionnalité | Type Gladys | Unité | Ce que c'est |
|---|---|---|---|
| Unités de chauffage du jour | Compteur | aucune | Les unités de tous vos radiateurs pour la journée, pondérées par le coefficient de chacun (facturées). |
| Radiateur pièce — n° série (chacun) | Compteur | aucune | L'index affiché sur le répartiteur de ce radiateur. |
| Eau froide / Eau chaude pièce (chacun) | Volume | m³ | L'index cumulé de ce compteur. Non vérifié, voir les limites. |
| Eau froide — total / Eau chaude — total | Volume | m³ | La somme des index, quand le logement a plusieurs compteurs de ce fluide. |
Les unités de chauffage n'ont pas d'unité physique : un répartiteur ne mesure pas d'énergie, il sert seulement à partager la facture de chauffage de l'immeuble entre les logements. Elles sont donc affichées comme de simples compteurs, sans kWh.
Chaque relevé est daté de son propre jour, même quand le portail le publie avec plusieurs jours de retard : les graphiques de Gladys montrent la consommation le jour où elle a eu lieu, pas le jour où elle a été lue. À la création de l'appareil, les 7 derniers jours déjà lus lui sont envoyés.
Un widget de tableau de bord, « Consommation ista », montre les unités de chauffage du dernier jour, les index d'eau, un histogramme des unités de chauffage par jour et la date du dernier relevé.
Configuration
- Installez l'intégration, ouvrez son onglet Configuration.
- Laissez Méthode de connexion sur E-mail et mot de passe, et saisissez l'e-mail et le mot de passe de votre espace résident.
- Choisissez la langue des noms de fonctionnalités (Gladys ne transmet pas votre langue à une intégration ; les noms sont figés à la création de l'appareil).
- Enregistrez, puis cliquez sur Tester la connexion et relever maintenant. Le message sous le bouton indique combien de répartiteurs et de compteurs ont été trouvés, et la date du dernier relevé.
- Ouvrez l'onglet Découverte et ajoutez l'appareil Logement ista.
Quand l'e-mail et le mot de passe ne marchent pas : le cookie de session
Si l'état indique que le portail demande un captcha ou un second facteur, ou que la page de connexion n'est pas reconnue, vous pouvez confier à l'intégration la session de votre propre navigateur. C'est une solution de repli : la session expire (quand vous vous déconnectez, ou après un temps d'inactivité), et il faut alors en coller une nouvelle.
- Sur un ordinateur, connectez-vous à ista-webconso.fr et ouvrez la page de consommation de votre logement.
- Ouvrez les outils de développement (F12), onglet Réseau, et rechargez la page.
- Cliquez sur une requête vers
ista-webconso.fr. Dans En-têtes de la requête, copiez toute la valeur de la ligne Cookie. (Ou, dans Application / Stockage → Cookies, copiez la valeur deJSESSIONID.) - Ne cliquez pas ensuite sur « Se déconnecter » dans le portail : cela fermerait la session. Fermez simplement l'onglet.
- Dans Gladys : Méthode de connexion → Cookie de session, collez le texte dans Cookie de session, enregistrez, et cliquez sur Tester la connexion et relever maintenant.
Comme chaque lecture rattrape les 7 derniers jours, coller un cookie neuf une fois par semaine suffit à garder l'historique complet.
Fréquence de lecture du portail
Le portail est lu toutes les 12 heures par défaut, réglable de 3 à 24 heures (Intervalle de relevé). ista met à jour les relevés une fois par jour au plus, et beaucoup d'immeubles ne sont relevés qu'une fois par semaine : lire plus souvent n'apporte rien et ne fait que charger le portail. Chaque lecture ne demande que les jours pas encore lus, une petite requête par jour et par fluide, avec une pause entre deux.
Limites
- Connexion vérifiée en partie. Le portail envoie le navigateur vers la
page de connexion d'ista (
login.ista.com). L'intégration suit les mêmes étapes, et cela a été vérifié sur le vrai portail jusqu'au refus d'un compte inventé (pas de captcha). Une connexion réussie avec un vrai compte n'a pas encore été vue. - Eau non vérifiée. La page du chauffage est connue grâce à un projet public qui la lisait en 2025. Les pages de l'eau sont une supposition : quand le portail les refuse, aucune fonctionnalité d'eau n'apparaît, et le test de la connexion compte 0 compteur d'eau. Si votre eau n'apparaît pas, signalez-le.
- Un logement par compte. Un compte qui a plusieurs logements montre leurs compteurs dans un seul appareil.
- Remise à zéro des index. Les répartiteurs repartent en général de zéro au relevé annuel : le graphique de l'index chute alors, pas celui des unités du jour.
- Les noms sont figés à la création de l'appareil (une règle de Gladys) : renommer dans le portail ne renomme pas les fonctionnalités.
Dépannage
L'écran Configuration affiche l'état de la connexion :
| Message | Que faire |
|---|---|
| Le portail a refusé l'e-mail ou le mot de passe | Vérifiez-les en vous connectant à ista-webconso.fr. |
| Captcha / second facteur | Utilisez le mode cookie de session (ci-dessus). |
| Connectez-vous une fois dans un navigateur | Le portail demande quelque chose (nouveau mot de passe, CGU) : faites-le, puis testez à nouveau. |
| Page de connexion non reconnue | Le portail a changé : utilisez le mode cookie de session, et signalez-le. |
| Le cookie de session a expiré | Collez-en un nouveau. |
| Format inconnu | Le portail a changé : signalez-le avec les journaux. |
| Le portail ista est injoignable | Nouvel essai dans l'heure, rien à faire. |
Pour signaler un problème, ouvrez un ticket sur GitHub avec les journaux de l'intégration (Gladys → intégration → Journaux). Les journaux ne contiennent jamais votre e-mail, votre mot de passe ni votre cookie ; quand le portail répond dans un format inconnu, ils en montrent la structure (noms des champs, sans les valeurs), c'est ce qu'il faut pour adapter l'intégration.
Confidentialité
Votre e-mail, votre mot de passe ou votre cookie restent dans la configuration
de Gladys. L'intégration garde la session du portail et les relevés récents
dans son propre volume (/data), et ne parle qu'au portail et à la page de
connexion d'ista.
Paramètres de configuration
Voici les paramètres demandés par ista Web'conso (France) dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Votre compte ista Web'conso | section | Non | Utilisez le compte du portail résident ista (France). Le portail n'a pas d'API publique : l'intégration se connecte comme votre navigateur et peut cesser de fonctionner quand ista modifie le site. Non affiliée à ista. Développée sans compte : retours bienvenus. |
| Méthode de connexion | select | Non | E-mail et mot de passe d'abord. Si le portail les refuse (captcha, second facteur), copiez plutôt un cookie de session depuis votre navigateur : il expire, c'est une solution de repli. |
string | Non | L'e-mail de votre espace résident. | |
| Mot de passe | secret | Non | |
| Cookie de session | secret | Non | Mode cookie de session seulement : la valeur JSESSIONID, ou tout l'en-tête Cookie d'une requête du portail. La documentation explique comment le copier. |
| Intervalle de relevé (heures) | number | Non | Fréquence de lecture du portail, de 3 à 24 heures. ista met à jour les relevés une fois par jour au plus, souvent une fois par semaine : lire plus souvent ne fait que charger le portail. |
| Langue des noms de fonctionnalités | select | Non | Gladys ne transmet pas votre langue à une intégration : les noms de l'appareil et des fonctionnalités sont écrits dans celle-ci, à la création de l'appareil. |
Comment installer ista Web'conso (France) dans Gladys
- Dans Gladys, ouvrez Intégrations : ista Web'conso (France) apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
- Cliquez sur Installer. Gladys télécharge l'image Docker (
ghcr.io/guim31/gladys-ista:1.0.2), la démarre dans un bac à sable isolé du cœur, et génère l'interface de l'intégration (appareils, découverte et configuration). - Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
- Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/guim31/gladys-ista.
ista Web'conso (France) nécessite Gladys >=5.1.0. Le catalogue dans Gladys se rafraîchit toutes les heures : une nouvelle version est donc disponible au plus tard une heure après sa sortie.
Vous n'utilisez pas encore Gladys ? C'est gratuit et open source : suivez le guide d'installation pour démarrer.
À propos des intégrations externes
ista Web'conso (France) est une intégration externe : une intégration communautaire empaquetée dans un conteneur Docker et publiée sur GitHub, que Gladys installe en un clic et exécute dans un bac à sable isolé de son cœur. Elle est publiée et maintenue par guim31, et non par l'équipe cœur de Gladys.
- Parcourir toutes les intégrations externes
- Découvrir les intégrations natives intégrées à Gladys
- Créer et publier votre propre intégration externe
- Code source sur GitHub — source de cette documentation