Veolia Smart-Home-Integration, kostenlos und Open Source
Your water consumption from your Veolia customer account (eau.veolia.fr).
Veröffentlicht von prohand
- Geräte
- Version 1.0.2
- Erfordert Gladys >=5.1.0
- ★ 0
Die Dokumentation dieser Integration wird von ihrem Autor geschrieben und ist bisher nur auf Englisch verfügbar.
This integration reads your water consumption from your Veolia customer account (eau.veolia.fr) and brings it into Gladys: a "water meter" device, a dashboard widget, and cards for your scenes.
What you need
- A remote-read water meter (télérelève): it sends your consumption to Veolia every day. Without it, Veolia only has one reading a year.
- A Veolia customer account with an e-mail and a password. Check that the Veolia website shows your consumption day by day.
- Gladys 5.1 or later.
Is your town served by Veolia? In the Configuration screen, use the Check my town button with your postal code. For example, Metz (57000) answers "Supported, portal eau.veolia.fr".
Configuration
- Open the Configuration tab of the integration.
- Enter the e-mail and password of your customer account.
- Customer portal: keep
eau.veolia.fr, unless Check my town names another portal (Eau de Toulouse Métropole). - Optional settings:
- Refresh interval (6 h by default): Veolia publishes one reading a day, a short interval brings nothing;
- High consumption threshold (L/day): 0 = off. At or above it, the High water consumption trigger fires;
- Missing reading after (3 days by default): delay before the Water reading overdue trigger.
- Save, then click Test the connection: the answer shows your meter and its last reading.
- Open the Discovery tab and add the water meter.
When the device is added, the known history (the current and the previous month) is sent to Gladys, dated on each reading day.
Then the integration fetches the 24 previous months from Veolia, dated on their day too, so the Gladys charts can show the past years. The import runs in the background, one month every 20 seconds (about 8 minutes). There is no file to provide: Veolia keeps the history. If Gladys deletes old states (the history retention setting in Settings → System), pick at least 2 years to keep them.
The "Water meter" device
| Value | Unit | Meaning |
|---|---|---|
| Index | m³ | Meter index at the last reading |
| Consommation journalière | L | Litres used each day, stored on the reading day |
| Consommation du mois | m³ | Total of the current month |
| Consommation de l'année | m³ | Total of the current calendar year |
The device card carries the Cloud badge while the Veolia portal answers, Unreachable when it does not, with an orange dot when no reading came for the "Missing reading after" delay. There is no local mode: the data only exists at Veolia.
Good to know: Veolia publishes a reading 1 to 3 days late. Not seeing yesterday's consumption is normal.
Dashboard
Add the Water consumption widget: last day, month, year, index, a daily chart (7, 14 or 30 days, set in the widget), the date and reliability of the last reading (measured or estimated), and a Refresh button. With several meters, pick one in the widget settings.
The Water: year comparison widget shows the consumption of each month of the last 3 years side by side, the total of each year, and the change against last year over the same period (January to the last full month). Its figures come straight from Veolia: it works even if Gladys did not keep the history.
Scenes
The integration adds its cards to the scene editor, under Integrations.
Triggers:
- New water reading — Veolia published a new day. Variables:
{{triggerEvent.data.date}},{{triggerEvent.data.liters}},{{triggerEvent.data.index_m3}}. - High water consumption — a day reached the threshold you set (possible
leak). Variables:
date,liters,threshold_liters. - Water reading overdue — no new reading for the number of days you set
(meter or portal down). Variables:
last_date,days.
Actions:
- Refresh the water consumption — reads Veolia now and returns the latest
reading (
date,liters,index_m3). - Get the water consumption — returns the consumption of a period (last reading day, this month, last month, this year) in litres and m³, for a message or a condition.
Example: "every 1st of the month at 9:00, get last month's consumption and send me: Last month: {{…cubic_meters}} m³".
Troubleshooting
- "Veolia refused the e-mail or the password": sign in on the Veolia website with the same credentials. If Veolia asks for a new password, change it there, then update Gladys.
- "WAF block" in the status: Veolia (through AWS) blocks some server addresses (hosting providers, VPNs). From a regular home connection this should not happen.
- No daily consumption: your meter is probably not remote-read. Check on the Veolia website.
- Town "not supported yet": your town has its own Veolia portal. Open an issue on the GitHub repository with the portal address.
Your data
- Your credentials stay in the Gladys configuration. They are only sent to Veolia (its AWS Cognito sign-in service) and never written to the logs.
- The integration only reads your consumption. It changes nothing on your Veolia account.
- Veolia offers no official API for this data: the integration does what the website does. If Veolia changes its website, it may stop working until an update.
Konfigurationseinstellungen
Diese Einstellungen fragt Veolia in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Getting started | section | Nein | Your home needs a remote-read water meter (télérelève) and a Veolia customer account. Enter the e-mail and password you use on the Veolia website. Not sure your town is served by Veolia? Use the "Check my town" button below. |
| Veolia e-mail | string | Ja | The e-mail address of your Veolia customer account. |
| Veolia password | secret | Ja | |
| Customer portal | select | Nein | Keep eau.veolia.fr unless your town redirects you to its own Veolia portal. |
| Refresh interval (h) | number | Nein | How often the Veolia portal is read, in hours. Veolia publishes one reading a day. |
| High consumption threshold (L/day) | number | Nein | A day at or above this many litres fires the "High consumption" scene trigger. 0 turns it off. |
| Missing reading after (days) | number | Nein | Days without a new reading before the "Reading overdue" scene trigger fires. |
So installierst du Veolia in Gladys
- Öffne in Gladys Integrationen: Veolia erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/prohand/gladys-veolia:1.0.2) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration). - Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
- Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/prohand/gladys-veolia.
Veolia benötigt Gladys >=5.1.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.
Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.
Über externe Integrationen
Veolia ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von prohand veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.
- Alle externen Integrationen durchsuchen
- Die nativen Integrationen entdecken, die in Gladys eingebaut sind
- Deine eigene externe Integration bauen und veröffentlichen
- Quellcode auf GitHub — Quelle dieser Dokumentation