Intégration domotique Voltalis, gratuite et open source

Boîtier Voltalis : radiateurs, chauffe-eau, modes, programmes, consommation, scènes et widgets.
Présentation
Cette intégration amène dans Gladys les appareils raccordés à votre boîtier Voltalis : radiateurs sur fil pilote, chauffe-eau, autres charges. Elle se connecte avec l’e-mail et le mot de passe de votre compte MyVoltalis, comme le fait l’application.
- Un appareil Gladys par équipement : mode (arrêt, manuel, programmation), préréglage (hors-gel, éco, confort), consigne quand l’équipement en accepte une, et un index d’énergie pour le tableau de bord énergie de Gladys.
- Un appareil pour le logement : puissance actuelle et index d’énergie.
- Des déclencheurs de scène (le mode d’un appareil change, un appareil passe en défaut ou revient à la normale) et des actions de scène (mode manuel pour une durée, retour à la programmation, programmes et réglages rapides, relevé immédiat).
- Trois widgets de tableau de bord : les appareils, avec les boutons « Retour au programme » et « Hors-gel », l’énergie d’aujourd’hui et des dernières 24 heures, et la connexion.
Transport : cloud. Gladys ne parle jamais directement à votre boîtier : elle lit et écrit le cloud Voltalis, qui relaie les changements. Un changement fait dans Gladys s’affiche aussitôt et est confirmé quelques secondes plus tard ; un changement fait dans l’application MyVoltalis ou par un programme atteint Gladys au relevé suivant. Vos données quittent votre domicile (c’est déjà le cas avec le boîtier Voltalis).
Sans lien avec Voltalis. Le service utilisé est celui de l’application MyVoltalis ; Voltalis ne le documente pas et peut le changer sans préavis. Pas encore testée sur un vrai boîtier Voltalis : dites-nous ce qui marche et ce qui ne marche pas.

