Intégration domotique Weheat, gratuite et open source

Non officiel : pompes à chaleur Weheat, températures, état, COP, puissance, énergie, débit.

• Publiée par LM1LC3N7
• Appareils
• Version 0.1.1
• Nécessite Gladys >=5.1.0
• ★ 0

Voir sur GitHubToutes les intégrations

Cette intégration lit vos pompes à chaleur Weheat (Blackbird, Sparrow, Flint) par l'API officielle de Weheat, en lecture seule : rien n'est jamais commandé.

Connecteur non officiel, sans lien avec Weheat. Jamais testé avec un vrai compte ni une vraie pompe à chaleur pour l'instant : il suit la bibliothèque officielle du fabricant (weheat, MIT) et l'intégration Weheat de Home Assistant. Vos retours sont les bienvenus sur le forum Gladys. Weheat, Blackbird, Sparrow et Flint sont des marques de leur propriétaire.

Ce que vous obtenez

Un appareil par pompe à chaleur active du compte, avec :

Fonction	Unité	Remarque
État	texte	chauffage, eau chaude, veille, dégivrage, refroidissement…
Eau entrante (retour), eau sortante (départ), eau entrante du chauffage	°C
Température extérieure	°C	mesurée à l'entrée d'air de la pompe
Température intérieure (thermostat)	°C	seulement avec un thermostat OpenTherm
Ballon d'eau chaude, haut et bas	°C	seulement avec un ballon
Puissance électrique	W
Puissance thermique (W)	capteur simple	négative en refroidissement ou dégivrage
COP (coefficient de performance)	capteur simple	calculé sur le dernier relevé, comme Weheat
Débit d'eau du chauffage, débit d'eau chaude	m³/h	estimés depuis la commande des circulateurs
Électricité consommée, unité extérieure et unité intérieure (kWh, total)	capteur simple	totaux depuis la mise en service
Chaleur produite (kWh, total)	capteur simple	peut baisser (refroidissement, dégivrage)

Les totaux d'énergie sont des capteurs simples, pas des index d'énergie : Gladys ne les compte pas dans le suivi de consommation et ne leur applique aucun tarif. La chaleur produite n'est pas de l'électricité, et le total d'électricité est une somme calculée par le serveur de Weheat que nous n'avons pas pu vérifier sur un vrai compte. Un index d'électricité pourra venir quand un utilisateur aura confirmé qu'il ne fait que monter.

Le badge de chaque appareil passe à « injoignable » quand Weheat signale la pompe hors ligne, quand elle n'a pas pu être lue, ou quand l'intégration est arrêtée.

Avant de commencer : l'identifiant client

L'API de Weheat demande un identifiant client (et un secret client) fourni par Weheat, comme pour l'intégration de Home Assistant (dont la documentation renvoie à la base de connaissances du support Weheat ; à défaut, demandez-les au support Weheat). Weheat enregistre aussi une adresse de redirection pour ce client : l'adresse vers laquelle le navigateur revient après la connexion. Utilisez un client que Weheat vous destine, avec ses conditions d'utilisation.

• Si Weheat a enregistré l'adresse de votre Gladys, la connexion se fait d'un clic.
• Sinon (par exemple un client prévu pour une autre application), la connexion se termine en copiant-collant une adresse (voir plus bas).

Se connecter

1. Dans Intégrations → Weheat → Configuration, saisissez l'identifiant client et le secret client, puis enregistrez.
2. Cliquez sur Connecter : la page de connexion de Weheat s'ouvre. Connectez-vous avec l'e-mail et le mot de passe de votre compte Weheat. Votre mot de passe se saisit sur la page de Weheat seulement : l'intégration ne le voit jamais.
3. Weheat vous renvoie vers Gladys : l'intégration lit vos pompes à chaleur. Ajoutez-les depuis l'onglet Découverte.

Avec une autre adresse de redirection

1. Saisissez l'adresse enregistrée par Weheat dans Adresse de redirection (https, ou http sur localhost seulement) et enregistrez.
2. Cliquez sur Connecter et connectez-vous sur la page de Weheat.
3. À la fin, le navigateur s'arrête sur cette adresse (la page peut afficher une erreur, c'est normal). Copiez l'adresse complète de la barre d'adresse : elle contient code= et state=.
4. Collez-la dans l'action Terminer la connexion, dans les 15 minutes. Elle doit contenir state= et commencer par l'adresse de redirection : une autre adresse est refusée (la connexion reste alors utilisable).

Une connexion démarrée ne sert qu'une fois ; après un redémarrage de l'intégration, cliquez de nouveau sur Connecter. Si Weheat tarde à répondre (plus de 3,5 secondes au retour vers Gladys, 10 secondes pour « Terminer la connexion »), l'intégration affiche « Weheat lent, cliquez de nouveau sur Connecter » : recommencez la connexion.

Ce que l'intégration garde

• Le secret client est gardé par Gladys dans sa base, comme toute valeur de configuration : jamais réaffiché, envoyé seulement à Weheat.
• Les jetons de Weheat (accès et renouvellement) sont gardés en clair dans le fichier /data/weheat-state.json du volume de l'intégration, lisible par son conteneur seulement (droits 0600), et envoyés seulement à Weheat. Le même fichier garde les pauses, les arrêts et la liste des pompes. Aucun mot de passe n'y est jamais écrit.

Rythme de lecture

