Ressources · Intégration n8n

Intégration MQTT n8nAutomatiser MQTT avec n8n.

Tes machines parlent déjà à un broker, autant que n8n écoute la même ligne. Une intégration MQTT n8n tient en deux nœuds : le nœud MQTT publie un message sur un topic que tu choisis, le MQTT Trigger s'abonne à des topics et lance le workflow quand un message arrive. Une opération, un credential.

Tester l'intégration MQTT sur n8nVoir les 1 opérations

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

Pourquoi automatiser

Ce que l'intégration MQTT n8n change concrètement

MQTT fonctionne en publication et abonnement : un équipement envoie un message sur un topic hébergé par un broker, et tout ce qui est abonné à ce topic en reçoit une copie. n8n fournit deux nœuds pour ça. Le nœud MQTT publie, avec Topic et Message comme seuls champs requis, c'est-à-dire bloquants tant qu'ils sont vides. Le MQTT Trigger fait l'inverse et écoute les topics que tu lui donnes.

Commence par la lecture, c'est presque toujours le premier besoin. Une ligne de production remonte ses relevés sur des topics du genre usine/ligne1/temp. Le MQTT Trigger s'abonne, chaque message devient un item du workflow, et tu l'archives dans une feuille via Google Sheets ou dans une collection via MongoDB. Aucun script à installer sur l'équipement.

Deuxième cas : l'alerte. Un capteur de porte publie une fois quand elle s'ouvre en dehors des horaires, et le workflow transforme cette charge utile brute en un message lisible dans un canal via Slack. L'option Only Message rend l'affaire nettement plus propre, puisqu'elle ne renvoie que le contenu du message, sans la structure autour.

Troisième cas : écrire vers les équipements. Le nœud MQTT publie une consigne sur le topic d'un appareil, et l'option Retain demande au broker de conserver ce dernier message. Sans elle, un message publié sur un topic sans abonné est simplement jeté. Avec elle, un appareil qui se connecte plus tard récupère quand même la dernière consigne.

Un point mérite d'être dit franchement, parce qu'il change la façon de cadrer un projet. Sur la plupart des intégrations, quand une opération manque, on appelle l'API directement avec un nœud générique. Ici, non. Le credential MQTT ouvre une connexion vers un broker, pas vers une API HTTP : il n'existe pas de nœud de repli. Ce que ces deux nœuds exposent, c'est ce que n8n sait faire avec MQTT.

D'où la limite, sans détour : le nœud publie, point. Tout ce qui entre passe par le trigger, et le reste des capacités de ton broker se pilote ailleurs. Si tu compares encore les plateformes, l'Avis n8n pose le décor, et la Formation n8n reprend les credentials et les expressions dans l'ordre.

Connexion

Comment relier n8n à ton broker MQTT ?

  1. 01

    Commence par un broker en ligne

    Le credential se connecte à un broker : il en faut donc un avant que n8n ait quelqu'un à qui parler. MQTT publie une liste de serveurs et de brokers sur son propre site, et la documentation de ton fournisseur reste la référence pour les détails de connexion. Garde trois informations sous la main pour l'étape suivante : le Protocol attendu par le broker, son Host et le Port sur lequel il accepte les connexions.

  2. 02

    Crée le credential de connexion au broker

    Dans n8n, ouvre le menu Credentials et crée un credential MQTT, c'est-à-dire un accès enregistré une fois et proposé ensuite dans la liste déroulante des deux nœuds. Choisis le Protocol, qui détermine l'URL construite par n8n : Mqtt pour une URL mqtt: standard, Mqtts pour la version sécurisée mqtts:, Ws pour une URL WebSocket ws:. Renseigne ensuite le Host, le Port, puis le Username et le Password du broker.

  3. 03

    Règle la session et les certificats

    Deux interrupteurs méritent une seconde d'attention avant d'enregistrer. Désactive Clean Session pour recevoir les messages QoS 1 et 2 publiés pendant que la connexion était coupée. Laisse Client ID vide et n8n en génère un ; une valeur fixe ou construite par expression aide à identifier la connexion plus tard, et n8n conseille d'y glisser n8n pour s'y retrouver dans les audits. Si le broker utilise SSL, active le bouton SSL.

Déclencheurs

Qu'est-ce qui déclenche un workflow depuis MQTT ?

MQTT Trigger est le nœud qui démarre un workflow quand quelque chose se passe dans MQTT. Tu actives le workflow et chaque événement reçu devient une exécution.

Ce que tu vois dans n8n

Notes de configuration

01Subscribe to topics with the MQTT TriggerLa version 1 du MQTT Trigger garde un abonnement ouvert sur ton broker et passe chaque message entrant au workflow sous forme d'item.

La version 1 du MQTT Trigger garde un abonnement ouvert sur ton broker et passe chaque message entrant au workflow sous forme d'item.

Paramètres clés

  • Topics : les topics auxquels s'abonner, plusieurs à la fois en les séparant par des virgules. Les caractères joker fonctionnent, + pour un seul niveau et # pour plusieurs, donc usine/+/temp couvre chaque ligne et usine/# couvre toute l'arborescence.
  • Topics porte aussi la qualité de service. Chaque abonnement utilise QoS 0 par défaut ; pour un autre niveau, écris-le après un deux-points, comme dans topicA:1,topicB:2.
Quand l'utiliser
dès que le broker est la source de vérité et que n8n doit réagir à ce que publient les équipements. Rien n'est capté tant que le workflow n'est pas actif, donc active-le une fois tes topics réglés.
02Shape the payload with trigger OptionsLa collection Options décide de ce que la suite du workflow reçoit vraiment. Bien réglée, elle t'évite un nœud Code juste derrière.

