Lier Home Assistant

Dites « éteins la lumière de la cuisine » à un appareil Thalovant, à la maison ou ailleurs, et Home Assistant s’en occupe. Le lien part de Home Assistant vers votre hub : vous le configurez donc dans Home Assistant, pas dans le tableau de bord Thalovant.

Comment une demande arrive chez vous

Lorsqu’un de vos appareils entend une demande destinée à la maison, votre hub transmet la phrase à votre Home Assistant. Assist, l’assistant vocal de Home Assistant, interprète la demande et agit. Sa réponse revient au hub, puis l’appareil qui a posé la question la prononce.

Les autres demandes, comme la météo ou une minuterie, vont toujours aux compétences habituelles du hub. Seules les commandes de la maison prennent ce chemin.

Ce qu’il vous faut

Il vous faut Home Assistant 2026.9 ou une version ultérieure, avec HACS installé, ainsi qu’un compte Thalovant. Il vous faut aussi un hub qui peut être lié à Home Assistant : vos propres hubs et les hubs publics comme Daily Desk le permettent.

Avec le forfait Free, vous utilisez un hub public. Voyez les détails du forfait gratuit.

Installez l’intégration

L’intégration ne fait pas encore partie de la liste par défaut de HACS. Vous devez d’abord l’ajouter comme dépôt personnalisé.

1. Ouvrez HACS dans Home Assistant.
2. Ajoutez le dépôt. Ouvrez le menu à trois points en haut à droite, puis Dépôts personnalisés (Custom repositories). Collez https://github.com/thalovant/ha-thalovant, choisissez le type Intégration et sélectionnez Ajouter.
3. Téléchargez l’intégration. Recherchez Thalovant dans HACS, ouvrez sa page et sélectionnez Télécharger.
4. Redémarrez Home Assistant. L’intégration se charge au prochain démarrage.

Si votre installation accepte les liens My Home Assistant, ouvrez le dépôt Thalovant dans HACS pour effectuer les deux premières étapes.

Liez votre hub

1. Ajoutez l’intégration. Ouvrez Paramètres > Appareils et services, sélectionnez Ajouter une intégration, puis Thalovant.
2. Obtenez un code. Sélectionnez Valider. Home Assistant affiche un lien et un code de huit caractères.
3. Approuvez la connexion. Ouvrez le lien et connectez-vous à Thalovant. La page nomme la demande Home Assistant et l’identifie comme une application enregistrée auprès de Thalovant. Vérifiez que le code correspond, puis approuvez l’accès.
4. Choisissez le hub. La fenêtre Home Assistant passe automatiquement à l’étape suivante. Les hubs qui peuvent être liés apparaissent en premier; les autres indiquent pourquoi ils ne le peuvent pas.
5. Attendez le hub. L’admission d’un nouveau lien prend environ une minute et demie. Home Assistant ajoute l’intégration une fois le lien prêt.

Le lien fonctionne lorsque le capteur Connexion au hub est actif et que la page Connexions du hub indique une connexion de type Home Assistant. Demandez à un de vos appareils d’allumer quelque chose pour l’essayer.

Chaque hub a son propre lien. Pour accéder à votre maison depuis un deuxième hub, ajoutez de nouveau l’intégration et choisissez ce hub.

Ce que votre voix peut commander

Seulement ce que vous avez exposé à Assist. Home Assistant le détermine dans Paramètres > Assistants vocaux > Exposer. La même liste s’applique aux demandes de Thalovant. Si un appareil n’y figure pas, Thalovant ne peut pas le commander. Le guide Home Assistant sur les appareils exposés à Assist explique aussi les noms et les alias.

Le hub transmet les phrases qui ressemblent à des commandes domestiques :

• allumer ou éteindre les lumières, les prises et les ventilateurs, ou régler l’intensité des lumières;
• ouvrir ou fermer les stores, les portails et le garage;
• verrouiller ou déverrouiller les portes;
• régler le thermostat ou lancer une scène;
• demander si une porte est verrouillée ou si le garage est ouvert.

Le français et l’anglais fonctionnent aujourd’hui. Home Assistant répond dans la langue utilisée par l’appareil.

L’agent intégré d’Assist répond par défaut. Pour choisir un autre agent de conversation déjà installé, ouvrez l’intégration et sélectionnez Configurer. L’agent doit répondre en moins de dix secondes; sinon, l’appareil indique que Home Assistant a pris trop de temps.

Indiquez la pièce une seule fois

Dites « éteins les lumières » sans nommer de pièce, et Assist choisit celles de la pièce où se trouve l’appareil qui vous a entendu. Pour cela, Home Assistant doit connaître l’emplacement de chaque appareil Thalovant.

À sa première demande, chaque appareil Thalovant qui utilise le lien obtient son propre appareil dans Home Assistant, sous celui du hub. Attribuez-lui une zone :

1. Faites une demande à l’appareil pour qu’il apparaisse.
2. Ouvrez sa fiche. Allez dans Paramètres > Appareils et services > Thalovant, puis ouvrez l’appareil indiqué sous votre hub.
3. Attribuez sa zone, c’est-à-dire la pièce où il se trouve.

L’appareil reprend son nom dans Thalovant. Si vous le renommez dans Home Assistant, ce nom est conservé. Sans zone attribuée, Assist ne connaît pas sa pièce : nommez-la dans votre demande.

Il faut la version 0.2.0 de l’intégration ou une version ultérieure. HACS vous propose la mise à jour si vous avez une version plus ancienne.

