Intégrer son robot aspirateur à Home Assistant : le guide 2026 pour des automatisations avancées

Avouons-le, nous avons tous vécu ce moment. Vous êtes en pleine visioconférence, un invité sonne à la porte ou, pire, vous profitez d'un rare moment de calme... et c'est précisément à cet instant que votre robot aspirateur Home Assistant décide de se lancer dans un vacarme assourdissant. Cette frustration est le symptôme d'un problème fondamental : les applications officielles, aussi jolies soient-elles, sont "stupides". Elles se basent sur un simple horaire, ignorant totalement le contexte de votre vie.

La véritable domotique, celle que nous recherchons avec Home Assistant, est bien plus ambitieuse. Elle est contextuelle, presque magique. Elle ne vous demande pas de sortir votre téléphone pour appuyer sur un bouton. Elle sait. Home Assistant est le "cerveau" de votre maison : il sait si vous êtes présent, si votre téléphone est en charge sur la table de nuit, si la télévision est allumée et même si votre agenda indique que vous travaillez le lendemain.

Ce guide est votre feuille de route pour transformer votre robot d'un gadget bruyant en un service invisible. Nous allons vous montrer comment choisir la bonne méthode d'intégration, surmonter les obstacles techniques (oui, nous parlerons du fameux "token") et, surtout, vous fournir le code YAML pour des automatisations qui, enfin, s'adaptent à votre vie.

En bref

Intégrez votre robot aspirateur à Home Assistant pour automatiser le nettoyage selon votre vie réelle.

• Choisissez entre les intégrations officielles (simples mais cloud), communautaires via HACS (avancées), ou Valetudo (100% local).
• Utilisez HACS pour accéder aux bibliothèques non supportées nativement par Home Assistant.
• Maîtrisez la récupération du token (pour les modèles Xiaomi/Roborock) pour garantir une communication locale fiable.
• Transformez votre robot en service invisible grâce à des automatisations contextuelles basées sur votre présence.

Le paysage 2026 : quelle méthode d'intégration choisir ?

Avant même d'écrire une ligne de code, vous êtes face à un choix stratégique. La méthode que vous choisirez aura un impact direct sur la facilité d'installation, la fiabilité au quotidien et la confidentialité de vos données. En 2026, trois philosophies coexistent.

Option 1 : les intégrations officielles (cloud)

C'est la voie la plus simple. Vous allez dans Paramètres > Appareils & Services, vous trouvez votre marque (pour configurer un aspirateur Tineco dans Home Assistant, Roborock ou iRobot), vous entrez votre login et mot de passe, et le tour est joué.

• Point fort : Extrêmement simple à configurer. Maintenu par l'équipe de Home Assistant.
• Point faible : Vous dépendez à 100% du cloud du fabricant. Si leurs serveurs tombent, votre intégration tombe. Pire, certains (comme Roborock) appliquent un "rate limiting" : si vous envoyez trop de commandes, ils vous bloquent temporairement.

Option 2 : la voie communautaire (HACS)

Le Home Assistant Community Store (HACS) est le cœur battant de l'innovation. Quand l'intégration officielle est limitée ou inexistante, par exemple pour gérer un robot ILife dans Home Assistant, la communauté prend le relais. C'est le cas pour des marques très populaires comme Dreame ou Ecovacs.

• Point fort : Offre des fonctionnalités bien plus avancées, souvent décrites comme un "remplacement complet de l'application" officielle.
• Point faible : C'est du code personnalisé. Une mise à jour de Home Assistant peut "casser" l'intégration, vous obligeant à attendre un correctif du développeur. La fiabilité est bonne, mais demande un peu plus d'implication.

Option 3 : l'experte (Valetudo - 100% local)

Pour les puristes de la confidentialité et de la fiabilité, il y a Valetudo. Il ne s'agit pas d'une intégration, mais d'un firmware alternatif que vous installez directement sur le robot (après l'avoir "rooté"). Valetudo remplace totalement le cloud du fabricant.

