Intégration Hydro-Québec pour Gladys Assistant
Consommation Hydro-Québec, pointes Crédit Hivernal et Flex D, facturation et pannes.
Publiée par LM1LC3N7
- Appareils
- Version 0.1.5
- Nécessite Gladys >=4.86.0
- ★ 1
Suivez votre compte Hydro-Québec directement dans Gladys : consommation quotidienne, température extérieure moyenne, solde du compte, pannes et, si vous êtes inscrit aux options tarifaires dynamiques, les pointes du Crédit Hivernal (CPC) et de Flex D (DPC).
Ce que vous obtenez
Un appareil Gladys est créé par contrat Hydro-Québec sur votre compte (un seul identifiant peut couvrir plusieurs contrats : résidence principale, logement locatif, chalet...). Chaque appareil expose :
- Consommation quotidienne (kWh) et coût quotidien moyen de la période de facturation en cours ($).
- Température extérieure moyenne de la dernière journée publiée par Hydro-Québec.
- Solde du compte ($).
- Panne en cours (oui/non), pour l'adresse de consommation du contrat.
Si le contrat est inscrit au Crédit Hivernal (tarif D, option CPC), vous obtenez aussi : le crédit cumulé et projeté ($), l'état courant (normal / ancre / ancre critique / pointe / pointe critique) et si une pointe critique ou une période de préchauffage approche.
Si le contrat est facturé au tarif Flex D (DPC), vous obtenez aussi : l'état courant (normal / pointe critique), si une pointe ou un préchauffage est en cours, les heures critiques appelées depuis le début de l'hiver, et le gain/la perte par rapport au tarif de base.
Configuration
- Ouvrez l'onglet Configuration de l'intégration.
- Entrez le même courriel/identifiant et mot de passe que pour vous
connecter à
session.hydroquebec.com. - Ajustez l'intervalle de rafraîchissement au besoin (Hydro-Québec ne met à jour la consommation quotidienne qu'une fois par jour, avec 1 à 2 jours de délai : interroger plus vite que toutes les 30-60 minutes n'apporte pas de données supplémentaires).
- Enregistrez : vos contrats apparaissent dans l'onglet Découverte.
Actions
- Tester la connexion — tente une vraie connexion à Hydro-Québec et affiche le succès ou la raison exacte de l'échec sous le bouton.
Testé et confirmé fonctionnel
Cette intégration a été validée avec un vrai compte Hydro-Québec et une vraie instance Gladys, pas seulement des tests automatisés :
- La connexion, la découverte des contrats, et l'ajout d'un appareil découvert depuis l'onglet Découverte.
- Un compte avec plus d'un compteur sous le même abonnement (un contrat principal et un secondaire) — chacun rapportant correctement ses propres données distinctes.
- La boucle de rafraîchissement, y compris le premier relevé qui apparaît juste après l'enregistrement de la configuration.
- Un contrat sans période de facturation en cours côté Hydro-Québec (ex. un compteur secondaire ou récemment ajouté) : la consommation, la température, le solde et l'état des pannes continuent d'être publiés, seul le coût quotidien reste vide pour celui-ci.
- La consommation, la température, le solde et les pannes au tarif de base « D », sur plusieurs cycles de rafraîchissement successifs.
Pas encore confirmé de façon indépendante : les valeurs des pointes Crédit Hivernal (CPC) et Flex D (DPC) sont calculées directement à partir des mêmes valeurs déjà calculées qu'utilise l'intégration Home Assistant pour Hydro-Québec, mais aucun compte inscrit à l'une de ces options n'a encore utilisé cette intégration — si c'est votre cas et que quelque chose semble incorrect, merci d'ouvrir une issue.
Notes importantes
- Cette intégration est développée de façon indépendante et n'est pas supportée par Hydro-Québec : ne contactez pas le service à la clientèle d'Hydro-Québec à son sujet. Si Hydro-Québec modifie son portail, l'authentification ou l'API peuvent cesser de fonctionner ; merci d'ouvrir une issue sur le dépôt le cas échéant.
- Votre mot de passe est stocké chiffré par Gladys (champ
secret) et n'est transmis qu'aux serveurs d'Hydro-Québec. - Le « coût quotidien moyen » est la moyenne $/jour de la période de facturation en cours, pas un détail exact jour par jour : l'API gratuite d'Hydro-Québec n'en expose pas pour le tarif de base « D ».
Dépannage
Consultez les logs de l'intégration depuis l'interface Gladys (ou
docker logs sur l'hôte) avec LOG_LEVEL=debug pour le détail complet de
chaque requête envoyée à Hydro-Québec.
Paramètres de configuration
Voici les paramètres demandés par Hydro-Québec dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Compte Hydro-Québec | section | Non | Utilisez le même courriel/identifiant et mot de passe que pour vous connecter à l'Espace client Hydro-Québec (session.hydroquebec.com). Cette intégration est développée de façon indépendante et n'est pas supportée par Hydro-Québec : ne contactez pas le service à la clientèle d'Hydro-Québec à son sujet. Tous les contrats du compte sont découverts automatiquement après l'enregistrement — rien d'autre à saisir (aucun numéro de compte/contrat requis). |
| Courriel / identifiant | secret | Oui | Le courriel ou l'identifiant utilisé pour vous connecter à votre compte Hydro-Québec en ligne. |
| Mot de passe | secret | Oui | Stocké chiffré par Gladys, il ne quitte jamais votre instance sauf pour parler à Hydro-Québec. |
| Intervalle de rafraîchissement (s) | number | Non | Fréquence de rafraîchissement de chaque contrat. Hydro-Québec ne met à jour la consommation quotidienne qu'une fois par jour, avec 1 à 2 jours de délai : inutile d'interroger plus vite que toutes les 30-60 minutes. |
| Durée de préchauffage (min) | number | Non | Combien de temps avant une pointe critique (Crédit Hivernal / Flex D) le capteur « préchauffage en cours » s'active. N'a d'effet que sur les contrats inscrits à l'une de ces options. |
Comment installer Hydro-Québec dans Gladys
- Dans Gladys, ouvrez Intégrations : Hydro-Québec 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/lm1lc3n7/gladys-hydro-quebec:0.1.5), 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/LM1LC3N7/Gladys-Hydro-Quebec.
Hydro-Québec nécessite Gladys >=4.86.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
Hydro-Québec 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 LM1LC3N7, et non par l'équipe cœur de Gladys.
- Parcourir toutes les intégrations externes
- Découvrir les intégrations natives intégrées à Gladys
- Créer et publier votre propre intégration externe
- Code source sur GitHub — source de cette documentation