Cómo añadir un dispositivo Shelly a Home Assistant | Y controlarlo

Si utilizas dispositivos Shelly para automatizar luces, enchufes o sensores en tu hogar, es muy probable que quieras centralizar su control desde una plataforma más potente. Gestionarlos uno por uno desde su interfaz web puede resultar limitado cuando buscas automatizaciones complejas, paneles personalizados o integración con otros dispositivos inteligentes. Estas pueden ser automatizaciones que se activan según condiciones específicas como la hora del día, el estado de otros dispositivos, la temperatura o la detección de movimiento, y que permiten ejecutar varias acciones encadenadas automáticamente. Aquí es donde entra en juego Home Assistant. Integrar tus dispositivos Shelly en esta plataforma te permite controlarlos de forma unificada, crear automatizaciones avanzadas y supervisar su estado en tiempo real sin depender de la nube. En este artículo te explicamos cómo añadir un dispositivo Shelly a Home Assistant y cómo configurarlo correctamente según su generación.

Si quieres controlar tus dispositivos Shelly desde un único panel, crear automatizaciones más inteligentes y optimizar tu red local, aquí te guiamos paso a paso para que la integración funcione correctamente desde el primer momento.

Cómo funciona la integración entre Shelly y Home Assistant

Home Assistant es una plataforma de automatización del hogar de código abierto que centraliza el control de dispositivos inteligentes en una sola interfaz. Permite crear automatizaciones, paneles personalizados y gestionar múltiples protocolos desde un único sistema.

Shelly, por su parte, es una marca de dispositivos IoT orientados al control de iluminación, sensores, válvulas, relés (interruptores que permiten abrir o cerrar un circuito eléctrico de forma remota) y otros elementos eléctricos. Muchos de sus modelos funcionan mediante WiFi y pueden operar completamente en red local.

La integración oficial de Shelly en Home Assistant permite que ambos sistemas se comuniquen directamente dentro de tu red local, ya que no necesitas habilitar servicios en la nube. La comunicación se realiza mediante protocolos específicos según la generación del dispositivo, los de Generación 1 utilizan CoIoT (basado en CoAP) y en Generación 2 o posteriores utilizan el protocolo RPC.

Gracias a esta integración puedes:

• Controlar relés como interruptores o luces.

• Monitorizar consumo energético.

• Crear automatizaciones basadas en eventos de botones (por ejemplo, una pulsación simple, doble pulsación o una pulsación larga sobre un botón físico conectado al dispositivo).

• Recibir actualizaciones de estado en tiempo real.

• Gestionar firmware y reinicios desde la propia plataforma.

Cómo añadir un dispositivo Shelly a Home Assistant

Antes de empezar, asegúrate de que tu dispositivo Shelly está conectado a la misma red local que tu servidor de Home Assistant.

Si todo está correctamente configurado, el sistema suele detectar el dispositivo automáticamente:

1. Accede a tu instancia de Home Assistant.

2. Ve a Configuración > Dispositivos y Servicios.

1. Si el dispositivo ha sido detectado, aparecerá dentro de la sección: Descubierto.

2. En el recuadro correspondiente al dispositivo Shelly, haz clic en el botón: Añadir.

1. Sigue las instrucciones en pantalla para completar la configuración.

Si el dispositivo no se detecta automáticamente, puedes configurarlo manualmente con estos pasos:

1. Accede a Configuración > Dispositivos y Servicios.

2. Haz clic en “Añadir Integración”.

1. Busca “Shelly smart home” en la lista.

1. Se abrirá una pequeña ventana en la que debes introducir el hostname o dirección IP del dispositivo (el hostname suele tener un formato como shelly1.local, mientras que la dirección IP es un identificador numérico que puedes encontrar en tu router).

2. Finaliza el asistente.

Nota: Durante la configuración, indica el puerto TCP personalizado solo si utilizas un Shelly Range Extender.

Una vez añadido, el dispositivo aparecerá como una nueva integración con sus correspondientes entidades, es decir, cada una de sus funciones.

Cómo configurar el dispositivo en Home Assistant según la generación

Después de añadir el dispositivo, debes asegurarte de que la comunicación push funciona correctamente, de manera que el dispositivo envíe automáticamente los cambios de estado a Home Assistant en el momento en que ocurren, sin necesidad de que el sistema tenga que consultarlo periódicamente.

