Recursos · Integración n8n

Integración MQTT n8nAutomatiza MQTT con n8n.

Tus equipos ya hablan con un broker, así que deja que n8n escuche esa misma línea. Una integración MQTT n8n se apoya en dos nodos: el nodo MQTT publica un mensaje en el topic que elijas, y el MQTT Trigger se suscribe a topics y arranca el flujo cuando llega un mensaje. Una operación, un credential.

Reseñas verificadas en Trustpilot · Agencia de IA, automatización y growth

Por qué automatizar

¿Qué te aporta de verdad la integración MQTT n8n?

MQTT funciona por publicación y suscripción: un equipo envía un mensaje a un topic alojado en un broker, y todo lo que esté suscrito a ese topic recibe una copia. n8n trae dos nodos para eso. El nodo MQTT publica, con Topic y Message como únicos campos requeridos, es decir, campos que bloquean la ejecución si quedan vacíos. El MQTT Trigger hace el camino inverso y escucha los topics que le indiques.

Empieza por la lectura, que casi siempre es la primera necesidad. Un invernadero manda sus lecturas de humedad a topics del estilo riego/zona2/humedad. El MQTT Trigger se suscribe, cada mensaje se convierte en un item del flujo y lo archivas en una hoja con Google Sheets o en una tabla con Postgres. Sin scripts que mantener en el equipo.

Segundo escenario: el aviso. Un sensor de puerta publica una vez cuando se abre fuera de horario, y el flujo convierte esa carga útil en una línea legible en un canal con Slack. La opción Only Message es la que lo deja limpio, porque devuelve solo la propiedad del mensaje, sin la estructura que la rodea.

Tercer escenario: escribir hacia los equipos. El nodo MQTT publica una orden en el topic de un dispositivo, y la opción Retain pide al broker que conserve ese último mensaje. Sin ella, un mensaje publicado en un topic sin suscriptores se descarta sin más. Con ella, un dispositivo que se conecta más tarde recoge igualmente la última orden.

Hay algo que conviene decir sin rodeos, porque cambia cómo planificas el proyecto. En la mayoría de integraciones, cuando falta una operación se llama a la API con un nodo genérico. Aquí no. El credential de MQTT abre una conexión con un broker, no con una API HTTP, así que no existe un nodo de recambio. Lo que exponen estos dos nodos es lo que n8n sabe hacer con MQTT.

De ahí el límite, dicho claro: el nodo publica y nada más. Todo lo que entra pasa por el trigger, y el resto de capacidades del broker se gobierna fuera de n8n. Si todavía comparas plataformas, la Reseña n8n sitúa el terreno, y el Curso n8n repasa credentials y expresiones con calma.

Conexión

¿Cómo conectas n8n con tu broker MQTT ?

  1. 01

    Ten primero un broker en marcha

    El credential se conecta a un broker, así que hace falta uno antes de que n8n tenga con quién hablar. MQTT publica una lista de servidores y brokers en su propio sitio, y la documentación de tu proveedor manda sobre los detalles de conexión. Ten tres datos a mano para el paso siguiente: el Protocol que espera el broker, su Host y el Port en el que acepta conexiones.

  2. 02

    Crea el credential de conexión al broker

    En n8n, abre el menú Credentials y crea un credential de MQTT, o sea un acceso guardado una sola vez que después aparece en el desplegable de los dos nodos. Elige el Protocol, que determina la URL que construye n8n: Mqtt para una URL mqtt: estándar, Mqtts para la versión segura mqtts: y Ws para una URL WebSocket ws:. Después rellena el Host, el Port, el Username y el Password.

  3. 03

    Ajusta la sesión y los certificados

    Dos interruptores merecen un vistazo antes de guardar. Desactiva Clean Session si quieres recibir los mensajes QoS 1 y 2 publicados mientras la conexión estuvo caída. Si dejas Client ID vacío, n8n genera uno; un valor fijo o construido con una expresión ayuda a identificar la conexión más tarde, y n8n recomienda incluir n8n en él para facilitar las auditorías. Si el broker usa SSL, activa el interruptor SSL.

Disparadores

¿Qué arranca un flujo desde MQTT ?

MQTT Trigger es el nodo que arranca un workflow cuando algo ocurre en MQTT. Activas el workflow y cada evento recibido se convierte en una ejecución.

Lo que ves en n8n

Notas de configuración

01Subscribe to topics with the MQTT TriggerLa versión 1 del MQTT Trigger mantiene abierta una suscripción en tu broker y entrega cada mensaje entrante al flujo como un item.

La versión 1 del MQTT Trigger mantiene abierta una suscripción en tu broker y entrega cada mensaje entrante al flujo como un item.

Parámetros clave

  • Topics: los topics a los que suscribirse, varios a la vez separados por comas. Los comodines funcionan, + para un solo nivel y # para varios, de modo que riego/+/humedad abarca todas las zonas y riego/# abarca el árbol entero.
  • Topics lleva además la calidad de servicio. Cada suscripción usa QoS 0 por defecto; para otro nivel, escríbelo tras dos puntos, como en topicA:1,topicB:2.
Cuándo usarlo
cuando el broker es la fuente de verdad y quieres que n8n reaccione a lo que publican los equipos. Nada se capta mientras el flujo no esté activo, así que actívalo en cuanto los topics estén afinados.
02Shape the payload with trigger OptionsLa colección Options decide qué recibe de verdad el resto del flujo. Bien ajustada, te ahorra un nodo Code justo detrás.

