Veolia Smart-Home-Integration, kostenlos und Open Source

Dein Wasserverbrauch aus deinem Veolia-Kundenkonto (eau.veolia.fr).

• Veröffentlicht von prohand
• Geräte
• Version 1.1.1
• Erfordert Gladys >=5.1.0
• ★ 0

Auf GitHub ansehenAlle Integrationen

Diese Integration liest deinen Wasserverbrauch aus deinem Veolia-Kundenkonto (eau.veolia.fr) und bringt ihn in Gladys: ein Gerät „Wasserzähler“, ein Dashboard-Widget und Karten für deine Szenen.

Was du brauchst

• Einen fernablesbaren Wasserzähler (télérelève): Er sendet deinen Verbrauch jeden Tag an Veolia. Ohne ihn hat Veolia nur einen Messwert pro Jahr.
• Ein Veolia-Kundenkonto mit E-Mail-Adresse und Passwort. Prüfe, dass die Veolia-Website deinen Verbrauch Tag für Tag anzeigt.
• Gladys 5.1 oder neuer.

Wird deine Gemeinde von Veolia versorgt? Nutze im Tab Konfiguration die Schaltfläche Meine Gemeinde prüfen mit deiner Postleitzahl. Für Metz (57000) lautet die Antwort zum Beispiel „Unterstützt, Portal eau.veolia.fr“.

Konfiguration

1. Öffne den Tab Konfiguration der Integration.
2. Gib die E-Mail-Adresse und das Passwort deines Kundenkontos ein.
3. Kundenportal: Behalte eau.veolia.fr, außer Meine Gemeinde prüfen nennt ein anderes Portal (Eau de Toulouse Métropole).
4. Optionale Einstellungen:
   • Aktualisierungsintervall (standardmäßig 6 h): Veolia veröffentlicht einen Messwert pro Tag, ein kurzes Intervall bringt nichts;
   • Schwelle für hohen Verbrauch (L/Tag): 0 = aus. Ab diesem Wert löst der Auslöser Hoher Wasserverbrauch aus;
   • Fehlender Messwert nach (standardmäßig 3 Tage): Frist bis zum Auslöser Wasser-Messwert überfällig.
5. Klicke auf Konfiguration speichern und dann auf Verbindung testen: Die Antwort zeigt deinen Zähler und seinen letzten Messwert.
6. Öffne den Tab Entdecken und füge den Wasserzähler mit Zu Gladys hinzufügen hinzu.

Sobald das Gerät hinzugefügt ist, wird der bekannte Verlauf (der aktuelle und der vorherige Monat) an Gladys gesendet, datiert auf den jeweiligen Tag des Messwerts.

Danach holt die Integration die 24 vorherigen Monate bei Veolia ab, ebenfalls auf ihren Tag datiert, damit die Gladys-Diagramme die vergangenen Jahre zeigen können. Der Import läuft im Hintergrund, ein Monat alle 20 Sekunden (etwa 8 Minuten). Du musst keine Datei bereitstellen: Veolia bewahrt den Verlauf auf. Wenn Gladys alte Zustände löscht (die Einstellung Gerätestatusverlauf behalten unter Einstellungen → System), wähle mindestens 2 Jahre, um sie zu behalten.

Das Gerät „Wasserzähler“

Wert	Einheit	Bedeutung
Index	m³	Zählerstand beim letzten Messwert
Consommation journalière	L	Täglich verbrauchte Liter, am Tag des Messwerts
Consommation du mois	m³	Summe des aktuellen Monats
Consommation de l'année	m³	Summe des aktuellen Kalenderjahres

Die Gerätekarte trägt das Abzeichen Cloud, solange das Veolia-Portal antwortet, Nicht erreichbar, wenn es nicht antwortet, mit einem orangefarbenen Punkt, wenn innerhalb der Frist „Fehlender Messwert nach“ kein Messwert kam. Es gibt keinen lokalen Modus: Die Daten existieren nur bei Veolia.

Gut zu wissen: Veolia veröffentlicht einen Messwert 1 bis 3 Tage verspätet. Dass du den Verbrauch von gestern nicht sehen, ist normal.

Dashboard

Füge das Widget Wasserverbrauch hinzu (Dashboard → Bearbeiten → Neues Widget): letzter Tag, Monat, Jahr, Zählerstand, ein Tagesdiagramm (7, 14 oder 30 Tage, im Widget einstellbar), das Datum und die Zuverlässigkeit des letzten Messwerts (gemessen oder geschätzt) und eine Schaltfläche Aktualisieren. Bei mehreren Zählern wählst du einen in den Einstellungen des Widgets.

Das Widget Wasser: Jahresvergleich zeigt den Verbrauch jedes Monats der letzten 3 Jahre nebeneinander, die Summe jedes Jahres und die Veränderung gegenüber dem Vorjahr über denselben Zeitraum (Januar bis zum letzten vollständigen Monat). Seine Zahlen kommen direkt von Veolia: Es funktioniert auch, wenn Gladys den Verlauf nicht aufbewahrt hat.

