ZHA en Home Assistant (2026): guía de instalación y coordinadores

Este artículo puede contener enlaces de afiliado. Si compras desde estos enlaces, el precio para ti es el mismo y la tienda me paga una pequeña comisión que ayuda a mantener Tecnoyfoto.

Albert BarnosellEditor y responsable de Tecnoyfoto

Revisado el 27 de agosto de 2026. ZHA sigue siendo la forma nativa de crear una red Zigbee directamente en Home Assistant, pero han cambiado las recomendaciones de hardware, la gestión de la red y el proceso para migrar de coordinador. Esta guía explica qué elegir y cómo hacerlo sin perder dispositivos.

Resumen rápido: para una red nueva, Home Assistant recomienda Connect ZBT-2. Si ya tienes Connect ZBT-1, Home Assistant Yellow, ZBDongle-E/P o un coordinador compatible que funciona bien, no necesitas cambiarlo solo por ser más antiguo.

Qué es ZHA y cuándo elegirlo

ZHA significa Zigbee Home Automation. Es la integración incluida en Home Assistant que utiliza la biblioteca abierta zigpy para comunicarse con coordinadores de distintos fabricantes. Sustituye muchos hubs propietarios y mantiene la automatización dentro de Home Assistant.

Elige ZHA si quieres una configuración integrada en la interfaz, copias de la red y mantenimiento sencillo.
Valora Zigbee2MQTT si un dispositivo concreto ofrece allí funciones que ZHA todavía no expone o si prefieres su ecosistema de convertidores. Consulta nuestra guía de Zigbee2MQTT.
No conectes el mismo coordinador a ZHA y Zigbee2MQTT a la vez. Un coordinador solo puede controlar una red y debe pertenecer a una única aplicación.

Coordinadores recomendados actualmente

Coordinador	Situación	Recomendación
Home Assistant Connect ZBT-2	Modelo oficial actual con EFR32MG24	Primera opción para una red ZHA nueva.
Connect ZBT-1 / SkyConnect	Sustituido por ZBT-2, pero plenamente compatible	Conservar si funciona; no requiere migración preventiva.
Home Assistant Yellow	Radio Zigbee integrada	Buena opción si ya utilizas Yellow.
Sonoff ZBDongle-E, SLZB-07	Silicon Labs compatible	Válido; el firmware se mantiene con herramientas del fabricante.
CC2652/CC1352, ZBDongle-P	Texas Instruments compatible	Válido y estable con firmware de coordinador.
ConBee III	Compatible mediante deCONZ/zigpy-deconz	Alternativa admitida; revisar firmware.

Home Assistant Green no incorpora radio Zigbee: necesita un adaptador USB o un coordinador de red compatible. Con coordinadores serie a través de IP, evita WiFi, VPN o enlaces WAN. La conexión del puerto serie necesita baja latencia y no tolera bien pérdidas.

Instalar ZHA paso a paso

Conecta el coordinador mediante un alargador USB, preferentemente a un puerto USB 2.0 o a un hub USB 2.0 alimentado. Sepáralo del equipo, discos SSD, USB 3.0 y puntos de acceso WiFi.
Reinicia Home Assistant si el adaptador no aparece. Ve a Ajustes → Dispositivos y servicios.
Acepta el descubrimiento de Zigbee Home Automation o pulsa Añadir integración y busca ZHA.
Selecciona el puerto serie correcto. Si Home Assistant pide el tipo de radio, elige el correspondiente al chip; no pruebes tipos al azar.
Deja que ZHA cree la red y guarda una copia de seguridad completa de Home Assistant antes de emparejar muchos dispositivos.

Canal Zigbee e interferencias WiFi

Zigbee y WiFi de 2,4 GHz comparten espectro. Un canal mal elegido o un coordinador pegado a un puerto USB 3.0 puede producir desconexiones que parecen fallos de los sensores. Elige el canal antes de construir una red grande: cambiarlo después puede obligar a despertar o volver a unir algunos dispositivos.

Aleja el coordinador al menos uno o dos metros del host, router y discos USB 3.0.
Mantén un canal Zigbee separado de los canales WiFi más ocupados; analiza tu entorno en lugar de copiar una cifra universal.
Añade primero varios routers Zigbee alimentados por red —enchufes, relés o bombillas que actúen como router— y después los sensores a batería.
Empareja los dispositivos en su ubicación definitiva o cerca del router Zigbee que deba atenderlos.

Cómo añadir dispositivos y construir una malla estable

Entra en Ajustes → Zigbee y selecciona Añadir dispositivo.
Restablece el dispositivo de fábrica aunque sea nuevo; si pertenecía a otro hub no podrá unirse hasta salir de aquella red.
Espera a que aparezca, ponle un nombre y una zona, y comprueba todas sus entidades.
Si faltan funciones, vuelve a emparejarlo un par de veces cerca de un router. Algunos equipos necesitan un quirk de ZHA para exponer características no estándar.

No existe una lista oficial absoluta de dispositivos compatibles: Zigbee define funciones estándar, pero algunos fabricantes añaden comportamientos propios. Antes de comprar, revisa experiencias recientes con el modelo exacto y su versión de firmware.

Copias y migración a otro coordinador

ZHA crea copias de la red Zigbee y permite migrarla entre radios compatibles de Silicon Labs, Texas Instruments y ConBee/RaspBee. Esto evita volver a emparejar todos los dispositivos cuando sustituyes el adaptador.

Ve a Ajustes → Zigbee → Migrar.
Conecta el coordinador nuevo sin retirar todavía el anterior.
Permite que ZHA cree una copia automática y elige Migrar automáticamente, salvo que necesites restaurar una copia concreta.
Si se solicita, autoriza la copia de la dirección IEEE al nuevo coordinador. No vuelvas a usar simultáneamente el antiguo con la misma dirección.
Espera a que los dispositivos regresen. Los equipos a batería pueden tardar; despiértalos o aliméntalos de nuevo antes de pensar que se han perdido.

Actualizaciones OTA, grupos y binding

ZHA puede mostrar entidades de actualización para dispositivos cuyos fabricantes publican firmware compatible. No instales una OTA sin leer sus cambios: una actualización puede modificar funciones, romper bindings o exigir una versión más reciente de ZHA. Los grupos Zigbee y el binding permiten control directo y reducen tráfico; un mando vinculado a una bombilla puede seguir actuando aunque Home Assistant esté reiniciándose.

Solución de problemas

No empareja: restablece de fábrica, acércalo temporalmente y abre de nuevo la ventana de unión.
Se desconecta: revisa interferencias, alimentación del coordinador y cantidad de routers; no culpes primero a la batería.
Aparece sin entidades: repite el emparejamiento, actualiza Home Assistant y busca si necesita un quirk.
Errores EZSP/NCP: sospecha de una conexión serie inestable, cable, alimentación o coordinador remoto.
La red empeoró al mover el dongle: vuelve a usar un alargador y deja horas para que la malla se reorganice.

Conclusión

ZHA es la opción más directa para la mayoría de instalaciones Home Assistant. La estabilidad depende más de un coordinador bien conectado, un canal razonable y una malla con routers que de comprar el dongle más caro. Haz copias antes de migrar y cambia de plataforma solo por una necesidad concreta, no por moda.

Fuentes de referencia: documentación oficial de ZHA y guía de actualización del Sonoff ZBDongle.

Continúa leyendo