Ressources · Intégration n8n

Intégration Home Assistant n8nAutomatiser Home Assistant avec n8n.

Ta maison devient une étape de workflow comme une autre. L'intégration Home Assistant n8n donne accès à 13 opérations réparties sur 7 ressources : états, services, événements, journaux, templates, configuration et images de caméra. Aucun nœud trigger côté Home Assistant, donc le départ se fait ailleurs.

Tester l'intégration Home Assistant sur n8nVoir les 13 opérations

Avis vérifiés sur Trustpilot · Agence IA, automatisation & growth

Pourquoi automatiser

L'intégration Home Assistant n8n, à quoi ça sert vraiment ?

Home Assistant pilote la maison, n8n pilote tout ce qu'il y a autour. Le nœud interroge l'API REST de Home Assistant avec un jeton d'accès de longue durée : un workflow peut alors lire l'état de n'importe quelle entité, appeler un service, écrire un état, rendre un template ou récupérer une image de caméra sous forme de fichier. Au total 13 opérations sur 7 ressources, derrière un seul credential, c'est-à-dire la connexion enregistrée une fois dans n8n et réutilisée partout.

Premier usage, et de loin le plus courant : la maison réagit à ce qui se passe en dehors d'elle. Un mail de livraison arrive dans Gmail, le workflow lance service.call sur le domaine des notifications et la lampe du couloir change de couleur. Aucune ligne de YAML à écrire dans Home Assistant : la logique vit dans n8n, la maison exécute.

Deuxième usage : la maison rend des comptes. state.getAll renvoie l'ensemble des entités en une exécution, de quoi archiver chaque jour la température de toutes les pièces dans un document et garder un historique que Home Assistant ne conserve pas éternellement. Ajoute log.getLogbookEntries sur une plage horaire et tu obtiens le détail de ce qui a bougé pendant la nuit, entité par entité, exportable vers Google Docs.

Troisième usage : la maison s'occupe des gens. cameraProxy.getScreenshot dépose une image dans un champ binaire, prête à partir dans un message quand un capteur d'ouverture bascule. Et comme le nœud appelle les services par domaine, tout ce que Home Assistant connaît devient joignable : les ampoules du nœud Philipshue, mais aussi une enceinte pilotée par Spotify si l'intégration est déjà en place chez toi.

Là où le nœud s'arrête, HTTP Request prend le relais. L'API de Home Assistant expose bien plus que ces 7 ressources, l'historique et les calendriers par exemple, et le nœud HTTP Request appelle n'importe lequel de ces endpoints en réutilisant le même credential via l'authentification prédéfinie. Deux limites à connaître avant de construire : il n'existe pas de trigger Home Assistant, donc c'est un Schedule Trigger ou un Webhook n8n, une URL qu'un autre service vient appeler, qui lance le workflow ; et ton instance n8n doit pouvoir joindre l'hôte Home Assistant sur le réseau, ce qui se prépare quand n8n tourne en dehors de la maison.

Pour monter ce genre de workflow proprement du premier coup, la Formation n8n reprend les briques une par une.

Connexion

Comment connecter Home Assistant à n8n ?

  1. 01

    Générer un jeton d'accès de longue durée

    Connecte-toi à Home Assistant et ouvre ton profil utilisateur. Dans la section Long-Lived Access Tokens, génère un nouveau jeton et copie-le tout de suite : il ne s'affiche qu'une fois. C'est le seul secret dont le nœud a besoin, et c'est lui que n8n envoie à chaque appel vers ton instance. Garde-le de côté le temps de remplir le reste.

  2. 02

    Remplir le credential côté n8n

    Dans n8n, crée un credential Home Assistant, cette connexion enregistrée une fois que tu retrouves ensuite dans la liste déroulante de chaque workflow. Colle le jeton dans Access Token, puis saisis l'URL ou l'adresse IP de ton instance dans Host, sans le protocole devant : your.awesome.home, et surtout pas https://your.awesome.home.

  3. 03

    Régler le port et l'interrupteur SSL

    Pour Port, garde la valeur par défaut 8123 si tu accèdes à Home Assistant en http:// sans avoir touché à la configuration, saisis 443 si tu y accèdes en https://, ou indique ton propre port si tu en as configuré un. Active l'interrupteur SSL quand SSL est activé dans la clé config.yml, ou quand ton interface répond en https://.