Szenen

Die Integration fügt ihre Karten dem Szeneneditor hinzu, unter Integrationen (Integrations-Auslöser und Integrations-Aktion).

Auslöser:

• Neuer Wasser-Messwert — Veolia hat einen neuen Tag veröffentlicht. Variablen: {{triggerEvent.data.date}}, {{triggerEvent.data.liters}}, {{triggerEvent.data.index_m3}}.
• Hoher Wasserverbrauch — ein Tag hat die von dir eingestellte Schwelle erreicht (mögliches Leck). Variablen: date, liters, threshold_liters.
• Wasser-Messwert überfällig — kein neuer Messwert seit der von dir eingestellten Anzahl von Tagen (Zähler oder Portal ausgefallen). Variablen: last_date, days.

Aktionen:

• Wasserverbrauch aktualisieren — liest Veolia jetzt und gibt den neuesten Messwert zurück (date, liters, index_m3).
• Wasserverbrauch abrufen — gibt den Verbrauch eines Zeitraums zurück (letzter abgelesener Tag, dieser Monat, letzter Monat, dieses Jahr) in Litern und m³, für eine Nachricht oder eine Bedingung.

Beispiel: „jeden 1. des Monats um 9:00 den Verbrauch des letzten Monats abrufen und mir senden: Letzter Monat: {{…cubic_meters}} m³“.

Fehlerbehebung

• „Veolia hat die E-Mail-Adresse oder das Passwort abgelehnt“: Melde dich mit denselben Zugangsdaten auf der Veolia-Website an. Wenn Veolia ein neues Passwort verlangt, ändere es dort und aktualisiere dann Gladys.
• „WAF block“ im Status: Veolia (über AWS) sperrt einige Serveradressen (Hosting-Anbieter, VPNs). Von einem normalen Heimanschluss aus sollte das nicht passieren.
• Kein täglicher Verbrauch: Dein Zähler ist wahrscheinlich nicht fernablesbar. Prüfe es auf der Veolia-Website.
• Gemeinde „noch nicht unterstützt“: Deine Gemeinde hat ein eigenes Veolia-Portal. Eröffne ein Issue im GitHub-Repository mit der Adresse des Portals.

Deine Daten

• Deine Zugangsdaten bleiben in der Gladys-Konfiguration. Sie werden nur an Veolia gesendet (seinen Anmeldedienst AWS Cognito) und nie in die Protokolle geschrieben.
• Die Integration liest nur deinen Verbrauch. Sie ändert nichts an deinem Veolia-Konto.
• Veolia bietet für diese Daten keine offizielle API: Die Integration macht das, was die Website macht. Wenn Veolia seine Website ändert, kann sie bis zu einem Update nicht mehr funktionieren.

Konfigurationseinstellungen

Diese Einstellungen fragt Veolia in seinem Konfigurationsbildschirm in Gladys ab.

Einstellung	Typ	Pflichtfeld	Beschreibung
Erste Schritte	section	Nein	Dein Zuhause braucht einen fernablesbaren Wasserzähler (télérelève) und ein Veolia-Kundenkonto. Gib die E-Mail-Adresse und das Passwort ein, die du auf der Veolia-Website verwendest. Du bist nicht sicher, ob deine Gemeinde von Veolia versorgt wird? Nutze unten die Schaltfläche „Meine Gemeinde prüfen“.
Veolia-E-Mail	string	Ja	Die E-Mail-Adresse deines Veolia-Kundenkontos.
Veolia-Passwort	secret	Ja
Kundenportal	select	Nein	Behalte eau.veolia.fr, außer deine Gemeinde leitet dich auf ein eigenes Veolia-Portal weiter.
Aktualisierungsintervall (h)	number	Nein	Wie oft das Veolia-Portal gelesen wird, in Stunden. Veolia veröffentlicht einen Messwert pro Tag.
Schwelle für hohen Verbrauch (L/Tag)	number	Nein	Ein Tag mit mindestens so vielen Litern löst den Szenen-Auslöser „Hoher Wasserverbrauch“ aus. 0 schaltet ihn ab.
Fehlender Messwert nach (Tagen)	number	Nein	Tage ohne neuen Messwert, bevor der Szenen-Auslöser „Wasser-Messwert überfällig“ auslöst.

So installierst du Veolia in Gladys

1. Öffne in Gladys Integrationen: Veolia erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
2. Klicke auf Installieren. Gladys lädt das Docker-Image (ghcr.io/prohand/gladys-veolia:1.1.1) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration).
3. Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
4. 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 Integrationen durchsuchen, native und aus der Community
• Deine eigene externe Integration bauen und veröffentlichen
• Quellcode auf GitHub — Quelle dieser Dokumentation

Abonniere den Newsletter von Gladys Assistant

Ein paar E-Mails im Monat zu neuen Releases und Neuigkeiten aus dem Projekt. Verschickt von Pierre-Gilles Leymarie, dem Gründer des Projekts. Jederzeit abbestellbar 🙂