Intégration personnalisée Home Assistant
L’intégration personnalisée hydroqc-ha est la méthode recommandée pour intégrer Hydro-Québec avec Home Assistant. Elle fournit une intégration native directement dans Home Assistant.
Pourquoi choisir hydroqc-ha?
- Intégration native: Fonctionne comme un composant personnalisé de Home Assistant
- Configuration facile: Configuration entièrement via l’interface de Home Assistant
- Support complet des fonctionnalités: Consommation, facturation, crédits hivernaux et tarification dynamique
- Multi-contrats: Un appareil par contrat Hydro-Québec
- Entités de diagnostic: Entités optionnelles pour le dépannage et les automatisations avancées
Installation
Via HACS (Recommandé)
Prérequis
Assurez-vous que HACS est installé dans votre instance Home Assistant. Si ce n’est pas déjà fait:
- Suivez le guide d’installation HACS
- Redémarrez Home Assistant après l’installation de HACS
Installation de l’intégration
Option A: Installation en un clic
Cliquez sur le badge ci-dessus pour ajouter le dépôt à HACS, puis:
- Cliquez sur “Télécharger” (ou “Installer”)
- Redémarrez Home Assistant
Option B: Installation manuelle via HACS
- Ouvrez HACS dans Home Assistant
- Cliquez sur Intégrations
- Cliquez sur le menu trois points dans le coin supérieur droit
- Sélectionnez “Dépôts personnalisés”
- Ajoutez l’URL du dépôt:
https://github.com/hydroqc/hydroqc-ha - Sélectionnez la catégorie: Intégration
- Cliquez sur “Ajouter”
- Recherchez “Hydro-Québec” dans la liste des intégrations HACS
- Cliquez sur l’intégration Hydro-Québec
- Cliquez sur “Télécharger” (ou “Installer”)
- Redémarrez Home Assistant
Note: après le redémarrage, vous devrez encore configurer l’intégration (voir la section Configuration ci-dessous).
Installation manuelle
- Téléchargez la dernière version depuis GitHub Releases
- Extrayez le dossier
hydroqcdans votre répertoirecustom_components - Redémarrez Home Assistant
Configuration
La première étape demande le mode de connexion: Portal Mode (requires login) pour un compte Hydro-Québec, ou OpenData Mode (no login required) pour les données publiques de pointe sans identifiants.
Pour les tarifs DPC (Flex-D) et DCPC (Crédits hivernaux), vous devez créer un calendrier local dédié dans Home Assistant avant de configurer l’intégration. Tous les capteurs de pointe (état, heures des prochaines pointes et préchauffage) lisent leurs données depuis les événements du calendrier. N’utilisez pas un calendrier partagé.
Option 1: Mode Portail (compte Hydro-Québec)
- Allez dans Paramètres > Appareils et services
- Cliquez sur + Ajouter une intégration
- Recherchez Hydro-Québec
- Sélectionnez Portal Mode (requires login)
- Entrez vos identifiants:
- Nom d’utilisateur: votre courriel Hydro-Québec
- Mot de passe: votre mot de passe Hydro-Québec
- Nom du contrat: un nom convivial (ex: “Maison”, “Chalet”)
- Sélectionnez le contrat à surveiller
- Choisissez le nombre de jours d’historique de consommation à importer (0-800). Mettez
0pour ne synchroniser que les 30 derniers jours - Activez ou désactivez la synchronisation de consommation
- Pour les tarifs DPC (Flex D) et DCPC (Crédits hivernaux), sélectionnez un calendrier dédié
- Terminé! Les entités apparaîtront sous peu
Fonctionnalités avec un compte:
- Données de consommation actuelle et historique
- Informations de solde et de facturation
- Tarif actuel et option tarifaire
- Crédits hivernaux et événements de pointe
- Informations sur les pannes
- Statistiques du tableau de bord énergétique
La synchronisation de consommation importe la consommation horaire sous forme de statistiques à long terme pour le tableau de bord énergétique de Home Assistant. Vous pouvez la désactiver si vous n’avez pas besoin du suivi de consommation historique ou pour réduire les appels API. Ce paramètre peut être modifié dans les options de l’intégration.
Option 2: Mode OpenData (aucun compte requis)
Pour les utilisateurs qui souhaitent uniquement les informations sur les périodes de pointe sans se connecter:
- Allez dans Paramètres > Appareils et services
- Cliquez sur + Ajouter une intégration
- Recherchez Hydro-Québec
- Sélectionnez OpenData Mode (no login required)
- Choisissez votre secteur de clientèle (résidentiel ou commercial)
- Sélectionnez votre plan tarifaire (les plans disponibles sont récupérés depuis l’API publique d’Hydro-Québec)
- Entrez un nom de contrat et une durée de préchauffage (0-240 minutes)
- Pour les tarifs DPC (Flex D) et DCPC (Crédits hivernaux), sélectionnez un calendrier dédié
- Terminé! Les entités apparaîtront sous peu
Fonctionnalités sans compte:
- Informations sur les événements de pointe
- Informations sur la tarification dynamique
- Pas de suivi de consommation
- Pas d’informations de facturation
La durée de préchauffage peut être configurée lors de la configuration et modifiée plus tard dans les options de l’intégration. Elle détermine combien de temps à l’avance la période de préchauffage commence avant un événement de pointe (par défaut: 120 minutes, plage: 0-240 minutes).
Configuration multi-contrats
Pour surveiller plusieurs contrats (ex: maison et chalet):
- Ajoutez l’intégration plusieurs fois
- Utilisez un nom de contrat différent pour chacun
- Sélectionnez un contrat différent lors de chaque configuration
Changer de contrat ou de mot de passe
Hydro-Québec attribue un nouveau numéro de contrat chaque fois que le responsable d’un lieu de consommation change, même si ce lieu est déjà associé au compte. Pas besoin de supprimer l’intégration pour mettre à jour:
- Allez dans Paramètres > Appareils et services > Hydro-Québec
- Ouvrez le menu trois points de l’entrée et sélectionnez Reconfigurer
- Confirmez votre courriel. Laissez le mot de passe vide pour garder l’actuel, ou entrez le nouveau
- Sélectionnez le contrat
Les entités conservent leur entity_id et l’historique de consommation est préservé.
Vérification par courriel (MFA)
Hydro-Québec peut exiger un code de vérification envoyé par courriel après le mot de passe.
- Pendant la configuration initiale, une reconfiguration ou une réauthentification, l’intégration affiche l’étape Vérification par courriel.
- Entrez le code reçu. Laissez le champ vide pour recevoir un nouveau code. Si le code est expiré, la connexion est relancée et un nouveau code est envoyé automatiquement.
- La session du portail (jeton de rafraîchissement et témoins de connexion Azure AD B2C) est conservée dans le stockage de Home Assistant. Au redémarrage, l’intégration tente une connexion silencieuse avant de redemander des identifiants. La session obtenue pendant la configuration initiale est réutilisée : aucun second code n’est demandé juste après l’ajout.
Aucune demande de code en arrière-plan
Les connexions automatiques s’arrêtent à l’étape de vérification : aucun code n’est envoyé et la connexion n’est pas relancée en boucle. Home Assistant affiche Réauthentification requise dans Paramètres > Appareils et services. Cliquez sur Réauthentifier pour saisir un nouveau code.
Le portail Hydro-Québec conserve la session environ 24 heures. Pendant ce délai, les redémarrages ne demandent ni mot de passe ni code. Passé ce délai, une nouvelle connexion avec code de vérification est obligatoire : prévoyez une réauthentification environ une fois par jour.
Étapes suivantes
Dépannage
Consultez la page Dépannage pour les problèmes de connexion, les données manquantes et la journalisation en mode débogage.
Soutien
- Problèmes: GitHub Issues
- Documentation: hydroqc.ca
- Code source: Dépôt GitHub
- Discord: Rejoindre notre Discord