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.
Actualizado el 27 de agosto de 2026. La integración oficial de Tuya en Home Assistant ya no requiere crear el proyecto IoT que describían muchas guías antiguas. El flujo actual parte de Smart Life o Tuya Smart, obtiene el código de usuario y vincula la cuenta mediante un QR.
Tuya oficial es una integración en la nube. Aunque Home Assistant ejecute tus automatizaciones, las órdenes y estados dependen del servicio de Tuya. Si necesitas control local, estudia alternativas por dispositivo y asume que no todos los modelos exponen claves o funciones locales.
Qué dispositivos y funciones admite
La integración puede representar luces, interruptores, clima, cortinas, cámaras, ventiladores, humidificadores, sensores, sirenas, aspiradores, válvulas y escenas, entre otros dominios. La compatibilidad real depende del producto y de los puntos de datos que Tuya publique mediante su SDK.
Que un dispositivo funcione en Smart Life no garantiza que todas sus funciones aparezcan en Home Assistant. Algunos modelos exponen solo encendido, mientras la app conserva modos, consumos o parámetros adicionales.
Requisitos
- Aplicación Smart Life o Tuya Smart instalada y cuenta activa.
- Al menos un dispositivo añadido y funcionando en esa app.
- Un segundo dispositivo o pantalla para mostrar el QR mientras el móvil lo escanea.
- Código de usuario de la cuenta; no es el correo ni la contraseña.
- Región correcta: utiliza la misma región/cuenta en la app y durante la vinculación.
Obtener el código de usuario
- Abre Smart Life o Tuya Smart.
- Entra en Yo y pulsa el icono de engranaje.
- Abre Cuenta y seguridad.
- Copia el Código de usuario mostrado en la parte inferior. No lo confundas con el ID de un dispositivo.
Añadir Tuya en Home Assistant
- Ve a Ajustes → Dispositivos y servicios.
- Pulsa Añadir integración y busca Tuya.
- Introduce el código de usuario y los datos solicitados.
- Home Assistant mostrará un QR. En Smart Life/Tuya Smart pulsa añadir o escanear y léelo.
- Autoriza la vinculación, espera a que aparezcan dispositivos y asigna sus zonas.
- Prueba una orden y confirma que el estado cambia también desde la app.
Añadir dispositivos después de la configuración
Primero añade el equipo a Smart Life o Tuya Smart. Después ve a la integración Tuya en Home Assistant, abre el menú de tres puntos y selecciona Recargar. No hace falta borrar y crear la integración cada vez.
Escenas y automatizaciones
Las escenas creadas en Tuya pueden aparecer como escenas de Home Assistant tras una actualización. Son útiles cuando el SDK no expone un modo complejo del dispositivo. Para automatizaciones críticas —calefacción, seguridad o fugas— ten presente la dependencia de Internet y diseña un estado seguro si la nube no responde.
Diagnosticar funciones que faltan
- Abre el dispositivo dentro de la integración Tuya.
- Descarga el archivo de diagnósticos desde el menú del dispositivo.
- Busca las secciones
status,status_rangeyfunction. - Si están vacías, el SDK de Tuya no está ofreciendo funciones útiles para ese producto; Home Assistant no puede inventarlas.
- Si existen datos pero faltan entidades, actualiza Home Assistant y consulta incidencias del modelo exacto antes de instalar componentes personalizados.
Problemas frecuentes
- El QR no funciona: comprueba que usas Smart Life/Tuya Smart, la cuenta correcta y una segunda pantalla.
- No aparece un dispositivo: recarga la integración y confirma que está en la misma cuenta y región.
- Pide autenticar tras recargar: entra en iot.tuya.com, acepta términos pendientes, reinicia Home Assistant y reconfigura.
- Faltan controles: revisa los diagnósticos; puede ser una limitación del SDK, no un error de la instalación.
- Retraso o no disponible: verifica Internet y el estado de Tuya antes de reiniciar todo Home Assistant.
Tuya oficial frente a control local
| Enfoque | Ventaja | Limitación |
|---|---|---|
| Integración oficial Tuya | Configuración sencilla y mantenimiento dentro de Home Assistant | Depende de nube y del SDK oficial. |
| Integración local comunitaria | Puede reducir nube y latencia en modelos compatibles | Obtención de claves, compatibilidad y mantenimiento más complejos. |
| Reemplazar por Zigbee/Matter/local | Mayor independencia cuando el hardware lo permite | Puede requerir nuevo coordinador o sustituir dispositivos. |
No migres una instalación estable solo por ideología. Decide por funciones, fiabilidad, privacidad y capacidad para mantener la solución. Si compras equipos nuevos, prioriza protocolos locales bien documentados.
Seguridad y privacidad
- Activa MFA en la cuenta Tuya si está disponible.
- No compartas códigos, QR ni diagnósticos sin revisar datos personales.
- Elimina dispositivos antiguos de la cuenta y revoca accesos que ya no uses.
- Evita usar dispositivos cloud como único mecanismo para una función de seguridad crítica.
- Mantén actualizadas app, firmware y Home Assistant.
Conclusión
La integración oficial de Tuya es mucho más fácil que el antiguo proyecto IoT: código de usuario, QR y recarga para nuevos dispositivos. Su límite sigue siendo el mismo: Home Assistant solo puede mostrar los datos que Tuya expone. Empieza por la vía oficial y cambia a una solución local únicamente cuando una necesidad concreta lo justifique.
Fuente principal: documentación oficial de Tuya en Home Assistant.
Continúa leyendo
Siguiente guía relacionada · 5 min de lectura
Vulnerabilidad CSRF en Tuya y Smart Life: actualiza a 6.5.0
Cuando hablamos de seguridad en casa conectada, hay arreglos que pueden esperar… y otros que van ya. Este es de los segundos. Se ha…
Continuar con este artículo