Shelly Gen4: activar Matter y añadir a Home Assistant

Publicado el 20-10-2026

El Shelly 1 Gen4 y el Shelly 1PM Gen4 salen de fábrica con Matter sobre Wi-Fi: están certificados Matter 1.3 por la CSA [6][7] y no necesitan ninguna activación. Esta guía explica cómo comisionarlos en Home Assistant como dispositivos Matter nativos, sin pasar por la nube de Shelly, y cuándo conviene hacerlo en lugar de usar la integración Shelly directa.

Qué es Matter en el contexto del Shelly Gen4

Matter es un protocolo estándar de domótica que funciona en local, sin servidores en la nube. Una vez comisionado, el módulo recibe y ejecuta órdenes directamente desde el controlador Matter —en este caso, Home Assistant— sin intervención de los servidores de Shelly [1][5].

El Shelly Gen4 usa Matter sobre Wi-Fi, no sobre Thread [1][5]. Esto significa que:

Matter y Zigbee son firmwares alternativos en el Gen4: si cambias a Zigbee, el módulo deja de funcionar como dispositivo Matter (y viceversa) [1][2].

Requisitos antes de empezar

No necesitas cuenta en Shelly Cloud ni la nube de Shelly activa para el comisionado Matter [1].

Paso 1: asegúrate de que el add-on Matter está activo en HA

  1. En HA, ve a Ajustes → Dispositivos e integraciones y busca la integración Matter.
  2. Si no aparece, añádela desde el catálogo de integraciones: busca «Matter» y sigue los pasos de instalación. En HA OS el add-on del servidor Matter se instala automáticamente al añadir la integración [3].
  3. Una vez activa, la integración Matter queda lista para descubrir dispositivos.

Paso 2: obtener el código de emparejamiento Matter del Shelly

El código de emparejamiento Matter (QR o código de 11 dígitos) está accesible desde la web local del módulo o desde la Shelly App.

Desde la web local del módulo

  1. Accede a la IP del Shelly en tu navegador (aparece en la Shelly App o en tu router).
  2. Ve a Settings → Matter (o equivalente según la versión de firmware).
  3. Verás el código QR y el código manual de 11 dígitos para el emparejamiento [1].
  4. Guarda una foto del código QR o anota el código manual: lo necesitarás en el paso siguiente.

Desde la Shelly App

  1. Abre la app y entra en el dispositivo.
  2. Ve a la sección de ajustes del dispositivo → Matter.
  3. La app muestra el código QR de emparejamiento [1].

Paso 3: comisionar el dispositivo en Home Assistant

  1. En HA, ve a Ajustes → Dispositivos e integraciones → Matter y pulsa Añadir dispositivo.
  2. HA te pedirá el código QR o el código manual. Escanea el QR con la cámara del móvil o introduce el código de 11 dígitos a mano.
  3. HA realiza el comisionado: el Shelly se incorpora al fabric Matter de HA y queda disponible como dispositivo local [3].
  4. HA crea las entidades según el tipo de módulo:

Diferencia entre el modo Matter y la integración Shelly nativa en HA

Tanto la integración Matter como la integración Shelly nativa de HA trabajan en local y sin nube. La diferencia está en qué exponen y para qué están pensadas:

Integración Shelly nativa [4]Integración Matter [3]
ProtocoloAPI local Shelly (push)Matter sobre Wi-Fi
ConfiguraciónAutomática (descubrimiento en red)Comisionado con código QR
Entidad switchSíSí
Medición de potencia (1PM)Sí: vatios y kWh en tiempo real [2]No: la medición no está en el perfil Matter estándar [3]
Scripts y timers localesSí, desde la web del móduloSí, independiente de la integración
Compatibilidad multiplataformaSolo HACualquier controlador Matter certificado (Alexa, Google Home, Apple Home)
Shelly Smart Control appSíSí (solo se pierde con firmware Zigbee) [5]

Cuándo conviene usar Matter en lugar de la integración Shelly nativa

Elige Matter si tu instalación combina Home Assistant con otro controlador Matter (Apple Home, Amazon Alexa, Google Home): el mismo Shelly puede aparecer en todos sin configurar integraciones separadas [5]. También si quieres estandarizar todos los dispositivos en un solo protocolo.