• Point fort : Fiabilité absolue (zéro cloud, zéro dépendance Internet), latence nulle et confidentialité totale (la carte de votre maison ne quitte jamais votre réseau).
• Point faible : Très technique à installer (nécessite d'ouvrir le robot sur certains modèles), annule la garantie et n'est compatible qu'avec une liste spécifique d'appareils.

Tableau comparatif rapide des méthodes

Marque	Méthode recommandée	Facilité	Fiabilité	Contrôle
Roborock	Officielle (local / cloud)	Facile	Élevée (Local MQTT)	Excellente
Xiaomi (Miio)	Officielle (local)	Difficile (Token)	Élevée	Excellente
Dreame	HACS	Moyenne	Bonne (fragile aux MAJ)	Excellente
Ecovacs	HACS / Core	Moyenne	Moyenne (bugs de reporting)	Bonne
iRobot	Officielle (Cloud)	Facile	Bonne	Basique
Modèles compatibles Valetudo	Manuelle (firmware)	Très difficile	Absolue	Totale (via MQTT)

Les prérequis indispensables (la boîte à outils)

Avant de vous lancer, il y a deux obstacles qui bloquent 90% des débutants. En les réglant maintenant, nous bâtissons la confiance : nous savons où sont les pièges et comment les éviter.

Tuto 1 : comment installer HACS (Home Assistant Community Store)

HACS est la porte d'entrée vers les meilleures intégrations communautaires (pour Dreame, Ecovacs ou la marque Eureka dans Home Assistant) et les cartes d'interface (Lovelace). Son installation est une étape unique.

1. Prérequis : Vous devez avoir un compte GitHub gratuit.
2. Téléchargement : Suivez les instructions officielles de HACS (généralement une simple commande à copier dans le terminal de Home Assistant).
3. Redémarrage : Redémarrez complètement Home Assistant.
4. L'astuce : Allez dans Paramètres > Appareils & Services. Vous ne voyez pas HACS dans la liste des intégrations à ajouter ? C'est normal. Videz le cache de votre navigateur (Ctrl+F5 ou Cmd+Shift+R). C'est l'oubli le plus fréquent.
5. Configuration : Ajoutez l'intégration HACS. Il vous donnera un code à copier.
6. Authentification : Collez ce code sur la page d'activation de GitHub pour lier votre Home Assistant à votre compte GitHub.

Tuto 2 : le défi du "token" Xiaomi/Roborock

Si vous optez pour l'intégration locale xiaomi_miio (la plus fiable pour les appareils Xiaomi et anciens Roborock), Home Assistant a besoin d'un "mot de passe" pour parler à votre robot : le token, une chaîne de 32 caractères.

Méthode simple 2025 (recommandée) :
La méthode de loin la plus "simple et rapide" est d'utiliser un outil qui interroge le cloud Xiaomi pour vous.

• Outil : Get Mi Home Devices Token App (disponible sur GitHub pour Windows et macOS).
• Processus : Lancez l'application, connectez-vous avec les identifiants de votre application Mi Home, et l'outil listera tous vos appareils et leurs tokens. Copiez-collez, c'est terminé.

Méthode alternative (iOS) :
Si la première échoue, la méthode de la sauvegarde iOS est infaillible.

1. Connectez votre iPhone à un PC/Mac et faites une sauvegarde locale non chiffrée via iTunes (ou le Finder).
2. Utilisez l'outil iBackup Viewer (gratuit) pour explorer cette sauvegarde.
3. Naviguez dans les "données brutes" jusqu'au dossier com.xiaomi.mihome.
4. Trouvez et extrayez le fichier ..._mihome.sqlite.
5. Ouvrez ce fichier avec DB Browser for SQLite (gratuit).
6. Allez dans l'onglet "Parcourir les données", trouvez la table ZDEVICEMODEL et cherchez la colonne ZTOKEN. Le token est là (il faudra peut-être le décrypter via un outil en ligne AES avec une clé standard).

Avertissement : Ce token est lié à votre réseau Wi-Fi. Si vous changez le mot de passe Wi-Fi ou si vous réinitialisez le robot, le token changera et votre intégration sera cassée jusqu'à ce que vous extrayiez le nouveau.

Guide d'intégration détaillé

Maintenant que la boîte à outils est prête, voici le vif du sujet. Nous allons cibler les marques les plus populaires pour vous guider précisément.

Roborock et Xiaomi (l'écosystème Miio)

• Méthode : Si vous utilisez l'application officielle Roborock (S-Series, Q-Series, Qrevo...), privilégiez l'intégration entre Home Assistant et Roborock proposée officiellement (Hybride Cloud/Local MQTT). Si vous avez un appareil Xiaomi ou un Roborock plus ancien (S5, S6) et que vous avez extrait le token, utilisez l'intégration officielle xiaomi_miio (Local).
• Dépannage :
  • Erreur "No devices were found" : Votre modèle est probablement trop récent et pas encore supporté par l'API. Assurez-vous que HA est à jour et patientez.
  • Erreur "Rate limiting" : L'intégration devient "indisponible" ou votre IP est bloquée. Vous avez fait trop d'appels à l'API ou créé des automatisations rechargeant l'intégration en boucle (ce qui cause des bannissements d'IP temporaires ou définitifs). Ne forcez pas le rechargement : la seule solution est de désactiver l'intégration pendant 24 heures complètes pour réinitialiser votre compteur côté serveur et la laisser gérer seule sa reconnexion.

Dreame (la puissance via HACS)

• Méthode : Pour l'intégration de Dreame dans Home Assistant, la solution officielle est quasi inexistante. Le standard de fait est Tasshack/dreame-vacuum, à installer via HACS (optez pour la version v2.0+ pour gérer les comptes Dreamehome et modèles récents).
• Dépannage :
  • Erreur "Login failed" : Vous êtes 100% sûr de votre mot de passe, mais ça ne fonctionne pas. C'est un problème de serveur. Lors de la configuration, vous devez choisir le bon serveur (`cn` pour Chine, `eu` pour Europe, etc.) sur lequel votre compte a été créé à l'origine dans l'application Dreame ou Dreamehome.
  • Panne post-mise à jour HA : Vous mettez Home Assistant à jour et l'intégration Dreame ne démarre plus. C'est le risque de HACS. La seule solution : être patient et attendre que le développeur de l'intégration publie un correctif.

Ecovacs (la solution communautaire)

• Méthode : Bien que l'intégration officielle ait nettement évolué (Area Mapping natif depuis HA 2026.3, séries DEEBOT et GOAT), la communauté recourt souvent au module HACS pour Ecovacs (comme Deebot 4 Home Assistant) pour débloquer un contrôle total.
• Dépannage : Pour la gestion d'Ecovacs avec Home Assistant, le suivi en temps réel s'est grandement amélioré avec 20 à 30 entités exposées, mais passant par l'API cloud, de légers retards de synchronisation de l'état du robot peuvent parfois encore survenir.

iRobot (l'intégration facile)

• Méthode : L'intégration officielle est mature (présente sur 2,1 % des instances actives en Local Push) et qualifiée de "très facile" par la communauté. Elle fonctionne en local via MQTT chiffré (avec une latence sous la seconde) et gère très bien les commandes de base (start, stop, dock) ainsi que les métriques d'état (batterie, bac plein).

Comment intégrer le Dreame X50 Ultra dans Home Assistant ?

Le Dreame X50 Ultra représente le sommet de la robotique domestique en 2026, mais son intégration dans Home Assistant demande une méthode bien précise. Pour connecter ce modèle haut de gamme, utilisez le composant personnalisé Tasshack/dreame-vacuum disponible sur HACS.

Lors de la configuration, connectez-vous avec vos identifiants Dreamehome en sélectionnant le serveur régional européen. Cette intégration prend en charge la référence exacte du X50 Ultra (dreame.vacuum.r2532h) et expose l'ensemble des commandes avancées : suivi de la station multifonction, contrôle des serpillières, niveau d'eau et niveau de batterie, vous permettant de créer des automatisations sur mesure.

Comment connecter le MOVA Z60 Ultra à Home Assistant ?

Le MOVA Z60 Ultra partage le même écosystème que Dreame. Pour réussir l'intégration de ce robot aspirateur dans Home Assistant, l'intégration officielle reste insuffisante. Vous devez passer par le composant personnalisé Tasshack/dreame-vacuum via HACS.

Afin de prendre en charge le MOVA Z60, installez impérativement la version bêta (v2.0+) de l'intégration dans HACS. Lors de la configuration, renseignez vos identifiants de l'application MOVAhome ou Dreamehome en sélectionnant le serveur européen. Vous récupérerez ainsi l'intégralité des entités de votre Z60 Ultra : niveau de batterie, gestion de la station de lavage, état du bac et cartographie.

Comment intégrer le Dreame L50 Pro Ultra dans Home Assistant ?

Le Dreame L50 Pro Ultra s'intègre très efficacement grâce au composant personnalisé Tasshack/dreame-vacuum accessible via HACS. Pour garantir la détection correcte du Dreame L50 dans Home Assistant et éviter les messages d'erreur au premier démarrage, veillez à utiliser la version bêta ou v2.0+ de l'intégration.

Au moment de la configuration initiale, privilégiez la connexion avec vos identifiants Dreamehome (et non Xiaomi) et spécifiez impérativement le bon serveur régional (Europe). Une fois relié, le robot expose la cartographie multi-étages en direct, l'état complet de la station de lavage et l'ensemble des commandes pour enrichir vos automatisations.

Le cœur du guide : 3 automatisations avancées (code YAML fourni)

C'est ici que la magie opère. Avoir le robot dans Home Assistant, c'est bien. Lui faire faire ce que vous voulez, quand vous le voulez, c'est le but. Voici le code pour des scénarios que les applications officielles ne pourront jamais gérer.

Automatisation 1 : "Zéro contrainte" (nettoyage maison vide)

Le problème : Le robot dérange tout le monde.

La logique : Le robot démarre uniquement si la maison est confirmée comme vide depuis au moins 5 minutes (pour éviter les faux départs si vous allez juste chercher le courrier). On suppose que vous avez un group.all_occupants qui suit la présence des membres du foyer.

alias: 'Robot: Nettoyage quand la maison est vide'
trigger:
  - platform: state
    entity_id: group.all_occupants
    to: 'not_home'
    for:
      minutes: 5
condition:
  # Optionnel : ne pas lancer la nuit
  - condition: time
    after: '08:00:00'
    before: '21:00:00'
action:
  - service: vacuum.start
    target:
      entity_id: vacuum.votre_robot

Automatisation 2 : "Nettoyage nocturne intelligent"

Le problème : Vous voulez que le robot passe la nuit, mais seulement si vous travaillez le lendemain et que tout le monde dort.

La logique (basée sur un cas réel) : Déclencheur à 2h00 du matin. Conditions (ET) : "on travaille demain" (via l'intégration workday_sensor) + "le téléphone de l'occupant 1 est en charge" + "le téléphone de l'occupant 2 est en charge" + "la TV du salon est éteinte" + "aucun mouvement détecté au salon depuis 20 minutes".

alias: 'Robot: Nettoyage nocturne intelligent'
trigger:
  - platform: time
    at: '02:00:00'
condition:
  - condition: and
    conditions:
      # Condition 1: On travaille demain
      - condition: state
        entity_id: binary_sensor.workday_sensor
        state: 'on'
      # Condition 2: Occupant 1 couché (téléphone en charge)
      - condition: state
        entity_id: sensor.telephone_occupant_1_etat_batterie
        state: 'charging'
      # Condition 3: Occupant 2 couché (téléphone en charge)
      - condition: state
        entity_id: sensor.telephone_occupant_2_etat_batterie
        state: 'charging'
      # Condition 4: La TV du salon est éteinte
      - condition: state
        entity_id: media_player.tv_salon
        state: 'off'
      # Condition 5: Personne n'a bougé dans le salon depuis 20 min
      - condition: state
        entity_id: binary_sensor.mouvement_salon
        state: 'off'
        for:
          minutes: 20
action:
  - service: vacuum.start
    target:
      entity_id: vacuum.votre_robot

Automatisation 3 : "Pause sur détection"

Le problème : Le robot tourne la nuit (grâce à l'automatisation 2), mais vous vous levez pour aller aux toilettes et il vous fonce dans les pieds.

La logique : Si le robot est en nettoyage ET qu'un mouvement est détecté dans le couloir, le robot se met en pause. Il attend ensuite que le capteur de mouvement repasse à 'off' (plus de mouvement), attend une minute de plus pour être sûr, puis reprend son nettoyage.

alias: 'Robot: Pause si mouvement détecté'
mode: queued # Gère les détections multiples sans annuler la séquence
trigger:
  - platform: state
    entity_id: binary_sensor.mouvement_couloir
    to: 'on'
condition:
  # Ne rien faire si le robot n'est pas déjà en train de nettoyer
  - condition: state
    entity_id: vacuum.votre_robot
    state: 'cleaning'
action:
  # 1. Mettre le robot en pause
  - service: vacuum.pause
    target:
      entity_id: vacuum.votre_robot
  # 2. Attendre que le mouvement s'arrête (max 5 min)
  - wait_for_trigger:
      - platform: state
        entity_id: binary_sensor.mouvement_couloir
        to: 'off'
    timeout: '00:05:00'
  # 3. Attendre 1 minute supplémentaire pour être sûr
  - delay: '00:01:00'
  # 4. Reprendre le nettoyage (seulement si le robot est toujours en pause)
  - condition: state
    entity_id: vacuum.votre_robot
    state: 'paused'
  - service: vacuum.start
    target:
      entity_id: vacuum.votre_robot

L'interface de l'expert : scripts et dashboard Lovelace

Les automatisations sont puissantes, mais parfois, vous voulez juste nettoyer la cuisine après le dîner. Pour cela, nous utilisons des scripts et une interface Lovelace.

Maîtriser les scripts pour le nettoyage de zone (YAML)

L'objectif : Créer un bouton "Nettoyer la Cuisine" que vous pouvez appeler depuis votre tableau de bord, une automatisation, ou même via Google Assistant/Alexa.

Le service clé (pour Xiaomi/Roborock) : xiaomi_miio.vacuum_clean_zone. Ce service demande des coordonnées pour définir un rectangle sur votre carte.

L'Astuce : Comment obtenir ces satanées coordonnées ? C'est la question que tout le monde se pose. La réponse est simple : utilisez la carte Lovelace (point suivant) avec l'option debug: true. Dessinez un carré sur la carte, et les coordonnées exactes s'afficheront dans la console de débogage de votre navigateur !

Exemple de code (à placer dans scripts.yaml) :

# scripts.yaml
vacuum_kitchen_with_zone:
  alias: "Robot: Nettoyer la Cuisine (Zone)"
  mode: single # Empêche le script de se lancer plusieurs fois
  icon: "mdi:robot-vacuum"
  sequence:
    - service: xiaomi_miio.vacuum_clean_zone
      target:
        entity_id: vacuum.votre_robot
      data:
        # Coordonnées obtenues via la carte Lovelace en mode debug
        zone:
          - 
        repeats: 1 # Nombre de passages

Une fois ce script créé, vous avez une nouvelle entité script.vacuum_kitchen_with_zone que vous pouvez ajouter comme un simple bouton.

La carte Lovelace indispensable : xiaomi-vacuum-map-card

Pour un contrôle visuel, il n'y a qu'une seule référence, un véritable standard communautaire qui démontre l'Autorité de HACS : la lovelace-xiaomi-vacuum-map-card.

• L'outil : À installer via HACS.
• Pourquoi elle est universelle : Ne vous fiez pas à son nom. Cette carte est devenue un projet universel qui supporte officiellement plus de 8 marques et systèmes dont Xiaomi, Roborock, Dreame, Ecovacs, Valetudo et même Roomba.
• Fonctionnalités : Elle affiche la carte en direct, vous permet de dessiner des zones, de sélectionner des pièces ou de cliquer sur un point "goto" du bout du doigt.
• Info 2026 : La puissance de cette carte HACS (désormais en version v2.3.2) est telle que l'intégration officielle Roborock et le Core Home Assistant ont été mis à jour spécifiquement pour assurer la compatibilité avec elle et gérer directement les entités image. La communauté innove, et le "Core" s'adapte.

Bonus : le Graal de la détection de présence fiable

J'ai une dernière confidence à vous faire. Vos automatisations (surtout la n°1) ne seront fiables que si votre détection de présence l'est. C'est le point de défaillance de 99% des installations domotiques.

Vous pouvez aussi lire l'article : Fausse alarme de détecteur de mouvement : le guide 2025 pour éviter les déclenchements intempestifs

Niveau 1 (maison/absent) : le problème des iPhones

Suivre si vous êtes "à la maison" ou "absent" est la base.

• Le piège : N'utilisez pas l'intégration iCloud officielle. Elle est lente et, pire, elle génère un "spam" de notifications d'authentification à deux facteurs (2FA) qui vous rendra fou. L'application Home Assistant Companion sur iOS est meilleure, mais Apple la "tue" agressivement en arrière-plan pour sauver la batterie. Le suivi Wi-Fi (via votre routeur) est excellent pour détecter une arrivée, mais très lent (parfois 30 min) pour détecter un départ, car les téléphones coupent le Wi-Fi en veille.
• La solution : La communauté a, là encore, réglé le problème. L'intégration iCloud3 (disponible sur HACS) est la solution de facto pour un suivi réactif, fiable, et qui ne souffre pas des problèmes de 2FA.

Niveau 2 (présence par pièce) : PIR vs mmWave

Pour l'automatisation n°3 ("Pause sur détection"), vous devez savoir si quelqu'un est dans la pièce.

• PIR (classique) : Le capteur de mouvement standard (infrarouge passif). Il ne détecte que le mouvement. Si vous êtes assis immobile en train de lire, le capteur vous considère "absent". C'est le "faux négatif" classique.
• mmWave (radar 2025) : La solution moderne. Ces capteurs radars (ex : Aqara FP2, Everything Presence One) détectent la présence statique, y compris les micro-mouvements de votre respiration. Ils résolvent le problème du PIR.
• ESPresense (expert) : Pour savoir qui est dans quelle pièce. On place des balises ESP32 dans la maison qui triangulent la position de votre Apple Watch ou de votre Mi Band (via Bluetooth). C'est le niveau ultime.

L'astuce : la fiabilité absolue vient de la superposition. Un expert n'utilise jamais un seul capteur. L'état "occupant 1 est couché" est une combinaison de : `iCloud3` dit "maison" + `ESPresense` dit "chambre" + `sensor.telephone` dit "charging".

Conclusion : votre maison, vos règles

Nous avons parcouru un long chemin. Du robot "stupide" qui vous dérange, nous sommes passés à un assistant domestique autonome, conscient de son environnement. L'intégration dans Home Assistant est un voyage qui commence par un choix stratégique (Cloud facile, HACS puissant, ou Valetudo fiable), qui surmonte des obstacles techniques (le token !) et qui culmine dans la création de règles qui reflètent votre vie.

En choisissant des solutions locales, en vous appuyant sur l'expérience de la communauté HACS et en maîtrisant le code YAML, vous reprenez le contrôle. L'objectif de la domotique n'a jamais été d'avoir des télécommandes sur un téléphone, c'est de créer un foyer qui anticipe vos besoins. Vous avez maintenant les clés pour y parvenir.

Questions fréquentes sur l'intégration de votre robot aspirateur

Quelle méthode d'intégration est la plus fiable pour mon robot aspirateur ?

L'intégration via HACS (voie communautaire) est souvent recommandée pour une meilleure réactivité et moins de dépendance envers les serveurs cloud des constructeurs. Cependant, les intégrations officielles sont préférables si vous privilégiez la simplicité d'installation et la maintenance simplifiée.

Est-il possible d'utiliser mon aspirateur si le cloud du fabricant est en panne ?

Si vous utilisez une intégration cloud officielle, vous perdrez le contrôle en cas de panne serveur. Pour garantir un fonctionnement local, recherchez des intégrations supportant le contrôle en réseau local (LAN) ou envisagez des modèles compatibles avec des firmwares alternatifs comme Valetudo.

Comment éviter que mon robot ne se lance pendant mes réunions ?

Grâce à Home Assistant, vous pouvez créer une automatisation conditionnelle. Utilisez des capteurs comme l'état de votre calendrier, le statut de votre application de visioconférence ou la présence de votre téléphone sur votre bureau pour interdire le démarrage du cycle de nettoyage.

Qu'est-ce que le 'token' et pourquoi est-il nécessaire ?

Le token est une clé de chiffrement unique qui permet à Home Assistant de communiquer directement avec votre aspirateur. Il est indispensable pour authentifier les requêtes envoyées à l'appareil, surtout lorsque vous souhaitez contourner les limitations des applications propriétaires.