Shelly: relés, enchufes y persianas en local

Descripción general

Shelly fabrica relés, enchufes, regletas, módulos de persiana y medidores de consumo muy usados en domótica. La integración oficial habla con ellos por la red local, sin depender de la nube de Shelly, y recibe cada cambio al instante. Crea interruptores, luces, persianas, sensores y eventos de pulsación de los botones de la pared.

Esquema: el Shelly y Home Assistant hablan por la red local al instante; la nube de Shelly no hace falta — En local, sin la nube.

Esquema: NODARA.

Requisitos

El Shelly en tu Wi-Fi (o por Ethernet si el modelo lo tiene), configurado con su app o su web.
Home Assistant suele descubrirlo: Ajustes → Dispositivos y servicios → Configurar. A mano, solo pide su IP.
Gen 2 y posteriores (Plus, Pro, Gen3, Gen4): no hace falta nada más. Los de batería pueden necesitar un WebSocket saliente hacia ws://IP-de-Home-Assistant:8123/api/shelly/ws.
Gen 1: en su web, en Advanced → Developer Settings, activa CoIoT y pon como peer la IP de Home Assistant y el puerto 5683, y reinicia el Shelly.
No necesitas MQTT ni la nube de Shelly: la integración directa es lo más fácil.
Fuente: documentación oficial de Shelly.

Ideas de uso

Doble pulsación del interruptor de pared para apagar toda la casa. Es el ejemplo de abajo.
Medir el consumo de la lavadora o el termo y avisar cuando termina.
Persianas con el Shelly 2PM en modo cortina, en escenas y horarios.
Proxy Bluetooth: los Shelly Gen 2+ enchufados amplían el alcance Bluetooth de Home Assistant.
Convertir un relé en luz desde el tipo de consumo del Shelly, o con el ayudante Cambiar el tipo de un interruptor.
Actualizar el firmware desde Home Assistant.

Ejemplo de uso

alias: "Doble pulsación: apagar todo"
triggers:
  - trigger: event
    event_type: shelly.click
    event_data:
      device: shellyplus1-a8032ab12345
      channel: 1
      click_type: double_push
actions:
  - action: light.turn_off
    target:
      entity_id: all

Cómo funciona:

Cada pulsación del interruptor conectado al Shelly lanza un evento shelly.click con el dispositivo, el canal y el tipo de pulsación.
En Gen 2 y posteriores los tipos son single_push, double_push, triple_push y long_push. En Gen 1: single, double, triple y long.
Para ver el nombre exacto de tu Shelly, escucha shelly.click en Herramientas para desarrolladores → Eventos y pulsa el interruptor. También puedes usar un disparador de dispositivo («Botón pulsado dos veces») en el editor visual.
Para que el botón no encienda el relé además de lanzar el evento, pon la entrada del Shelly en modo desacoplado (detached) en su web.

Acción

doble pulsación en el interruptor del salón

Resultado

evento shelly.click (double_push)
todas las luces = off