Elige la integración Shelly nativa si usas únicamente Home Assistant y quieres la máxima información disponible: la medición de potencia y energía del 1PM Gen4 solo llega a HA por la integración nativa [2][4]. Para instalaciones con solo HA, la integración nativa da más datos y se configura de forma automática sin ningún paso de comisionado.

Nota sobre el Shelly 2PM Gen4 y persianas en modo Matter

Si usas el Shelly 2PM Gen4 para controlar una persiana, ten en cuenta que en Matter el módulo arranca con un perfil de dos interruptores independientes. Para que HA lo reconozca como cubierta (cover) tienes que cambiar el perfil a «Roller Shutter» desde la web local del módulo antes o después del comisionado [5]. Mientras tenga el perfil de dos switches, HA no puede controlar la posición del motor.

Preguntas frecuentes

¿Necesito un Thread Border Router para el Shelly Gen4?

No. El Shelly Gen4 usa Matter sobre Wi-Fi, no sobre Thread. A diferencia de otros dispositivos Matter que sí usan Thread (algunos sensores, cerraduras), el Gen4 se comunica directamente por Wi-Fi con el controlador Matter [1][5]. No es necesario el ZBT-2 ni ningún otro border router Thread.

¿Piedo el control desde la Shelly App si uso Matter?

No. La app Shelly Smart Control sigue funcionando con el módulo en modo Wi-Fi/Matter. Solo pierdes la app si cambias el firmware a Zigbee [5].

¿El 1PM Gen4 expone los vatios en HA a través de Matter?

No. El perfil Matter estándar para el Shelly 1PM Gen4 no incluye la medición de potencia: HA solo ve un switch [2][3]. Para tener los sensores de consumo en HA, usa la integración Shelly nativa en lugar de Matter.

¿Puedo añadir el Shelly a Google Home además de a HA?

Sí. Matter permite comisionar el dispositivo en varios controladores desde el primero que lo comisionó (multi-admin). Desde HA, puedes invitar a otro controlador Matter a compartir el dispositivo sin reiniciar el comisionado [3].

¿Qué pasa si quiero pasar a Zigbee después de haber usado Matter?

Tendrás que cambiar el firmware del módulo desde su web local. Al cambiar a Zigbee el dispositivo abandona el fabric Matter, deja de aparecer en HA como dispositivo Matter y tendrás que eliminarlo de la integración. Para volver a Matter, tendrías que instalar el firmware Wi-Fi/Matter y repetir el comisionado [1][2].

En Comfortek Shop

Para la integración nativa Shelly sin Matter, consulta la guía Shelly con Home Assistant. Para la puesta en marcha física del módulo, consulta la guía Shelly Gen4 primeros pasos.

Fuentes

  1. Shelly, base de conocimiento Shelly 1 Gen4 — https://kb.shelly.cloud/knowledge-base/shelly-1-gen4 (2026-10-01)
  2. Shelly, base de conocimiento Shelly 1PM Gen4 — https://kb.shelly.cloud/knowledge-base/shelly-1pm-gen4 (2026-10-01)
  3. Home Assistant, integración Matter — https://www.home-assistant.io/integrations/matter/ (2026-10-01)
  4. Home Assistant, integración Shelly — https://www.home-assistant.io/integrations/shelly/ (2026-10-01)
  5. Shelly, comparativa Gen1/Gen2/Gen3/Gen4 — https://support.shelly.cloud/en/support/solutions/articles/103000316073-comparison-of-shelly-gen1-gen2-gen3-and-gen4-devices (2026-09-25)
  6. CSA, certificado Matter Shelly 1 Gen4 — https://csa-iot.org/csa_product/shelly-1-gen4-2/ (2026-09-25)
  7. CSA, certificado Matter Shelly 1PM Gen4 — https://csa-iot.org/csa_product/shelly-1pm-gen4-2/ (2026-09-25)

Este artículo se ha elaborado con inteligencia artificial y puede contener errores. Si ves alguno, escríbenos a info@comfortek.es y lo corregimos.