Intégration domotique Gaz de Bordeaux, gratuite et open source
Consommation et coût du gaz et de l'électricité de votre compte client Gaz de Bordeaux.
Publiée par prohand
- Appareils
- Version 1.0.10
- Nécessite Gladys >=5.2.0
- ★ 0
Cette intégration relie Gladys à votre espace client Gaz de Bordeaux (life.gazdebordeaux.fr). Elle y lit votre consommation de gaz et d'électricité, et son coût, pour les afficher dans Gladys, tracer leurs graphiques et déclencher des scènes.
Elle passe par internet (badge cloud) : rien à installer chez vous, pas de module sur le compteur.
Avant de commencer
- Il vous faut un compte sur life.gazdebordeaux.fr et pouvoir y voir votre consommation. Connectez-vous-y une fois depuis un navigateur pour le vérifier.
- Gaz de Bordeaux publie la consommation d'une journée un ou deux jours plus tard (le temps que le compteur Gazpar ou Linky la remonte). Gladys affiche donc toujours le dernier jour relevé, pas aujourd'hui.
- Gladys 5.2 ou plus récent est nécessaire.
Configuration
- Ouvrez l'onglet Configuration de l'intégration.
- Renseignez l'e-mail et le mot de passe de votre espace client.
- Réglez si besoin :
- Intervalle de rafraîchissement (heures) : fréquence de lecture de l'espace client, toutes les 6 heures par défaut (de 1 à 24). Les relevés ne changent qu'une fois par jour : inutile de descendre plus bas.
- Jours d'historique à importer : nombre de jours passés envoyés à Gladys à la création d'un appareil, 30 par défaut (jusqu'à 90). Les graphiques ne démarrent pas vides.
- Seuil d'alerte gaz / électricité (kWh/jour) : au-dessus, le déclencheur « Consommation journalière élevée » se lance. 0 le désactive.
- Enregistrez. Le bouton Tester la connexion vérifie l'e-mail et le mot de passe et liste les contrats trouvés.
- Ouvrez l'onglet Découverte : un appareil est proposé par contrat (« Gaz de Bordeaux – Gaz », « Gaz de Bordeaux – Électricité »). Ajoutez ceux que vous voulez suivre.
Le mot de passe est un champ secret : il n'est jamais écrit dans les logs.
Ce que vous obtenez
Chaque appareil « contrat » porte des capteurs en lecture seule :
| Fonctionnalité | Unité | Contrat | Valeur |
|---|---|---|---|
| Consommation du jour relevé | kWh | tous | une valeur par jour, datée du jour concerné |
| Coût du jour relevé | € | tous | une valeur par jour, datée du jour concerné |
| Volume de gaz du jour relevé | m³ | gaz | une valeur par jour, datée du jour concerné |
| Consommation du mois | kWh | tous | depuis le 1er du mois |
| Coût du mois | € | tous | depuis le 1er du mois |
| Consommation de l'année | kWh | tous | total de l'année donné par Gaz de Bordeaux |
| Coût de l'année | € | tous | total de l'année donné par Gaz de Bordeaux |
| Consommation journalière | kWh | électricité | envoyée au module Énergie de Gladys |
Les valeurs journalières sont datées du jour concerné, pas de l'heure de lecture : le graphique montre bien la consommation du lundi au lundi, même si elle est arrivée le mercredi.
À la création d'un appareil, les derniers jours (voir Jours d'historique à importer) sont importés. Ils ne sont jamais envoyés deux fois, même après un redémarrage.
Le badge de connexion
- Cloud : la dernière lecture a réussi.
- Cloud avec un point orange : l'espace client répond, mais le dernier relevé a plus de 4 jours. Le compteur ne remonte peut-être plus ses index : vérifiez-le sur le site de Gaz de Bordeaux.
- Injoignable : la dernière lecture a échoué (voir « En cas de problème »).
Actions
- Tester la connexion : se connecte avec l'e-mail et le mot de passe saisis et liste les contrats trouvés.
- Rafraîchir maintenant : lit l'espace client tout de suite et indique le dernier jour relevé.
- Mes prix de contrat : affiche les prix actuels de vos contrats, tels qu'ils sont sur espaceclient.gazdebordeaux.fr (voir « Contrats d'énergie »).
Scènes
L'intégration ajoute ses cartes à l'éditeur de scènes, catégorie Intégrations.
Déclencheurs
- Nouveau relevé journalier : Gaz de Bordeaux a publié une nouvelle
journée. Filtrez éventuellement sur un contrat ou une énergie. Les actions
suivantes peuvent lire
{{triggerEvent.data.date}},{{triggerEvent.data.kwh}},{{triggerEvent.data.cost}}et{{triggerEvent.data.volume}}(gaz). - Consommation journalière élevée : la nouvelle journée dépasse le seuil
d'alerte réglé dans la configuration. Variables :
date,kwh,threshold. - Espace client injoignable : la lecture a échoué alors qu'elle
fonctionnait. Filtrez sur la cause (connexion refusée, requête bloquée,
réseau, réponse inattendue, aucun contrat). Variables :
reason,message. - Prix du contrat modifiés : un prix actuel d'espaceclient.gazdebordeaux.fr
a changé (kWh, HP/HC ou abonnement, TTC). Filtrez éventuellement sur
l'énergie. Variables :
offer,kwh_price,peak_price,off_peak_price,subscription, et l'ancienne valeur de chacun (previous_kwh_price…). Les prix sont lus à chaque rafraîchissement et comparés tels que le site les donne : aucune fausse alerte due aux arrondis. L'alerte arrive quand le site affiche le nouveau prix.
Une journée, ou un changement de prix, n'est annoncé qu'une fois, même après un redémarrage. À la toute première lecture, rien n'est annoncé : seuls les changements suivants le sont.
Exemple : Prix du contrat modifiés puis Envoyer un message « Nouveau prix Gaz de Bordeaux : {{triggerEvent.data.kwh_price}} €/kWh (avant {{triggerEvent.data.previous_kwh_price}}), abonnement {{triggerEvent.data.subscription}} €/mois ». Pensez alors à créer un nouveau contrat d'énergie Gladys (voir « Quand vos prix changent »).
Actions
- Rafraîchir les relevés Gaz de Bordeaux : lit l'espace client tout de
suite. Sorties :
success(réussi ou non) etcontracts(nombre de contrats lus). - Lire une consommation Gaz de Bordeaux : choisissez un contrat et une
période (dernier jour relevé, ce mois-ci, cette année). Sorties :
kwh,cost,volume,dateetavailable(faux si aucune donnée). Pratique pour envoyer un message « Hier : 42 kWh, 5,10 € ».
Exemple : chaque matin à 8 h, Lire une consommation (dernier jour relevé) puis Envoyer un message « Gaz du {{date}} : {{kwh}} kWh, {{cost}} € ».
Tableau de bord
Ajoutez le widget Consommation Gaz de Bordeaux à un tableau de bord. Il affiche :
- la consommation et le coût du dernier jour relevé et du mois ;
- un graphique en barres des 30 derniers jours ;
- l'énergie, le dernier jour relevé, le volume de gaz, le prix actuel (lu sur espaceclient), le total de l'année, l'heure de la dernière lecture et l'état de la connexion ;
- un bouton Rafraîchir.
Dans les réglages du widget, choisissez le contrat à afficher ; laissé vide, c'est le premier.
Contrats d'énergie (électricité)
L'intégration ajoute des modèles de contrat à l'assistant de contrat de Gladys (Énergie → contrat du compteur), pour que Gladys calcule le coût de votre électricité au prix de Gaz de Bordeaux. Un modèle par offre et par option :
| Offre | Prix | Modèles |
|---|---|---|
| NovaFixe Élec | fixes 3 ans à la souscription, 10 % sous le tarif réglementé | Base, Heures creuses |
| NovaFixe Bonus Élec | comme NovaFixe, plus 100 € offerts la première année | Base, Heures creuses |
| NovaFlex Élec | indexés sur le tarif réglementé (TRV), kWh HT 5 % en dessous | Base, Heures creuses |
Votre offre n'est pas dans la liste ? (par exemple Ecodigo Elec, ou une ancienne offre qui n'est plus vendue) : prenez le modèle Mon contrat ci-dessous, il marche pour toutes les offres. Votre offre est écrite dans votre espace client, ligne « Votre tarif ».
Le plus simple : les modèles « Mon contrat »
Les modèles Gaz de Bordeaux – Mon contrat – Base et – Heures creuses prennent vos propres prix, pour toutes les offres (Ecodigo, NovaFixe, NovaFlex…). Ce sont ceux de votre espace client (espaceclient.gazdebordeaux.fr, ligne « Votre prix actuel »), donnés par le bouton Mes prix de contrat :
- Cliquez sur Mes prix de contrat (onglet Configuration de l'intégration).
- Dans Gladys, Énergie → contrat du compteur électrique Gaz de Bordeaux, choisissez le modèle Mon contrat de votre option (Base ou Heures creuses).
- Saisissez les prix donnés par le bouton : prix du kWh (Heures creuses : prix heures pleines et heures creuses, et les heures creuses) et abonnement par mois.
Les prix sont dans le contrat, comme avec les autres modèles : l'assistant et le JSON du contrat les affichent. Gladys ne permet pas à une intégration de remplir l'assistant : ils se saisissent donc une fois. Quand ils changent, le déclencheur de scène Prix du contrat modifiés vous prévient : créez un nouveau contrat (voir « Quand vos prix changent »).
Vos prix : le bouton « Mes prix de contrat »
Une offre à prix fixe garde le prix du jour de la souscription, une offre indexée (Ecodigo Elec) change avec les taxes et le marché : votre prix n'est pas forcément celui de la grille d'aujourd'hui. Le bouton Mes prix de contrat (onglet Configuration) lit vos prix actuels sur espaceclient.gazdebordeaux.fr (mêmes e-mail et mot de passe), ligne « Votre prix actuel » de la page de votre contrat, et les donne tels quels, sans calcul. Exemple :
Électricité, OFFRE ECODIGO ELEC 100% ÉLECTRICITÉ VERTE (BASE, 6 kVA) : 0.160164 €/kWh, abonnement 15.87 €/mois.
Ce sont des prix TTC (taxes comprises : CTA dans l'abonnement, accise dans le kWh), comme les contrats proposés par Gladys. Recopiez-les dans l'assistant de contrat de Gladys (modèle Mon contrat, ou celui de votre offre). Saisissez-les avec un point (15.87), comme le bouton les écrit : une virgule collée peut être supprimée par le champ (15,87 devient 1587, soit un abonnement d'environ 51 € par jour sur le graphique d'énergie). Si c'est arrivé, corrigez le prix dans le contrat : c'est une faute de frappe, pas un changement de prix.
Pour un contrat d'électricité, le bouton donne aussi ces prix sous forme de tarif Gladys (JSON), prêt à coller là où Gladys demande le tarif d'un contrat. C'est le tarif qu'obtient un contrat Mon contrat. En Heures creuses, une règle heures creuses est ajoutée avec vos horaires (si l'espace client les donne).
{
"tariff_version": 1,
"components": [
{ "key": "energy", "kind": "consumption", "rules": [], "fallback": { "price": 0.160164 } },
{ "key": "subscription", "kind": "fixed", "amount": 15.87, "per": "month" }
]
}
Si l'espace client ne peut pas être lu, le bouton le dit : les prix sont alors à recopier depuis la page de votre contrat sur espaceclient.gazdebordeaux.fr.
Quand vos prix changent
Laissez la date de fin de votre contrat Gladys vide tant que vos prix ne changent pas. Ils peuvent changer en cours de route : nouvelle grille (NovaFlex, Ecodigo Elec, fin d'une période à prix fixe), ou taxe (accise, TVA) qui change le prix TTC. Gaz de Bordeaux vous prévient, et le déclencheur de scène Prix du contrat modifiés aussi ; le bouton Mes prix de contrat donne alors les nouveaux prix.
- Sur le contrat actuel, mettez la date de fin à la veille du changement.
- Créez un nouveau contrat qui démarre le jour du changement, avec les nouveaux prix.
Les jours passés gardent ainsi leurs anciens prix. Ne modifiez pas les prix du contrat existant : Gladys recalculerait tout l'historique depuis le début du contrat avec le nouveau prix.
Les prix par défaut : les grilles officielles
Les valeurs proposées par défaut sont celles des grilles tarifaires officielles de Gaz de Bordeaux (prix TTC, ici celles du 1er octobre 2026). Elles sont téléchargées chaque mois sur gazdebordeaux.fr : quand un prix change, une nouvelle version de l'intégration propose les nouveaux prix pour les contrats créés ensuite. Un contrat déjà créé garde ses prix : voir Quand vos prix changent.
| Puissance | Abonnement / mois | NovaFixe : kWh Base | NovaFixe : HP / HC | NovaFlex : kWh Base | NovaFlex : HP / HC |
|---|---|---|---|---|---|
| 3 kVA | 12,13 | 0,18373 | – | 0,19190 | – |
| 6 kVA | 15,87 | 0,18373 | 0,19648 / 0,14669 | 0,19190 | 0,20536 / 0,15280 |
| 9 kVA | 19,88 | 0,18233 | 0,19648 / 0,14669 | 0,19042 | 0,20536 / 0,15280 |
| 12 kVA | 23,76 | 0,18233 | 0,19648 / 0,14669 | 0,19042 | 0,20536 / 0,15280 |
| 15 kVA | 27,40 | 0,18233 | 0,19648 / 0,14669 | 0,19042 | 0,20536 / 0,15280 |
| 18 kVA | 31,14 | – | 0,19648 / 0,14669 | – | 0,20536 / 0,15280 |
| 24 kVA | 39,13 | – | 0,19648 / 0,14669 | – | 0,20536 / 0,15280 |
| 30 kVA | 46,46 | – | 0,19648 / 0,14669 | – | 0,20536 / 0,15280 |
| 36 kVA | 53,88 | – | 0,19648 / 0,14669 | – | 0,20536 / 0,15280 |
L'abonnement est le même pour les trois offres. NovaFixe Bonus Élec a les prix de NovaFixe Élec.
Bon à savoir
- Base fonctionne avec la consommation journalière que cette intégration envoie au module Énergie.
- Heures creuses a besoin d'une consommation à la demi-heure (un compteur Linky relevé toutes les 30 minutes par une autre intégration). Avec la seule consommation journalière, Gladys ne peut pas savoir quels kWh sont en heures creuses : n'utilisez pas ce modèle dans ce cas.
- Le gaz n'est pas concerné : les contrats d'énergie de Gladys ne couvrent que l'électricité. Le coût du gaz reste celui donné par Gaz de Bordeaux (fonctionnalités « Coût du jour relevé », « Coût du mois »…).
En cas de problème
Le message d'état de l'onglet Configuration dit ce qui bloque :
- Connexion refusée : l'e-mail ou le mot de passe est faux. Utilisez ceux de life.gazdebordeaux.fr et vérifiez que vous pouvez vous y connecter dans un navigateur.
- Le site a bloqué la requête : le site de Gaz de Bordeaux filtre parfois les requêtes automatiques. L'intégration réessaie au prochain rafraîchissement ; si cela dure, ouvrez une demande sur le dépôt GitHub.
- Injoignable : Gladys n'a pas accès à internet, ou le site est en panne.
- Aucun contrat : le compte n'a pas de contrat de gaz ou d'électricité visible.
Les logs de l'intégration (Gladys → Intégrations → Gaz de Bordeaux → logs) donnent le détail. Ils ne contiennent jamais le mot de passe ni le jeton de session.
Cette intégration n'est pas éditée par Gaz de Bordeaux : elle lit les mêmes données que votre espace client. Si le site change, elle peut cesser de fonctionner jusqu'à une mise à jour.
Paramètres de configuration
Voici les paramètres demandés par Gaz de Bordeaux dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Pour commencer | section | Non | Saisissez l'e-mail et le mot de passe de votre compte client Gaz de Bordeaux (ceux du site life.gazdebordeaux.fr). L'intégration y lit votre consommation plusieurs fois par jour : Gaz de Bordeaux publie le relevé d'une journée un ou deux jours plus tard. Un appareil est proposé par contrat (gaz, électricité). |
string | Oui | L'e-mail avec lequel vous vous connectez à votre espace client Gaz de Bordeaux. | |
| Mot de passe | secret | Oui | |
| Intervalle de rafraîchissement (heures) | number | Non | Fréquence de lecture de l'espace client. Les relevés changent une fois par jour : toutes les 6 heures suffit. |
| Jours d'historique à importer | number | Non | Relevés journaliers importés dans Gladys à la création d'un appareil, pour que ses graphiques ne démarrent pas vides. |
| Seuil d'alerte gaz (kWh/jour) | number | Non | Le déclencheur de scène « Consommation journalière élevée » se lance quand une journée de gaz le dépasse. 0 le désactive. |
| Seuil d'alerte électricité (kWh/jour) | number | Non | Le déclencheur de scène « Consommation journalière élevée » se lance quand une journée d'électricité le dépasse. 0 le désactive. |
Comment installer Gaz de Bordeaux dans Gladys
- Dans Gladys, ouvrez Intégrations : Gaz de Bordeaux 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/prohand/gladys-gazdebordeaux:1.0.10), 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/prohand/gladys-gazdebordeaux.
Gaz de Bordeaux nécessite Gladys >=5.2.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
Gaz de Bordeaux 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 prohand, et non par l'équipe cœur de Gladys.
- Parcourir toutes les intégrations, natives et communautaires
- Créer et publier votre propre intégration externe
- Code source sur GitHub — source de cette documentation