• Le dernier relevé de chaque pompe est relu toutes les 2 minutes par défaut, et au moins 2 minutes par pompe (comme Home Assistant) : 4 minutes avec deux pompes.
• Les totaux d'énergie sont relus toutes les 30 minutes, la liste des pompes toutes les 6 heures (et sur demande depuis Découverte).
• Le jeton est renouvelé par un minuteur un peu avant sa fin, jamais deux fois dans la même minute.
• Après un redémarrage, la première lecture attend la fin de l'intervalle depuis la dernière lecture et la fin d'une pause en cours (gardées dans /data).

Erreurs et arrêts

Situation	Ce que fait l'intégration
Weheat demande de ralentir (HTTP 429)	pause de 1 minute à 6 heures (selon Weheat), gardée après un redémarrage, pour toutes les requêtes
Weheat indisponible (erreur 5xx)	pause de 5 minutes à 1 heure, gardée après un redémarrage
Réseau coupé, réponse inattendue	nouvel essai après l'intervalle, puis 5, 15, 30 minutes, gardé après un redémarrage
Une pompe, les totaux d'énergie ou la liste échouent	le reste continue ; nouvel essai au tour suivant (30 minutes pour l'énergie et la liste)
Renouvellement refusé par Weheat	arrêt « session terminée », gardé : cliquez sur Connecter
Accès refusé même avec un nouveau jeton	arrêt gardé : vérifiez le compte, puis Connecter ou « Tester Weheat »

L'intégration ne se reconnecte jamais d'elle-même et ne réessaie jamais un refus : seul un clic le fait. Le bouton Tester Weheat relit les pompes tout de suite (une fois toutes les 30 secondes au plus).

Dépannage

• « Saisissez l'identifiant client » : l'identifiant client manque.
• Weheat refuse la connexion (invalid_client) : identifiant ou secret client faux.
• Weheat refuse la connexion (invalid_grant) ou erreur de redirection sur la page de Weheat : l'adresse de redirection ne correspond pas à celle enregistrée pour ce client, ou l'adresse collée a plus de 15 minutes.
• Aucune pompe : seules les pompes à l'état « active » chez Weheat sont lues.

Limites

• Lecture seule : pas de consigne, pas de mode.
• Les valeurs viennent du cloud de Weheat (dernier relevé connu), pas de la pompe en local.
• Jamais testé avec un vrai compte : les noms de champs et les calculs suivent la bibliothèque weheat 2026.9.3.

Paramètres de configuration

Voici les paramètres demandés par Weheat dans son écran de configuration dans Gladys.

Paramètre	Type	Obligatoire	Description
Les pompes à chaleur Weheat dans Gladys	section	Non	Connecteur non officiel, sans lien avec Weheat. Il lit vos pompes à chaleur Weheat (Blackbird, Sparrow, Flint) par l'API officielle de Weheat, en lecture seule : un appareil par pompe avec son état, les températures de l'eau, extérieure et intérieure, le COP, les puissances électrique et thermique, les totaux d'énergie et le débit d'eau. Il se connecte en OAuth comme l'intégration Weheat de Home Assistant : votre mot de passe se saisit sur la page de Weheat seulement. Jamais testé pour l'instant avec un vrai compte ni une vraie pompe. Weheat, Blackbird, Sparrow et Flint sont des marques de leur propriétaire.
Se connecter	section	Non	1. Saisissez l'identifiant client et le secret client que Weheat fournit pour son API (voir le guide), et enregistrez. 2. Cliquez sur Connecter : la page de Weheat s'ouvre, connectez-vous. 3. Weheat vous renvoie vers Gladys et l'intégration lit vos pompes à chaleur. Si l'adresse de redirection enregistrée par Weheat pour votre client n'est pas ce Gladys, saisissez-la dans « Adresse de redirection » : à la fin de la connexion, copiez l'adresse complète affichée par le navigateur (elle contient code= et state=) et collez-la dans « Terminer la connexion » plus bas, dans les 15 minutes. Les jetons sont gardés en clair dans le volume /data de l'intégration (lisible par son conteneur seulement), envoyés seulement à Weheat ; le secret client est gardé par Gladys dans sa base, jamais réaffiché, envoyé seulement à Weheat.
Identifiant client	string	Oui	Fourni par Weheat pour son API tierce.
Secret client	secret	Non	Fourni par Weheat avec l'identifiant client. Gardé par Gladys dans sa base, jamais réaffiché, envoyé seulement à Weheat.
Adresse de redirection (facultative)	string	Non	Vide : Weheat vous renvoie vers ce Gladys. Sinon, l'adresse que Weheat a enregistrée pour votre client (https, ou http sur localhost seulement) : terminez la connexion en collant l'adresse sur laquelle le navigateur s'est arrêté.
Compte Weheat	oauth2	Non	Ouvre la page de connexion de Weheat (enregistrez d'abord l'identifiant client).
Intervalle de relecture (minutes)	number	Non	Au moins 2 minutes par pompe à chaleur, comme Home Assistant. Les totaux d'énergie sont relus toutes les 30 minutes.
Langue des noms et des textes	select	Non

Comment installer Weheat dans Gladys

1. Dans Gladys, ouvrez Intégrations : Weheat apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
2. Cliquez sur Installer. Gladys télécharge l'image Docker (ghcr.io/lm1lc3n7/gladys-weheat:0.1.1), 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).
3. Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
4. Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/LM1LC3N7/gladys-weheat.

Weheat nécessite Gladys >=5.1.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

Weheat 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, natives et communautaires
• Créer et publier votre propre intégration externe
• Code source sur GitHub — source de cette documentation

Inscrivez-vous à la newsletter Gladys Assistant

Quelques emails par mois sur les nouveautés et l'actualité du projet. Envoyés par Pierre-Gilles Leymarie, le fondateur du projet. Désinscription possible à tout moment 🙂