Integración domótica ista Web'conso (France), gratuita y de código abierto
Repartidores de calefacción y contadores de agua de ista en Francia, desde el portal Web'conso.
Publicado por guim31
- Dispositivos
- Versión 1.0.2
- Requiere Gladys >=5.1.0
- ★ 0
Trae a Gladys las lecturas que ista hace a distancia en su edificio: los repartidores de costes de calefacción de sus radiadores y, cuando el portal los proporciona, sus contadores de agua. Los datos provienen del portal de residentes de ista ista-webconso.fr («Mon espace résident»).
Sin afiliación con ista. ista y Web'conso son marcas de sus propietarios. Esta integración es un proyecto independiente.
Desarrollada sin cuenta: se agradecen sus comentarios. Nadie la ha probado todavía con una cuenta Web'conso real. Es el tipo de integración más frágil: no hay API pública, así que lee el portal como lo hace su navegador, y puede dejar de funcionar el día en que ista modifique su sitio.
Lo que obtiene
Un dispositivo, Vivienda ista, con:
| Función | Tipo en Gladys | Unidad | Qué es |
|---|---|---|---|
| Unidades de calefacción del día | Contador | ninguna | Las unidades de todos sus radiadores durante el día, ponderadas por el coeficiente de cada uno (facturadas). |
| Radiador estancia — n.º serie (cada uno) | Contador | ninguna | El índice que muestra el repartidor de ese radiador. |
| Agua fría / Agua caliente estancia (cada uno) | Volumen | m³ | El índice acumulado de ese contador. No verificado, vea las limitaciones. |
| Agua fría — total / Agua caliente — total | Volumen | m³ | La suma de los índices, cuando la vivienda tiene varios contadores de ese fluido. |
Las unidades de calefacción no tienen unidad física: un repartidor no mide energía, solo sirve para repartir la factura de calefacción del edificio entre las viviendas. Por eso se muestran como simples contadores, sin kWh.
Cada lectura está fechada en su propio día, aunque el portal la publique con varios días de retraso: los gráficos de Gladys muestran el consumo el día en que se produjo, no el día en que se leyó. Al crear el dispositivo, se le envían los últimos 7 días ya leídos.
Un widget del panel, «Consumo ista», muestra las unidades de calefacción del último día, los índices de agua, un histograma de las unidades de calefacción por día y la fecha de la última lectura.
Configuración
- Instale la integración y abra su pestaña Configuración.
- Deje Método de inicio de sesión en Correo y contraseña, e introduzca el correo y la contraseña de su espacio de residente.
- Elija el Idioma de los nombres de funciones (Gladys no comunica su idioma a una integración; los nombres quedan fijados al crear el dispositivo).
- Guarde y haga clic en Probar la conexión y leer ahora. El mensaje bajo el botón indica cuántos repartidores y contadores se han encontrado, y la fecha de la última lectura.
- Abra la pestaña Descubrir y añada el dispositivo Vivienda ista.
Cuando el correo y la contraseña no funcionan: la cookie de sesión
Si el estado indica que el portal pide un captcha o un segundo factor, o que no se reconoce la página de inicio de sesión, puede confiar a la integración la sesión de su propio navegador. Es una solución de emergencia: la sesión caduca (cuando usted cierra la sesión, o tras un tiempo de inactividad), y entonces hay que pegar una nueva.
- En un ordenador, inicie sesión en ista-webconso.fr y abra la página de consumo de su vivienda.
- Abra las herramientas de desarrollo (F12), pestaña Red, y recargue la página.
- Haga clic en una petición a
ista-webconso.fr. En Encabezados de solicitud, copie todo el valor de la línea Cookie. (O, en Aplicación / Almacenamiento → Cookies, copie el valor deJSESSIONID.) - No haga clic después en «Se déconnecter» (cerrar sesión) en el portal: eso cerraría la sesión. Simplemente cierre la pestaña.
- En Gladys: Método de inicio de sesión → Cookie de sesión (emergencia), pegue el texto en Cookie de sesión, guarde y haga clic en Probar la conexión y leer ahora.
Como cada lectura recupera los últimos 7 días, pegar una cookie nueva una vez por semana basta para mantener el historial completo.
Frecuencia de lectura del portal
El portal se lee cada 12 horas por defecto, ajustable de 3 a 24 horas (Intervalo de lectura). ista actualiza las lecturas como mucho una vez al día, y muchos edificios solo se leen una vez por semana: leer más a menudo no aporta nada y solo sobrecarga el portal. Cada lectura solo pide los días aún no leídos, una pequeña petición por día y por fluido, con una pausa entre dos.
Limitaciones
- Inicio de sesión verificado en parte. El portal envía el navegador a la
página de inicio de sesión de ista (
login.ista.com). La integración sigue los mismos pasos, y esto se ha verificado en el portal real hasta el rechazo de una cuenta inventada (sin captcha). Todavía no se ha visto un inicio de sesión correcto con una cuenta real. - Agua no verificada. La página de la calefacción se conoce gracias a un proyecto público que la leía en 2025. Las páginas del agua son una suposición: cuando el portal las rechaza, no aparece ninguna función de agua, y la prueba de conexión cuenta 0 contadores de agua. Si su agua no aparece, notifíquelo.
- Una vivienda por cuenta. Una cuenta con varias viviendas muestra sus contadores en un solo dispositivo.
- Puesta a cero de los índices. Los repartidores suelen volver a cero en la lectura anual: el gráfico del índice cae entonces, no el de las unidades del día.
- Los nombres quedan fijados al crear el dispositivo (una regla de Gladys): cambiar el nombre en el portal no cambia el de las funciones.
Solución de problemas
La pantalla Configuración muestra el estado de la conexión:
| Mensaje | Qué hacer |
|---|---|
| El portal ha rechazado el correo o la contraseña | Compruébelos iniciando sesión en ista-webconso.fr. |
| Captcha / segundo factor | Utilice el modo cookie de sesión (arriba). |
| Inicie sesión una vez en un navegador | El portal pide algo (nueva contraseña, condiciones de uso): hágalo y vuelva a probar. |
| Página de inicio de sesión no reconocida | El portal ha cambiado: utilice el modo cookie de sesión y notifíquelo. |
| La cookie de sesión ha caducado | Pegue una nueva. |
| Formato desconocido | El portal ha cambiado: notifíquelo con los registros. |
| No se puede acceder al portal de ista | Nuevo intento en la hora siguiente, no hay nada que hacer. |
Para notificar un problema, abra una incidencia en GitHub con los registros de la integración (Gladys → integración → Registros). Los registros nunca contienen su correo, su contraseña ni su cookie; cuando el portal responde en un formato desconocido, muestran su estructura (nombres de los campos, sin los valores), que es lo necesario para adaptar la integración.
Privacidad
Su correo, su contraseña o su cookie permanecen en la configuración de
Gladys. La integración guarda la sesión del portal y las lecturas recientes
en su propio volumen (/data), y solo se comunica con el portal y con la
página de inicio de sesión de ista.
Parámetros de configuración
Estos son los parámetros que ista Web'conso (France) te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Su cuenta ista Web'conso | section | No | Utilice la cuenta del portal de residentes de ista (Francia). El portal no tiene API pública: la integración inicia sesión como su navegador y puede dejar de funcionar cuando ista modifique el sitio. Sin afiliación con ista. Desarrollada sin cuenta: se agradecen sus comentarios. |
| Método de inicio de sesión | select | No | Primero correo y contraseña. Si el portal los rechaza (captcha, segundo factor), copie en su lugar una cookie de sesión desde su navegador: caduca, es una solución de emergencia. |
| Correo electrónico | string | No | El correo de su espacio de residente. |
| Contraseña | secret | No | |
| Cookie de sesión | secret | No | Solo en el modo cookie de sesión: el valor JSESSIONID, o toda la cabecera Cookie de una petición del portal. La documentación explica cómo copiarla. |
| Intervalo de lectura (horas) | number | No | Frecuencia de lectura del portal, de 3 a 24 horas. ista actualiza las lecturas como mucho una vez al día, a menudo una vez por semana: leer más a menudo solo sobrecarga el portal. |
| Idioma de los nombres de funciones | select | No | Gladys no comunica su idioma a una integración: los nombres del dispositivo y de las funciones se escriben en este, al crear el dispositivo. |
Cómo instalar ista Web'conso (France) en Gladys
- En Gladys, abre Integraciones: ista Web'conso (France) aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
- Haz clic en Instalar. Gladys descarga la imagen Docker (
ghcr.io/guim31/gladys-ista:1.0.2), la ejecuta en un entorno aislado del núcleo y genera la interfaz de la integración (dispositivos, descubrimiento y configuración). - Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
- También puedes instalarla directamente desde la URL de su repositorio: https://github.com/guim31/gladys-ista.
ista Web'conso (France) requiere Gladys >=5.1.0. El catálogo de Gladys se actualiza cada hora, así que una nueva versión está disponible como máximo una hora después de publicarse.
¿Todavía no usas Gladys? Es gratuito y de código abierto: sigue la guía de instalación para empezar.
Sobre las integraciones externas
ista Web'conso (France) es una integración externa: una integración comunitaria empaquetada como contenedor Docker y publicada en GitHub. Gladys la instala con un clic y la ejecuta en un entorno aislado del núcleo. La publica y mantiene guim31, no el equipo principal de Gladys.
- Explorar todas las integraciones externas
- Descubrir las integraciones nativas incluidas en Gladys
- Crear y publicar tu propia integración externa
- Código fuente en GitHub — fuente de esta documentación