La collection Options décide de ce que la suite du workflow reçoit vraiment. Bien réglée, elle t'évite un nœud Code juste derrière.

Paramètres clés

  • JSON Parse Body : n8n essaie de convertir le message en objet, ce que tu veux quand les équipements publient du JSON et que tu comptes lire un champ avec {{ $json.temperature }}.
  • Only Message : ne renvoie que la propriété message, sans la structure qui l'entoure. Confortable pour une charge utile en texte simple que tu ne fais que transmettre.
  • Parallel Processing : les messages sont traités en parallèle, ou bien conservés dans leur ordre d'arrivée.
Quand l'utiliser
garde l'ordre quand la suite des relevés raconte quelque chose, un compteur ou un changement d'état. Le parallèle convient aux alertes indépendantes.
Actions

Ce que le nœud MQTT sait faire

Le nœud MQTT expose une opération. Pour chacune : le nœud tel que tu le configures dans n8n, les champs obligatoires, et nos notes de terrain.

01

Push messages to MQTT

execute

Ce que tu vois dans n8n

Notes & cas d'usage

Le nœud publie un message sur un topic, et le broker le transmet à tout ce qui y est abonné.

Paramètres clés

  • Topic : requis, le topic de publication, souvent construit depuis un nœud précédent avec {{ $json.device }}.
  • Message : requis, le message à publier. Vide, le nœud s'arrête.
  • Send Input Data : envoie plutôt en JSON les données reçues par le nœud.
  • QoS : 0 reçu au plus une fois, 1 au moins une fois, 2 exactement une fois.
  • Retain : le broker garde ce dernier message sur le topic.
Cas d'usage
pousser une consigne sur le topic d'un équipement quand le workflow a décidé qu'elle changeait.
Besoin d'aide

Besoin d'aide pour automatiser MQTT avec n8n ?

L'équipe te répond directement.

Chaque message est lu par une personne.

FAQ

MQTT et n8n, les questions qui reviennent

01L'intégration MQTT n8n est-elle gratuite dans n8n ?
Oui. Le nœud MQTT et le MQTT Trigger sont livrés avec n8n : rien à installer, aucun coût supplémentaire côté n8n. C'est vrai sur n8n Cloud, l'offre hébergée par n8n, comme sur une instance auto-hébergée en Community Edition sous licence Sustainable Use. Un workflow se comporte pareil dans les deux cas, ce qui compte ici, puisque l'auto-hébergement permet souvent de placer n8n sur le même réseau que le broker. Reste le coût du broker lui-même, qui dépend de celui que tu installes ou auquel tu souscris. Ça ne fait pas partie de ce que n8n facture.
02Quels credentials faut-il pour le nœud MQTT ?
Un seul type, appelé connexion au broker, partagé par le nœud et le trigger. Il te faut le Protocol du broker, au choix Mqtt, Mqtts ou Ws, puis le Host et le Port, puis un Username et un Password pour t'authentifier. Si le broker utilise SSL, tu ajoutes les certificats et clés correspondants : un Client Certificate avec son Client Key pour une connexion sans mot de passe, et une ou plusieurs CA Certificates. Le credential se crée une fois dans le menu Credentials et se réutilise partout, les deux nœuds allant le chercher dans une liste déroulante.
03Quelles sont les limites du nœud MQTT dans n8n ?
Le nœud tient en une opération : publier un message sur un topic. Il ne lit pas, il n'administre pas le broker, et tout ce qui entre passe par le trigger. Le vrai sujet est ailleurs, du côté du repli. Sur une intégration bâtie sur une API HTTP, une opération manquante se rattrape en appelant soi-même l'endpoint avec un nœud générique. Le credential MQTT ouvre une connexion vers un broker et non vers une API HTTP, donc cette porte de sortie n'existe pas. Ce que ces deux nœuds exposent constitue toute la surface disponible depuis n8n, le reste se traite côté broker.
04Le MQTT Trigger réagit-il en temps réel ?
Non, aucun délai ne peut t'être promis ici. n8n ne documente pas de mécanisme pour le MQTT Trigger : cette page n'avancera donc ni durée, ni intervalle, ni explication sur la façon dont l'abonnement est géré en coulisses. Ce qui est documenté est plus simple. Le workflow doit être actif pour que le trigger écoute ses topics, et rien n'est capté pendant qu'il reste inactif. Un réglage voisin aide quand même : en désactivant Clean Session dans le credential, tu reçois les messages QoS 1 et 2 publiés pendant que la connexion était coupée.
05n8n ou Make pour MQTT ?
Ça dépend de l'endroit où vit ton broker et de la façon dont tu veux payer. Make est une plateforme d'automatisation hébergée, sans option d'auto-hébergement, facturée à l'opération : un point à regarder de près quand des équipements publient en continu et que chaque message compte comme une opération. n8n tourne sur n8n Cloud ou sur ton propre serveur, donc sur le même réseau qu'un broker qui ne sort jamais sur internet. Les deux offrent une logique visuelle. Les vrais départages sont la maîtrise des données, le modèle de coût face à ton volume de messages, et l'appétence de l'équipe pour l'infrastructure.
Hack'celeration Lab

Reçois nos tips intégration chaque semaine.

Pas de spam. Désinscription à tout moment.

Même plateforme

Autres docs utiles sur ce stack.

Voir toutes les intégrations