Actions

Ce que le nœud Home Assistant sait faire

Le nœud Home Assistant expose 13 opérations sur 7 ressources. Pour chacune : le nœud tel que tu le configures dans n8n, les champs obligatoires, et nos notes de terrain.

Matrice ressources × opérations
RessourceCreateGetGet ManyCallCheck ConfigurationGet Error LogsGet Logbook EntriesGet ScreenshotCreate or Update
Camera Proxy✓
Config✓✓
Event✓✓
Log✓✓
Service✓✓
State✓✓✓
Template✓

Camera Proxy

1 opération
01

Get a screenshot

cameraProxy.getScreenshot

Ce que tu vois dans n8n

Notes & cas d'usage

Capture l'image courante d'une caméra et la transmet au workflow sous forme de fichier, pas de texte. Les nœuds suivants peuvent la joindre à un message ou la déposer dans un espace de stockage.

Paramètres clés

  • Camera Entity Name or ID : la caméra à photographier, choisie dans la liste que n8n charge depuis ton instance, ou définie par une expression comme {{ $json.entity_id }} quand un nœud précédent tranche.
  • Put Output File in Field : le nom du champ binaire de sortie dans lequel l'image atterrit, celui que tu réutilises pour l'envoyer.
Cas d'usage
la sonnette est actionnée, le workflow photographie l'entrée et pousse l'image dans la conversation familiale.

Config

2 opérations
02

Get the config

config.get

Ce que tu vois dans n8n

Notes & cas d'usage

Renvoie la configuration de l'instance Home Assistant telle que l'API la rapporte. Rien à remplir : l'opération n'a aucun paramètre, elle répond, point.

Cas d'usage
c'est le nœud de test idéal juste après avoir enregistré le credential, pour vérifier que l'hôte, le port et le jeton s'accordent avant de construire quoi que ce soit dessus. Placé dans un workflow planifié, il fait aussi un bon contrôle de vie : une connexion cassée se voit ici, pas au milieu d'un appel de service.
03

Check the config

config.check

Ce que tu vois dans n8n

Notes & cas d'usage

Demande à Home Assistant de valider sa propre configuration et renvoie le verdict. Pas de paramètre non plus, donc rien n'empêche de l'appeler souvent.

Cas d'usage
après une modification de tes fichiers Home Assistant, lance ce contrôle avant de redémarrer quoi que ce soit. Le workflow teste la configuration, puis se branche sur le résultat pour prévenir dans le salon quand la validation part en erreur. Bien plus agréable que de le découvrir parce que le chauffage ne répond plus.

Event

2 opérations
04

Create an event

event.create

Ce que tu vois dans n8n

Notes & cas d'usage

Émet un événement sur le bus d'événements de Home Assistant, pour que les automatisations déjà écrites là-bas réagissent à quelque chose qui vient de se passer dans n8n.

Paramètres clés

  • Event Type : l'identifiant d'entité pour lequel l'événement est créé, saisi en texte ou construit par une expression.
  • Event Attributes : charge utile optionnelle, ajoutée paire par paire avec Add Attribute, pour les données dont l'automatisation a besoin.
Cas d'usage
une affaire passe en gagnée dans le CRM, n8n émet l'événement, et Home Assistant décide tout seul quelle lampe clignote.
05

Get many events

event.getAll

Ce que tu vois dans n8n

Notes & cas d'usage

Liste les événements connus de l'instance, en un appel, sans filtre à configurer.

Paramètres clés

  • Return All : activé, n8n enchaîne les pages de l'API jusqu'à tout ramener ; désactivé, il s'arrête à Limit.
  • Limit : le nombre maximal d'événements renvoyés quand Return All reste désactivé.
Cas d'usage
de la reconnaissance. Une exécution pendant la phase de construction suffit à voir les noms d'événements que ton installation publie vraiment, à recopier ensuite dans Event Type.

Log

2 opérations
06

Get a log for an entity

log.getErroLogs

Ce que tu vois dans n8n

Notes & cas d'usage

Récupère le journal d'erreurs de l'instance tel que Home Assistant l'écrit. Aucun champ à remplir, l'opération renvoie ce qui s'y trouve.