La colección Options decide qué recibe de verdad el resto del flujo. Bien ajustada, te ahorra un nodo Code justo detrás.

Parámetros clave

  • JSON Parse Body: n8n intenta convertir el mensaje en un objeto, que es lo que quieres cuando los equipos publican JSON y piensas leer un campo con {{ $json.humedad }}.
  • Only Message: devuelve únicamente la propiedad del mensaje, sin lo que la envuelve. Cómodo para una carga útil en texto plano que solo vas a reenviar.
  • Parallel Processing: los mensajes se procesan en paralelo o, desactivado, se mantienen en su orden de llegada.
Cuándo usarlo
conserva el orden cuando la secuencia de lecturas cuenta algo por sí misma, como un contador que sube o un cambio de estado que hay que seguir paso a paso. El paralelo encaja mejor con avisos sueltos que no dependen unos de otros.
Acciones

Qué sabe hacer el nodo MQTT

El nodo MQTT expone una operación. Para cada una: el nodo tal como lo configuras en n8n, los campos obligatorios y nuestras notas de campo.

01

Push messages to MQTT

execute

Lo que ves en n8n

Notas y casos de uso

El nodo publica un mensaje en un topic y el broker lo reparte a todo lo que esté suscrito allí.

Parámetros clave

  • Topic: requerido, el topic donde publicar, a menudo construido desde un nodo anterior con {{ $json.device }}.
  • Message: requerido, el mensaje a publicar. Vacío, el nodo se detiene.
  • Send Input Data: envía como JSON los datos que recibe el nodo.
  • QoS: 0 recibido como máximo una vez, 1 al menos una vez, 2 exactamente una vez.
  • Retain: el broker guarda este último mensaje en el topic.
Casos de uso
enviar una consigna al topic de un equipo cuando el flujo decide que ha cambiado.
Necesitas ayuda

¿Necesitas ayuda para automatizar MQTT con n8n?

El equipo te responde directamente.

Cada mensaje lo lee una persona.

FAQ

MQTT y n8n, las dudas más repetidas

01¿La integración MQTT n8n es gratis en n8n?
Sí. El nodo MQTT y el MQTT Trigger vienen incluidos con n8n, así que no hay nada que instalar ni ningún coste extra por el lado de n8n. Vale igual en n8n Cloud, la oferta alojada por n8n, y en una instancia autoalojada en Community Edition con licencia Sustainable Use. Un flujo se comporta igual en ambos casos, algo que aquí pesa: autoalojar suele permitir que n8n viva en la misma red que el broker. Queda el coste del broker en sí, que depende del que instales o contrates, y eso no forma parte de lo que te factura n8n.
02¿Qué credentials necesita el nodo MQTT?
Un único tipo, llamado conexión al broker, compartido por el nodo y el trigger. Necesitas el Protocol del broker, que puede ser Mqtt, Mqtts o Ws, luego el Host y el Port, y después un Username y un Password para autenticarte. Si el broker usa SSL, añades los certificados y claves correspondientes: un Client Certificate con su Client Key para una conexión sin contraseña, y una o varias CA Certificates. El credential se crea una sola vez en el menú Credentials y se reutiliza en todos los flujos, porque ambos nodos lo eligen desde un desplegable.
03¿Qué límites tiene el nodo MQTT en n8n?
El nodo se reduce a una operación: publicar un mensaje en un topic. No lee, no administra el broker y todo lo que entra llega por el trigger. Lo importante está en el plan B. En una integración construida sobre una API HTTP, una operación que falta se resuelve llamando tú mismo al endpoint con un nodo genérico. El credential de MQTT abre una conexión con un broker y no con una API HTTP, así que esa salida no existe. Lo que exponen estos dos nodos es toda la superficie disponible desde n8n, y el resto se resuelve en el lado del broker.
04¿El MQTT Trigger reacciona en tiempo real?
No, aquí nadie puede prometerte un plazo. n8n no documenta ningún mecanismo para el MQTT Trigger, así que esta página no va a afirmar una demora, un intervalo ni nada sobre cómo se gestiona la suscripción por debajo. Lo que sí está documentado es más sencillo: el flujo tiene que estar activo para que el trigger escuche sus topics, y nada se capta mientras siga inactivo. Un ajuste cercano sí ayuda: si desactivas Clean Session en el credential, recibes los mensajes QoS 1 y 2 publicados mientras la conexión estuvo caída.
05¿n8n o Make para MQTT?
Depende de dónde viva tu broker y de cómo prefieras pagar. Make es una plataforma de automatización alojada, sin opción de autoalojamiento, facturada por operación, un detalle que pesa cuando los equipos publican sin parar y cada mensaje cuenta como una operación. n8n corre en n8n Cloud o en tu propio servidor, así que puede quedarse en la misma red que un broker que nunca sale a internet. Las dos ofrecen lógica visual. Lo que de verdad desempata es el control de los datos, el modelo de coste frente a tu volumen de mensajes y las ganas del equipo de gestionar infraestructura.
Hack'celeration Lab

Recibe nuestros tips de integración cada semana.

Sin spam. Cancela cuando quieras.