Integrar un dispositivo comercial consiste en conectar su protocolo o su cuenta con Home Assistant para crear entidades utilizables.
La inmensa mayoría de nosotros llegamos a la domótica avanzada después de haber comprado algunos enchufes o bombillas sueltas en Amazon o AliExpress. Por tanto, nuestro primer paso práctico será “secuestrar” estos dispositivos WiFi comerciales (que actualmente viven aislados en las aplicaciones de sus fabricantes) y centralizarlos en nuestro servidor.
Vamos a analizar técnicamente cómo integrar las tres grandes familias de dispositivos WiFi del mercado: Shelly, Sonoff (eWeLink) y Tuya (SmartLife). Cada una representa un nivel distinto de dificultad arquitectónica.
Antes de integrar: hacer inventario
Antes de empezar a instalar integraciones a lo loco, merece la pena hacer un inventario rápido de lo que ya tenemos por casa. Apuntamos marca, modelo exacto, aplicación que usa, protocolo y ubicación.
No es burocracia por amor al Excel. Es que muchas veces dos dispositivos que parecen iguales por fuera tienen chips o firmwares completamente distintos por dentro. Un enchufe Tuya comprado en 2020 puede ser bastante amable para integrarlo, y otro comprado en 2025 puede venir mucho más cerrado.
Si ya tenéis varios dispositivos funcionando en sus apps originales, no los desvinculéis todavía. Primero comprobad que Home Assistant puede verlos, controlarlos y leer su estado. Luego ya decidiremos si merece la pena cortar la nube, flashear firmware o dejarlos como integración híbrida.
El ecosistema ideal: Shelly y la integración local nativa
Empezamos por el escenario más agradecido. Como vimos en los primeros artículos, los dispositivos de Shelly (Allterco Robotics) están diseñados pensando en el usuario técnico.
La integración de Shelly en Home Assistant es nativa, oficial y 100% local. Home Assistant incluye en su núcleo (Core) una integración oficial mantenida por la propia comunidad y los ingenieros de la marca.
Autodescubrimiento mediante Zeroconf y mDNS
Cuando conectas un dispositivo Shelly a la red WiFi de tu casa, este utiliza un protocolo llamado mDNS (Multicast DNS) o Zeroconf para anunciar su presencia en la red local.
Home Assistant está constantemente escuchando estos paquetes de broadcast. Por tanto, el proceso de integración es trivial:
- Conectas el Shelly a tu router desde su propia app (o desde su servidor web interno).
- Abres Home Assistant y vas a Ajustes > Dispositivos y Servicios.
- Verás que Home Assistant ha “descubierto” automáticamente el dispositivo.
- Haces clic en “Configurar”, y listo.
Las generaciones antiguas de Shelly utilizan CoAP/CoIoT para las actualizaciones de estado. Los modelos más modernos utilizan RPC sobre WebSockets. La integración se comunica en local y ofrece una respuesta rápida sin depender de la nube.
Un inciso necesario: ¿Qué es HACS?
Antes de abordar Sonoff y Tuya, debemos hacer una parada técnica. Las integraciones oficiales que trae Home Assistant para estas marcas asiáticas suelen estar limitadas a la Nube.
Para poder exprimir el hardware y buscar el control local, los ingenieros de la comunidad han desarrollado Componentes Personalizados (Custom Components). Para instalar estos componentes de terceros de forma limpia, utilizamos HACS.
HACS (Home Assistant Community Store) es, básicamente, un gestor de paquetes no oficial. Una vez instalado (requiere una cuenta de GitHub, ya que descarga los repositorios desde allí), nos añade una “tienda de aplicaciones” alternativa en nuestro panel lateral, desde la cual podemos instalar integraciones desarrolladas por la comunidad que superan con creces a las oficiales.
Sonoff y eWeLink: la vía híbrida
Para los dispositivos Sonoff vinculados a eWeLink, una de las opciones más utilizadas es SonoffLAN, un componente comunitario desarrollado por AlexxIT y disponible a través de HACS. No forma parte de las integraciones oficiales incluidas en el núcleo de Home Assistant.
Esta integración es fascinante porque utiliza una arquitectura híbrida (Cloud + Local) de forma transparente para el usuario.
Cómo funciona SonoffLAN
Para configurarla, simplemente instalamos la integración desde HACS e introducimos nuestro usuario y contraseña de la aplicación eWeLink.
A partir de ahí, la integración hace dos cosas simultáneamente:
- Conexión a la Nube: Descarga la lista completa de tus dispositivos y sus claves criptográficas desde los servidores de eWeLink a través de su API HTTP.
- Descubrimiento Local (mDNS/Zeroconf): Escanea tu red WiFi local buscando las direcciones IP de esos dispositivos.
Si el dispositivo Sonoff soporta el modo LAN (la mayoría de los módulos modernos basados en ESP8266/ESP32 lo hacen), Home Assistant se comunicará con él directamente por tu red local, ignorando la nube. Según el modo configurado y las capacidades del dispositivo, la integración puede usar la comunicación local, la nube o ambas. Conviene revisar el soporte del modelo exacto antes de contar con el modo LAN.
Es una solución muy cómoda, porque nos da control local en muchos casos sin tener que flashear firmwares personalizados.
Si vais a depender de control local en dispositivos WiFi, suele ser buena idea reservarles la IP en el router por DHCP. No es obligatorio en todos los casos, pero ayuda muchísimo cuando una integración necesita localizar siempre el mismo aparato en la misma dirección.
Tuya y Smart Life: la integración más delicada
Nos queda el caso más delicado. Integrar Tuya es, con diferencia, el proceso más tedioso, debido a su extrema dependencia de la nube y a su modelo de negocio orientado a empresas (B2B), no a usuarios finales.
Tenemos dos caminos radicalmente distintos para integrar aparatos Tuya/SmartLife.
Vía 1: la integración oficial
Home Assistant incluye una integración oficial de Tuya. Depende de los servicios en la nube de Tuya, pero su configuración actual ya no exige crear manualmente un proyecto para desarrolladores.
El proceso actual es bastante más sencillo:
- Añade los dispositivos a la aplicación Smart Life o Tuya Smart.
- En Home Assistant, ve a Ajustes > Dispositivos y servicios y añade la integración Tuya.
- Obtén el código de usuario desde la aplicación móvil cuando el asistente lo solicite.
- Escanea con la aplicación el código QR que muestra Home Assistant.
Esta vía depende de Internet y de los servidores de Tuya. Además, la integración oficial no expone necesariamente todas las funciones disponibles en Smart Life, porque depende del SDK que proporciona el fabricante.
Vía 2: LocalTuya o Tuya Local
Para solucionar este despropósito, la comunidad creó componentes en HACS como LocalTuya o Tuya-Local.
Estas integraciones hablan directamente con dispositivos compatibles dentro de nuestra red. Sin embargo, el proceso y las funciones disponibles dependen del modelo, el protocolo local y la versión del componente. Muchos equipos requieren obtener una clave local propia del dispositivo.
La forma de obtener esa clave ha cambiado varias veces y puede requerir herramientas o una cuenta de desarrollador de Tuya. Antes de empezar, consultad la documentación actual del componente elegido y su lista de dispositivos compatibles. El control local merece la pena cuando funciona, pero no está garantizado para todo el catálogo Tuya.
Una red WiFi con criterio
Con estas tres estrategias (Shelly nativo, SonoffLAN y LocalTuya), podemos absorber prácticamente el 90% del mercado de enchufes, relés y luces WiFi de bajo coste, convirtiéndolos en Entidades estandarizadas dentro de nuestra máquina de estados.
Sin embargo, como advertimos en la teoría de protocolos, llenar la casa de dispositivos WiFi es una mala práctica de ingeniería de redes.
Para la verdadera domótica invisible (decenas de sensores de movimiento, contactos de puertas, pulsadores y detectores de fugas de agua que funcionan a pilas), necesitamos desplegar nuestra propia red mallada.
En el próximo artículo dejaremos atrás el WiFi y configuraremos el verdadero corazón de nuestro sistema: La integración de nuestra red Zigbee (ZHA vs Zigbee2MQTT).