Cas d'usage
un workflow nocturne lit ce journal et l'envoie là où tu regardes vraiment. Les intégrations qui ont cessé de parler à leur appareil apparaissent ici bien avant que quelqu'un remarque qu'un interrupteur ne répond plus, ce qui transforme un doute vague en information lisible.
07

Get all logs for an entity

log.getLogbookEntries

Ce que tu vois dans n8n

Notes & cas d'usage

Renvoie les entrées du logbook, l'historique lisible de ce qui a changé et à quel moment. Sans rien préciser, la réponse couvre la période récente ; les champs optionnels la resserrent.

Paramètres clés

  • Start Time : le début de la période, sous forme de date et heure.
  • End Time : la fin de cette même période.
  • Entity ID : limite le logbook à une seule entité au lieu de toute la maison.
Cas d'usage
un rapport hebdomadaire sur la porte de garage, pour répondre sans débat à la question de qui l'a ouverte.

Service

2 opérations
08

Call a service

service.call

Ce que tu vois dans n8n

Notes & cas d'usage

C'est par là qu'un workflow agit sur la maison. Le nœud choisit un domaine de services, puis un service à l'intérieur, et Home Assistant fait le reste : allumer une lampe, régler une température, lancer un script.

Paramètres clés

  • Domain Name or ID : la famille de services, prise dans la liste ou fournie par une expression comme {{ $json.domain }}.
  • Service Name or ID : le service dans ce domaine, même liste, même logique d'expression.
  • Service Attributes : les valeurs attendues par le service, ajoutées une paire à la fois avec Add Attribute.
Cas d'usage
un seul workflow du matin qui déverrouille le bureau, règle le thermostat et lance la playlist.
09

Get many services

service.getAll

Ce que tu vois dans n8n

Notes & cas d'usage

Renvoie les services disponibles sur l'instance, regroupés par domaine d'appartenance.

Paramètres clés

  • Return All : activé, tous les services reviennent, quel que soit le nombre de pages d'API à parcourir ; désactivé, la réponse s'arrête à Limit.
  • Limit : le nombre maximal de services renvoyés.
Cas d'usage
de la documentation à la source. Avant de câbler un appel, cette opération te donne les noms exacts de domaine et de service de ton installation, plutôt que ceux d'un article écrit sur une autre maison.

State

3 opérations
10

Create or update a state

state.upsert

Ce que tu vois dans n8n

Notes & cas d'usage

Écrit une valeur dans la machine à états. Si l'entité a déjà un état, il est remplacé ; sinon, l'entité apparaît avec la valeur envoyée.

Paramètres clés

  • Entity Name or ID : l'entité à laquelle l'état appartient, choisie dans la liste ou donnée par une expression.
  • State : la valeur elle-même, en texte.
  • State Attributes : des paires supplémentaires attachées à l'état, ajoutées avec Add Attribute.
Cas d'usage
faire entrer un chiffre métier dans la maison, pour qu'un écran mural affiche les commandes du jour à côté de la température.
11

Get a state

state.get

Ce que tu vois dans n8n

Notes & cas d'usage

Lit l'état courant d'une entité, avec ses attributs. Rien n'est modifié, ce qui rend l'opération sûre à placer devant n'importe quelle décision dans un workflow.

Paramètres clés

  • Entity Name or ID : l'entité à lire, prise dans la liste que n8n charge depuis ton instance, ou fournie par une expression quand un nœud précédent l'a choisie.
Cas d'usage
avant d'envoyer un rappel planifié, vérifier si quelqu'un est présent et sauter le message quand la réponse est non.
12

Get many states

state.getAll

Ce que tu vois dans n8n

Notes & cas d'usage

Renvoie l'état de toutes les entités d'un coup, le moyen le plus rapide de voir la maison entière en une seule exécution.

Paramètres clés

  • Return All : activé, n8n parcourt les pages de l'API jusqu'à ramener toute la machine à états ; désactivé, l'exécution s'arrête à Limit.
  • Limit : le nombre maximal d'états renvoyés.
Cas d'usage
une photographie quotidienne déposée dans un tableur, qui finit par donner un historique de capteurs exploitable en courbes.

Template

1 opération
13

Create a template

template.create

Ce que tu vois dans n8n

Notes & cas d'usage

Rend un template Home Assistant et en renvoie le résultat, ce qui permet de garder la logique en syntaxe Home Assistant au lieu de la reconstruire à coups de nœuds n8n.

