Intégrer son robot aspirateur à Home Assistant : le guide 2025

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 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.

Contenus masquer

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

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

Guide d'intégration détaillé

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

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

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

Conclusion : votre maison, vos règles

Le paysage 2025 : 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 2025, 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 (comme 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, 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 (cloud)	Facile	Moyenne (rate limiting)	Bonne
Xiaomi (Miio)	Officielle (local)	Difficile (Token)	Élevée	Excellente
Dreame	HACS	Moyenne	Bonne (fragile aux MAJ)	Excellente
Ecovacs	HACS	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 (Dreame, Ecovacs) et les cartes d'interface (Lovelace). Son installation est une étape unique.

Prérequis : Vous devez avoir un compte GitHub gratuit.
Téléchargement : Suivez les instructions officielles de HACS (généralement une simple commande à copier dans le terminal de Home Assistant).
Redémarrage : Redémarrez complètement Home Assistant.
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.
Configuration : Ajoutez l'intégration HACS. Il vous donnera un code à copier.
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.

Connectez votre iPhone à un PC/Mac et faites une sauvegarde locale non chiffrée via iTunes (ou le Finder).
Utilisez l'outil iBackup Viewer (gratuit) pour explorer cette sauvegarde.
Naviguez dans les "données brutes" jusqu'au dossier com.xiaomi.mihome.
Trouvez et extrayez le fichier ..._mihome.sqlite.
Ouvrez ce fichier avec DB Browser for SQLite (gratuit).
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 avez un Roborock récent, utilisez l'intégration officielle Roborock (Cloud). 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". Vous avez fait trop d'appels à l'API. La seule solution est de désactiver l'intégration pendant 24 heures complètes pour réinitialiser votre compteur côté serveur.

Dreame (la puissance via HACS)

Méthode : L'intégration officielle est quasi inexistante. Le standard de fait est Tasshack/dreame-vacuum, à installer via HACS.
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.
- 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 : L'intégration officielle est très limitée. La communauté s'est tournée vers des solutions HACS (comme hacc-ozmo ou d'autres) pour obtenir un meilleur contrôle.
Dépannage : Attendez-vous à des "ratés au niveau du reporting". Il est fréquent que l'état du robot (en nettoyage, à quai) ne soit pas parfaitement synchronisé avec Home Assistant.

iRobot (l'intégration facile)

Méthode : L'intégration officielle est mature et qualifiée de "très facile" par la communauté. Elle se connecte au cloud iRobot et fonctionne bien pour les commandes de base (start, stop, dock).

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 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 2025 : La puissance de cette carte HACS est telle que l'intégration officielle Roborock a été mise à jour spécifiquement pour assurer la compatibilité avec elle. 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.