Quand Home Assistant pose une question

Assist peut avoir besoin d’une précision avant d’agir. Si vous dites « allume la lumière » dans une pièce qui en compte deux, il peut demander laquelle. L’appareil reste à l’écoute après la question : répondez « la lampe du bureau » sans répéter le mot d’activation. Votre réponse retourne à Home Assistant dans le même échange.

Sans réponse de votre part, la question est oubliée après quelques minutes. Votre prochaine demande commence un nouvel échange.

Qui peut commander votre maison

Seulement les appareils connectés à votre propre compte Thalovant, sur le hub lié. Le hub vérifie à qui appartient l’appareil et transmet la demande uniquement au Home Assistant de ce compte. Le nom donné par l’appareil ne détermine pas cet accès.

Cela s’applique aussi aux hubs publics. Les autres personnes qui utilisent Daily Desk ne peuvent pas atteindre votre Home Assistant avec leurs appareils.

Ce qui reste chez vous

Home Assistant ouvre lui-même le lien, comme un haut-parleur Thalovant se connecte à son hub. Aucun port à rediriger, aucun abonnement Nabu Casa requis, et aucun jeton Home Assistant ne quitte votre domicile.

Ce qui circule : la phrase entendue et sa langue, du hub vers Home Assistant, puis la réponse d’Assist en sens inverse. Home Assistant n’envoie pas ses propres demandes au hub, et votre liste d’entités reste chez vous.

Home Assistant conserve les clés de la connexion et une connexion à Thalovant limitée à la liste de vos hubs et à la gestion de son lien. Vous pouvez consulter et révoquer cette dernière sous Jetons d’API. Les diagnostics de l’intégration excluent les jetons, les clés et le contenu des échanges.

Avec le forfait gratuit

Un compte Free peut lier Home Assistant aux hubs publics, comme Daily Desk. Ce lien n’utilise pas votre connexion incluse : votre téléphone ou votre haut-parleur garde sa place. La connexion depuis Home Assistant ne consomme pas non plus votre quota de jetons d’API.

Chaque compte dispose d’un lien par hub. Voyez ce que permet le forfait gratuit pour les autres limites.

Quand une demande ne fonctionne pas

L’appareil explique le problème à voix haute. Voici les situations possibles et les vérifications utiles.

Home Assistant n’est pas encore lié. Ce hub n’a pas de lien Home Assistant pour le compte de l’appareil. Créez le lien depuis Home Assistant et vérifiez que les deux utilisent le même compte Thalovant.

Home Assistant est injoignable. Le lien existe, mais Home Assistant n’est pas connecté. Vérifiez qu’il fonctionne et que le capteur Connexion au hub est actif. Le lien se rétablit automatiquement après un redémarrage ou une coupure réseau; réessayez après une minute.

Home Assistant n’a pas compris ou n’a pas trouvé l’appareil. Essayez la même phrase dans Assist. Si elle échoue aussi, vérifiez que l’appareil est exposé et que vous utilisez son nom ou un de ses alias.

Home Assistant a pris trop de temps à répondre. L’agent a dépassé les dix secondes d’attente du hub. Cela peut arriver avec un agent utilisant un grand modèle de langage.

Les commandes domestiques ne sont pas disponibles sur ce hub. Le hub ne peut pas transmettre de demandes à Home Assistant pour le moment. Modifier votre installation ne résoudra pas ce problème.

Messages dans Home Assistant

Votre forfait ne permet de lier Home Assistant qu’à des hubs publics. Choisissez un hub public comme Daily Desk, ou changez de forfait pour utiliser votre propre hub.

Un autre Home Assistant est déjà lié à ce hub. Votre compte y possède déjà un lien. Supprimez-le dans Connexions, puis recommencez.

Le code a expiré ou la connexion a été refusée. Sélectionnez Valider pour obtenir un nouveau code.

Home Assistant vous demande de vous reconnecter. Le hub n’accepte plus le lien, souvent parce qu’il a été supprimé dans Connexions. Suivez la notification. Home Assistant crée un nouveau lien et ne demande une nouvelle connexion au compte que si l’ancienne ne fonctionne plus.

Après un changement de clé du hub

Home Assistant mémorise la clé de sécurité du hub au moment de la liaison. Si le hub présente une autre clé, Home Assistant cesse de lui parler et affiche une réparation indiquant qu’il a répondu avec une autre clé de sécurité.

C’est attendu si le hub a été remplacé ou réinitialisé. Ouvrez alors Paramètres > Appareils et services > Thalovant et suivez la demande de réauthentification. La nouvelle liaison fait confiance à la clé actuelle.

Si vous ne vous attendiez pas à ce changement, vérifiez d’abord le hub dans le tableau de bord Thalovant.

Attention

Ne publiez pas votre code de connexion, les clés du lien ni des diagnostics Home Assistant contenant des jetons dans une discussion de soutien publique.

Dissocier Home Assistant

Supprimez l’entrée de l’intégration sous Paramètres > Appareils et services > Thalovant. Le lien est supprimé du hub. La connexion au compte Thalovant est partagée entre les entrées Home Assistant de ce compte : elle n’est révoquée qu’à la suppression de la dernière entrée. Si Thalovant est injoignable, supprimez le lien de type Home Assistant dans Connexions et révoquez la connexion sous Jetons d’API si elle n’est plus nécessaire.

Vous pouvez aussi supprimer le lien dans Connexions en premier. Home Assistant vous demande alors de vous reconnecter; vous pouvez plutôt y supprimer l’entrée.