Integración domótica Veolia, gratuita y de código abierto
Su consumo de agua desde su área de cliente de Veolia (eau.veolia.fr).
Publicado por prohand
- Dispositivos
- Versión 1.1.1
- Requiere Gladys >=5.1.0
- ★ 0
Esta integración lee su consumo de agua desde su área de cliente de Veolia (eau.veolia.fr) y lo lleva a Gladys: un dispositivo «contador de agua», un widget para el panel y tarjetas para sus escenas.
Qué necesita
- Un contador de agua con telelectura (télérelève): envía su consumo a Veolia todos los días. Sin él, Veolia solo tiene una lectura al año.
- Un área de cliente de Veolia con un e-mail y una contraseña. Compruebe que la web de Veolia muestra su consumo día a día.
- Gladys 5.1 o posterior.
¿Veolia abastece su municipio? En la pestaña Configuración, use el botón Comprobar mi municipio con su código postal. Por ejemplo, Metz (57000) responde «Compatible, portal eau.veolia.fr».
Configuración
- Abra la pestaña Configuración de la integración.
- Introduzca el e-mail y la contraseña de su área de cliente.
- Área de cliente: deje
eau.veolia.fr, salvo que Comprobar mi municipio indique otro portal (Eau de Toulouse Métropole). - Ajustes opcionales:
- Intervalo de actualización (6 h por defecto): Veolia publica una lectura al día, un intervalo corto no aporta nada;
- Umbral de consumo alto (L/día): 0 = desactivado. A partir de él, se lanza el activador Consumo de agua alto;
- Lectura ausente tras (3 días por defecto): plazo antes del activador Lectura de agua atrasada.
- Pulse Guardar configuración y luego Probar la conexión: la respuesta muestra su contador y su última lectura.
- Abra la pestaña Descubrir y añada el contador de agua con Añadir a Gladys.
Una vez añadido el dispositivo, el historial conocido (el mes actual y el anterior) se envía a Gladys, fechado en el día de cada lectura.
Después, la integración recupera de Veolia los 24 meses anteriores, también fechados en su día, para que los gráficos de Gladys puedan mostrar los años pasados. La importación se ejecuta en segundo plano, un mes cada 20 segundos (unos 8 minutos). No hay que proporcionar ningún archivo: Veolia conserva el historial. Si Gladys borra los estados antiguos (el ajuste Conservar el historial de estados de los dispositivos en Configuración → Sistema), elija al menos 2 años para conservarlos.
El dispositivo «Contador de agua»
| Valor | Unidad | Significado |
|---|---|---|
| Index | m³ | Índice del contador en la última lectura |
| Consommation journalière | L | Litros consumidos cada día, guardados en su día |
| Consommation du mois | m³ | Total del mes en curso |
| Consommation de l'année | m³ | Total del año natural en curso |
La tarjeta del dispositivo lleva la insignia Nube mientras el portal de Veolia responde, Inaccesible cuando no responde, con un punto naranja cuando no ha llegado ninguna lectura en el plazo «Lectura ausente tras». No hay modo local: los datos solo existen en Veolia.
Conviene saberlo: Veolia publica una lectura con 1 a 3 días de retraso. Es normal no ver el consumo de ayer.
Panel
Añada el widget Consumo de agua (Panel → Editar → Nuevo widget): último día, mes, año, índice, un gráfico diario (7, 14 o 30 días, a elegir en el widget), la fecha y la fiabilidad de la última lectura (medida o estimada) y un botón Actualizar. Con varios contadores, elija uno en los ajustes del widget.
El widget Agua: comparación anual muestra el consumo de cada mes de los últimos 3 años uno al lado del otro, el total de cada año y la variación respecto al año anterior en el mismo periodo (de enero al último mes completo). Sus cifras vienen directamente de Veolia: funciona aunque Gladys no haya conservado el historial.
Escenas
La integración añade sus tarjetas al editor de escenas, en Integraciones (Activador de integración y Acción de integración).
Activadores:
- Nueva lectura de agua — Veolia ha publicado un nuevo día. Variables:
{{triggerEvent.data.date}},{{triggerEvent.data.liters}},{{triggerEvent.data.index_m3}}. - Consumo de agua alto — un día ha alcanzado el umbral que ha fijado
(posible fuga). Variables:
date,liters,threshold_liters. - Lectura de agua atrasada — ninguna lectura nueva desde el número de días
que ha fijado (contador o portal caído). Variables:
last_date,days.
Acciones:
- Actualizar el consumo de agua — lee Veolia ahora y devuelve la lectura más
reciente (
date,liters,index_m3). - Obtener el consumo de agua — devuelve el consumo de un periodo (último día leído, este mes, el mes pasado, este año) en litros y m³, para un mensaje o una condición.
Ejemplo: «cada día 1 del mes a las 9:00, obtener el consumo del mes pasado y enviarme: El mes pasado: {{…cubic_meters}} m³».
Solución de problemas
- «Veolia ha rechazado el e-mail o la contraseña»: inicie sesión en la web de Veolia con las mismas credenciales. Si Veolia le pide una contraseña nueva, cámbiela allí y luego actualice Gladys.
- «WAF block» en el estado: Veolia (a través de AWS) bloquea algunas direcciones de servidor (proveedores de alojamiento, VPN). Desde una conexión doméstica normal no debería ocurrir.
- Ningún consumo diario: probablemente su contador no tiene telelectura. Compruébelo en la web de Veolia.
- Municipio «todavía no compatible»: su municipio tiene su propio portal de Veolia. Abra una issue en el repositorio de GitHub con la dirección del portal.
Sus datos
- Sus credenciales se quedan en la configuración de Gladys. Solo se envían a Veolia (su servicio de inicio de sesión AWS Cognito) y nunca se escriben en los registros.
- La integración solo lee su consumo. No cambia nada en su cuenta de Veolia.
- Veolia no ofrece ninguna API oficial para estos datos: la integración hace lo mismo que la web. Si Veolia cambia su web, puede dejar de funcionar hasta una actualización.
Parámetros de configuración
Estos son los parámetros que Veolia te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Primeros pasos | section | No | Su vivienda necesita un contador de agua con telelectura (télérelève) y un área de cliente de Veolia. Introduzca el e-mail y la contraseña que usa en la web de Veolia. ¿No sabe si Veolia abastece su municipio? Use el botón «Comprobar mi municipio» de abajo. |
| E-mail de Veolia | string | Sí | La dirección de e-mail de su área de cliente de Veolia. |
| Contraseña de Veolia | secret | Sí | |
| Área de cliente | select | No | Deje eau.veolia.fr salvo que su municipio le redirija a su propio portal de Veolia. |
| Intervalo de actualización (h) | number | No | Cada cuánto se lee el portal de Veolia, en horas. Veolia publica una lectura al día. |
| Umbral de consumo alto (L/día) | number | No | Un día con esta cantidad de litros o más lanza el activador de escena «Consumo de agua alto». 0 lo desactiva. |
| Lectura ausente tras (días) | number | No | Días sin lectura nueva antes de que se lance el activador de escena «Lectura de agua atrasada». |
Cómo instalar Veolia en Gladys
- En Gladys, abre Integraciones: Veolia 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/prohand/gladys-veolia:1.1.1), 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/prohand/gladys-veolia.
Veolia 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
Veolia 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 prohand, no el equipo principal de Gladys.
- Explorar todas las integraciones, nativas y de la comunidad
- Crear y publicar tu propia integración externa
- Código fuente en GitHub — fuente de esta documentación