Paramètres clés

  • Template : le template à rendre, écrit en texte ; la documentation Home Assistant sur les templates décrit la syntaxe.
Cas d'usage
fabriquer une phrase à partir de plusieurs capteurs, température intérieure et extérieure par exemple, puis envoyer cette ligne unique comme corps de message plutôt que trois lectures séparées.
Besoin d'aide

Besoin d'aide pour automatiser Home Assistant avec n8n ?

L'équipe te répond directement.

Chaque message est lu par une personne.

FAQ

Home Assistant et n8n, les questions qui suivent

01L'intégration Home Assistant n8n est-elle gratuite ?
Oui. Le nœud Home Assistant est livré avec n8n : rien à installer, aucun coût supplémentaire côté n8n. Le comportement est le même sur n8n Cloud, l'offre hébergée par n8n, et sur une instance que tu héberges toi-même avec Docker ou npm, en Community Edition sous licence Sustainable Use. Un workflow construit d'un côté tourne de l'autre sans modification. Home Assistant, de son côté, est un logiciel que tu fais déjà tourner chez toi, et le jeton d'accès qui relie les deux ne coûte rien non plus. Ce que tu paies, dans un cas comme dans l'autre, c'est le mode d'hébergement de n8n que tu as choisi, pas ce nœud en particulier.
02Quels identifiants faut-il pour connecter Home Assistant à n8n ?
Un jeton d'accès de longue durée, plus l'adresse de ton instance. Le jeton se génère depuis ton profil utilisateur Home Assistant, dans la section Long-Lived Access Tokens, puis se colle dans le champ Access Token de n8n. À côté, Host attend l'URL ou l'adresse IP sans aucun protocole devant, et Port attend 8123 par défaut pour une instance jointe en http, 443 quand tu y accèdes en https, ou la valeur que tu as configurée toi-même. Si SSL est activé dans la clé config.yml, ou si ton interface répond en https, active l'interrupteur SSL. Le credential est enregistré une fois et réutilisé dans tous les workflows suivants.
03Quelles sont les limites du nœud Home Assistant dans n8n ?
Le nœud couvre 7 ressources et 13 opérations, soit une partie de ce que l'API REST de Home Assistant expose. États, services, événements, journaux, configuration, templates et images de caméra sont pris en charge, le reste ne l'est pas. Quand il te manque un endpoint, le nœud HTTP Request l'appelle directement en réutilisant le même credential grâce à l'authentification prédéfinie, donc pas de second jeton à gérer. L'autre contrainte tient au réseau plus qu'aux fonctionnalités : ton instance n8n doit pouvoir joindre l'hôte et le port Home Assistant que tu as saisis, ce qui se prépare quand n8n tourne ailleurs que sur le réseau de la maison.
04Existe-t-il un trigger Home Assistant dans n8n ?
Non. Aucun nœud trigger Home Assistant n'existe dans n8n, donc un workflow ne peut pas rester en attente d'un mouvement dans la maison. Le départ vient d'ailleurs. Un Schedule Trigger exécute le workflow à intervalle fixe et lit l'état courant : c'est ce qu'il faut pour les résumés, les photographies quotidiennes et les contrôles de vie. Un Webhook n8n te donne une URL qu'un autre service appelle, et une automatisation Home Assistant peut appeler cette URL quand quelque chose bouge, ce qui remet la logique réactive du côté de la maison. Le trigger de n'importe quel autre outil fonctionne aussi, et c'est le schéma le plus répandu.
05n8n ou Make pour Home Assistant ?
Ça dépend surtout de l'endroit où vit ton instance. Make est hébergé par Make, sans option d'auto-hébergement, et se facture à l'opération. n8n tourne sur ton propre serveur si tu le souhaites, ce qui compte ici parce que Home Assistant habite en général un réseau local qu'une plateforme hébergée ne joint pas sans ouverture. Installer n8n à côté de Home Assistant garde le trafic et le jeton d'accès à la maison. Le modèle de coût diffère aussi : la facturation à l'opération pénalise les workflows qui relisent un état toutes les quelques minutes, exactement ce qu'une maison produit. Les deux se construisent visuellement, donc le choix se joue sur l'hébergement, la maîtrise des données et la fréquence d'exécution.
Même plateforme

Autres docs utiles sur ce stack.

Voir toutes les intégrations