La configuración depende de la generación del hardware. Los modelos Shelly generación 1 utilizan el protocolo CoIoT para enviar actualizaciones a Home Assistant. En este caso, debes hacer lo siguiente:

1. Accede a la IP local del dispositivo desde tu navegador.

2. Dirígete a Internet & Security > Advanced – Developer Settings.

3. Activa la opción “Enable CoIoT”.

4. En el campo CoIoT peer, introduce la IP local de tu servidor Home Assistant seguida del puerto 5683.

5. Guarda los cambios.

6. Reinicia manualmente el dispositivo.

Si el servidor y el dispositivo están en subredes distintas, asegúrate de permitir tráfico UDP por el puerto 5683.

En dispositivos Shelly generación 2 y posteriores, modelos que utilizan el protocolo RPC, es posible que tengas que configurar manualmente el WebSocket saliente:

1. Accede a la IP local del dispositivo.

2. Ve a Settings > Connectivity > Outbound WebSocket.

3. Activa “Enable Outbound WebSocket”.

4. Introduce la dirección:

(Si utilizas HTTPS, usa wss://).

5. Guarda los cambios.

Con esta configuración, el dispositivo enviará actualizaciones en tiempo real sin depender de la nube. Si detectas comportamientos inesperados, revisa los registros del sistema y los comentarios del log para identificar posibles errores de comunicación.

Cómo nombrar un dispositivo Shelly en Home Assistant

Si tienes varios dispositivos, nombrarlos correctamente facilitará la gestión de automatizaciones y te evitará confusiones. Este proceso cambia según la generación.

Cómo asignar nombres a dispositivos Shelly generación 1

Si el dispositivo tiene un solo relé:

• Si defines el Device Name en la interfaz web del Shelly, Home Assistant usará ese nombre para el dispositivo y sus entidades. Si no lo defines, utilizará el ID del dispositivo.

Si el dispositivo tiene varios relés:

• El nombre principal se basa en el Device Name o ID.

• Cada canal puede tener su propio Channel Name.

• Si no defines el Channel Name, el sistema añadirá el número de canal automáticamente.

Para configurar el nombre:

1. Accede a la IP del dispositivo.

2. Ve a Settings > Device Name.

3. Si tiene varios canales, entra en cada uno y define el Channel Name.

Cómo asignar nombres a dispositivos Shelly generación 2 y posteriores

En dispositivos con un solo canal:

• El Device Name define el nombre principal. Si defines un Channel Name, se añade como sufijo a la entidad.

En dispositivos con múltiples relés:

• Se crea un subdispositivo por canal.

• Si defines Channel Name, ese será el nombre visible.

• Si no lo haces, se combinará el nombre del dispositivo con el número o nombre por defecto del canal.

Recuerda configurar siempre nombres descriptivos como “Luz cocina” o “Ventilador salón” para evitar errores en tus automatizaciones.

Cómo eliminar un dispositivo Shelly de Home Assistant

Si necesitas quitar el dispositivo de tu sistema, el proceso es sencillo y no requiere pasos adicionales en el hardware. Solo sigue estos pasos para eliminar la integración y todas las entidades asociadas:

1. Accede a Configuración > Dispositivos y Servicios.

2. Selecciona la tarjeta de la integración Shelly.

3. Localiza la instancia que deseas eliminar.

4. Haz clic en el menú de tres puntos.

5. Selecciona “Delete”.

6. Confirma la eliminación.

Conclusiones personales

Integrar dispositivos Shelly en Home Assistant es una decisión que tiene sentido si buscas mayor control, automatizaciones avanzadas y funcionamiento completamente local. Pero más allá de añadir el dispositivo, es importante configurar el protocolo correctamente según su generación. Si no lo haces, puedes llegar a experimentar retrasos en la actualización de estados, pérdida de eventos o automatizaciones que no se ejecutan correctamente.

Dedicando unos minutos a ajustar CoIoT o el WebSocket saliente y definir nombres claros para tus entidades, tendrás una instalación estable, organizada y preparada para crecer. Así tendrás un sistema funcional e inteligente en tu hogar.