Prérequis
- Gladys Assistant 5.3.0 ou plus récent.
- Un boîtier Voltalis installé chez vous (Voltalis n’équipe que des logements en France).
- Un compte MyVoltalis : vérifiez que vous pouvez vous connecter à l’application ou à myvoltalis.com avec votre e-mail et votre mot de passe. Voltalis ne propose pas d’accès séparé pour les tiers : l’intégration utilise le mot de passe de votre compte.
Configuration
Dans Gladys, ouvrez Intégrations → Voltalis :
| Champ | Description |
|---|---|
| L’e-mail de votre compte MyVoltalis. | |
| Mot de passe | Son mot de passe : envoyé à Voltalis uniquement, jamais réaffiché ni journalisé. |
| Intervalle de relevé | Toutes les 1, 2, 5 ou 10 minutes (2 par défaut). Une requête relève tous les appareils. |
| Langue des textes des appareils | Noms des fonctionnalités et messages du bouton ; automatique par défaut. |
Cliquez sur Tester la connexion : l’intégration relève vos appareils et les liste avec leur type et leurs fonctionnalités. Ouvrez ensuite l’onglet Découverte et ajoutez les appareils voulus, ainsi que l’appareil « Logement Voltalis » : rien n’est créé sans vous. Avec plusieurs logements sur le compte, seul le logement par défaut de MyVoltalis est relevé.
Utilisation
Appareils
Chaque équipement propose ces fonctionnalités, selon ce que MyVoltalis lui propose :
| Fonctionnalité | Type Gladys | Remarques |
|---|---|---|
| Mode | Mode de thermostat : arrêt, chauffage, auto | Arrêt : un arrêt manuel. Chauffage : un réglage manuel (ce que fait l’appareil est conservé). Auto : l’appareil suit sa programmation. |
| Préréglage | Préréglage de thermostat : hors-gel, éco, confort | Radiateurs seulement. En choisir un crée un réglage manuel jusqu’à nouvel ordre. |
| Consigne | Consigne de thermostat, de 7 à 30 °C par 0,5 °C | Seulement quand MyVoltalis propose le mode « température ». La changer crée un réglage manuel en mode température. |
| Énergie | Index d’énergie (kWh) | Compté par l’intégration d’après les heures mesurées par Voltalis ; alimente les pages de consommation et de coût de Gladys. |
L’appareil Logement Voltalis propose la puissance actuelle (les 10 dernières minutes mesurées par Voltalis) et un index d’énergie pour tout le logement.
Voltalis donne l’énergie heure par heure, avec un peu de retard : l’index avance quelques fois par heure, pas en continu. Il démarre avec les heures du jour où l’appareil est relevé pour la première fois : Gladys n’utilise que ses augmentations. Un boîtier ne mesure pas la température des pièces : il n’y a pas de capteur de température.
Widgets du tableau de bord
- Appareils Voltalis : chaque appareil avec ce qu’il fait et qui l’a décidé (la programmation, ou un réglage manuel et sa fin), un badge (manuel, défaut, commande en cours d’envoi). Touchez un appareil pour son détail. Retour au programme met fin aux réglages manuels des appareils du widget, Hors-gel passe leurs radiateurs en hors-gel, tous deux après confirmation ; Actualiser relève maintenant. Choisissez les appareils dans les réglages du widget (8 au plus).
- Énergie Voltalis : l’énergie d’aujourd’hui et d’hier, la puissance actuelle, et un graphique en barres des dernières 24 heures, pour tout le logement ou les appareils choisis dans les réglages.
- Voltalis : l’état de la connexion, les appareils en mode manuel, les appareils en défaut, les requêtes de la dernière heure, un bouton Actualiser.
Scènes
Déclencheurs (chacun peut être limité à un appareil) :
- Le mode d’un appareil change : par la programmation Voltalis ou dans l’application MyVoltalis, jamais par Gladys elle-même. Peut être limité à un nouveau mode ; le mode précédent est une variable.
- Un appareil passe en défaut / revient à la normale : l’autodiagnostic de Voltalis (défaut, aucune consommation vue, pas de communication).
Actions :
- Passer en mode manuel : confort, éco, hors-gel, une température, marche ou arrêt, pour un appareil ou tous ceux qui ont ce mode, pour un nombre d’heures ou jusqu’à nouvel ordre (sorties : changés, refusés).
- Revenir à la programmation : un appareil, ou tous les appareils en mode manuel.
- Activer ou désactiver un programme : les réglages rapides de MyVoltalis (à la maison, absence courte, absence longue) ou l’un de vos programmes, par son nom.
- Relever les appareils Voltalis maintenant : renvoie les appareils, ceux en mode manuel, la puissance et l’énergie d’aujourd’hui.
Exemples :
- Quand tout le monde quitte la maison → passer tous les radiateurs en hors-gel ; quand quelqu’un rentre → revenir à la programmation.
- Quand une fenêtre du salon s’ouvre → arrêter son radiateur pendant 1 heure.
- Quand un appareil passe en défaut → envoyer une notification « {{triggerEvent.data.device_name}} : {{triggerEvent.data.status}} ».
Transport
Le catalogue affiche le badge cloud : chaque requête part vers api.myvoltalis.com, avec votre e-mail et votre mot de passe. Le boîtier Voltalis n’offre aucun accès local.
Dépannage
- « Voltalis refuse les identifiants » : vérifiez l’e-mail et le mot de passe en vous connectant à l’application MyVoltalis. L’intégration réessaie toutes les 30 minutes, ou dès que vous les changez.
- Connecté, mais aucun appareil : le compte n’a aucun appareil sur son logement par défaut ; vérifiez dans MyVoltalis.
- Pas de préréglage ou pas de consigne sur un appareil : MyVoltalis ne lui propose pas ces modes (un relais, ou un radiateur sans mode température).
- L’énergie reste vide ou en retard : Voltalis remplit les heures avec un délai ; attendez la fin d’une heure.
- Une commande s’annule après quelques minutes : Voltalis ne l’a pas appliquée ; le tableau de bord revient à ce que dit le cloud. Vérifiez l’appareil dans MyVoltalis.
- Plus rien ne marche après une mise à jour de MyVoltalis : le service non documenté a peut-être changé ; signalez-le.
- Signalez un problème sur GitHub avec votre version de Gladys, la version de l’intégration et le résultat de « Tester la connexion ».
Paramètres de configuration
Voici les paramètres demandés par Voltalis dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Voltalis | section | Non | Pour se connecter : 1. Vérifiez que vous pouvez vous connecter à l’application MyVoltalis ou à myvoltalis.com avec votre e-mail et votre mot de passe. 2. Saisissez ci-dessous ce même e-mail et ce même mot de passe. 3. Dans l’onglet Découverte, ajoutez vos appareils et l’appareil « Logement Voltalis ». L’intégration utilise le service de l’application MyVoltalis, que Voltalis ne documente pas : il peut changer sans préavis. Une commande atteint les appareils par le cloud Voltalis, et un changement fait dans l’application atteint Gladys au relevé suivant. |
string | Oui | L’e-mail de votre compte MyVoltalis. | |
| Mot de passe | secret | Oui | Le mot de passe de votre compte MyVoltalis. Envoyé à Voltalis uniquement, jamais réaffiché. |
| Intervalle de relevé | select | Non | Une seule requête relève tous les appareils. Le diagnostic et la consommation sont relevés moins souvent (10 et 15 minutes). |
| Langue des textes des appareils | select | Non | Noms des fonctionnalités et messages du bouton ci-dessous. Automatique : la langue du tableau de bord dès qu’un widget est affiché. |
Comment installer Voltalis dans Gladys
- Dans Gladys, ouvrez Intégrations : Voltalis 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/william-de71/gladys-voltalis:0.1.0), 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/William-De71/gladys-voltalis.
Voltalis nécessite Gladys >=5.3.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
Voltalis 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 William-De71, 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