Integración domótica Wyze, gratuita y de código abierto
Controle sus bombillas, tiras LED, enchufes, cámaras y sensores Wyze.
Publicado por gboulvin
- Dispositivos
- Versión 1.0.0
- Requiere Gladys >=5.1.0
- ★ 0
Controle sus dispositivos Wyze desde Gladys Assistant: bombillas, tiras LED, enchufes, cámaras y sensores Wyze Sense, con disparadores y acciones de escena y dos widgets para el panel.
Dispositivos compatibles
| Dispositivo Wyze | En Gladys |
|---|---|
| Bombilla blanca (WLPA19, HL_HWB2) | Encendido/apagado, brillo, temperatura de color |
| Bombilla de color (WLPA19C, BR30) y tira LED (HL_LSL) | Encendido/apagado, brillo, temperatura de color, color — control local |
| Enchufe y enchufe exterior (WLPP1, WLPP1CFH, WLPPO) | Encendido/apagado (un dispositivo por toma) |
| Cámaras (Cam v2/v3/v4, Pan, Outdoor, Doorbell...) | Última imagen, movimiento, encendido, sirena, detección de movimiento |
| Floodlight Pro, Battery Cam Pro, Cam OG, Pan v4 | Última imagen y movimiento (sus controles usan otra API de Wyze) |
| Sensor de apertura Wyze Sense (DWS3U, DWS2U) | Abierto/cerrado, batería baja |
| Sensor de movimiento Wyze Sense (PIR3U, PIR2U) | Movimiento, batería baja |
Los demás dispositivos Wyze (cerraduras, termostato, aspiradora, básculas...) se ignoran.
Antes de empezar: crear una clave de API de Wyze
Wyze solo permite que las aplicaciones de terceros inicien sesión con una clave de API personal, además de su correo y su contraseña. La clave también le ahorra el código de verificación en dos pasos.
- Abra la consola de desarrolladores de Wyze e inicie sesión con su cuenta Wyze.
- Cree una clave de API. Copie el KEY ID y la API KEY: la API KEY solo se muestra una vez.
- Guárdelos para la configuración siguiente. Puede revocar la clave desde la misma consola en cualquier momento.
Configuración
- Abra la pestaña Configuración de la integración.
- Introduzca su correo de Wyze, su contraseña, el ID de la clave de API y la clave de API.
- Si lo desea, cambie el intervalo de actualización (60 segundos por defecto, 30 como mínimo): la frecuencia de lectura de los estados y de los eventos de cámara.
- Guarde y pulse Probar la conexión: la integración inicia sesión e indica cuántos dispositivos compatibles ha encontrado.
- Abra la pestaña Descubrimiento y añada a Gladys los dispositivos que desee.
Solo se leen en cada actualización los dispositivos añadidos, lo que alivia la nube de Wyze. Sincronizar ahora fuerza una actualización.
Control local
Wyze es un servicio en la nube, con una excepción: las bombillas de color y las tiras LED aceptan órdenes en su red local. Cuando Preferir la conexión local está activado (por defecto), sus órdenes van directamente a la bombilla; los estados se siguen leyendo en la nube.
La insignia de cada dispositivo indica el canal usado: local, nube o inaccesible cuando Wyze indica que el dispositivo está desconectado. Un punto naranja significa que una orden local falló y la bombilla pasó por la nube; Gladys vuelve a intentar la red local a los 5 minutos. Gladys debe poder alcanzar la bombilla en el puerto TCP 88 (misma red, sin aislamiento de clientes en el Wi-Fi).
Cámaras
La nube de Wyze no ofrece vídeo en directo: la imagen de la cámara en Gladys es la última miniatura que guarda Wyze, normalmente la del último evento. Se actualiza con cada nuevo evento. Gladys solo acepta imágenes de hasta 150 KB; una miniatura más grande se omite (vea los registros).
La función Movimiento de una cámara pasa a 1 durante unos 30 segundos cuando la cámara registra un evento de movimiento, y luego vuelve a 0. La detección depende de los ajustes de la cámara en la aplicación Wyze (zonas de detección, sensibilidad, notificaciones). Los objetos (persona, vehículo, mascota, paquete) requieren una suscripción Cam Plus.
Escenas
La integración añade sus propias tarjetas al editor de escenas (Gladys 5.1 o posterior).
Disparadores:
- Evento de cámara Wyze — una cámara registró un evento. Filtre por
cámara, evento (movimiento, sonido, alarma de humo, alarma de CO, timbre,
cara, otro) y objeto reconocido (persona, vehículo, mascota, paquete, nada).
Un filtro vacío lo acepta todo. Las acciones siguientes pueden leer
{{triggerEvent.data.event}}y{{triggerEvent.data.object}}. - Dispositivo Wyze conectado/desconectado — un dispositivo perdió su
conexión con la nube, o la recuperó. Variable:
{{triggerEvent.data.status}}(offline/online).
Acciones:
- Sirena de cámara Wyze — activa o detiene la sirena de una cámara.
- Detección de movimiento Wyze — activa o desactiva la detección de movimiento de una cámara (por ejemplo, cuando la alarma está armada).
- Imagen de cámara Wyze — publica la última imagen de una cámara, para enviarla después con la acción de Gladys «enviar una imagen de cámara».
- Actualizar dispositivos Wyze — lee los dispositivos de inmediato; devuelve el número de dispositivos y de dispositivos en línea.
Una cámara que no puede ejecutar una acción (Floodlight Pro...) devuelve
false en lugar de fallar, para que las acciones siguientes dependan de ello.
Panel
En el editor del panel hay dos widgets disponibles:
- Resumen Wyze — dispositivos, en línea y sin conexión, puertas y ventanas abiertas, estado de la nube, última actualización, último evento de cámara y un botón Sincronizar.
- Cámara Wyze — elija una cámara en los ajustes del widget: última imagen, movimiento en directo, conexión, último evento y botones de sirena (la sirena pide confirmación).
Solución de problemas
- «Wyze rechazó el inicio de sesión» — revise el correo, la contraseña y que el ID y la clave de API pertenezcan a la misma clave. Tras un rechazo, Gladys espera 15 minutos antes de reintentar (Wyze bloquea las cuentas que inician sesión demasiado a menudo); guardar la configuración reintenta de inmediato.
- Un dispositivo no se actualiza — compruebe en la aplicación Wyze que está en línea; los estados se leen en cada intervalo de actualización.
- Una bombilla de color se queda en la nube — compruebe que Gladys alcanza la bombilla en el puerto TCP 88, o desactive Preferir la conexión local.
- Registros — abra los registros de la integración desde Gladys (o
docker logs), conLOG_LEVEL=debugpara más detalle. Las contraseñas y los tokens nunca se registran.
Privacidad
Gladys guarda sus credenciales en su configuración. La sesión de Wyze (tokens de acceso y de actualización) se conserva en el volumen privado de la integración, para que un reinicio no vuelva a iniciar sesión. La integración solo habla con la nube de Wyze y con sus bombillas de color en la red local.
Esta integración no está afiliada a Wyze Labs. Usa la misma API en la nube que la aplicación Wyze, que Wyze puede cambiar sin previo aviso.
Parámetros de configuración
Estos son los parámetros que Wyze te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Conecte su cuenta Wyze | section | No | Wyze exige una clave de API personal además de su correo y contraseña. Créela en la consola de desarrolladores de Wyze con su cuenta Wyze y copie abajo el ID de la clave y la clave de API. La clave también evita la verificación en dos pasos. |
| Correo de Wyze | string | Sí | |
| Contraseña de Wyze | secret | Sí | |
| ID de la clave de API | string | Sí | El «KEY ID» de la consola de desarrolladores de Wyze. |
| Clave de API | secret | Sí | La «API KEY» que se muestra una sola vez al crear la clave. |
| Intervalo de actualización (s) | number | No | Frecuencia de lectura de los estados y eventos de cámara en la nube de Wyze, en segundos (mínimo 30). |
Cómo instalar Wyze en Gladys
- En Gladys, abre Integraciones: Wyze aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
- Haz clic en Instalar. Gladys descarga la imagen Docker (
ghcr.io/gboulvin/gladys-wyze:1.0.0), la ejecuta en un entorno aislado del núcleo y genera la interfaz de la integración (dispositivos, descubrimiento y configuración). - Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
- También puedes instalarla directamente desde la URL de su repositorio: https://github.com/gboulvin/Gladys-Wyze.
Wyze requiere Gladys >=5.1.0. El catálogo de Gladys se actualiza cada hora, así que una nueva versión está disponible como máximo una hora después de publicarse.
¿Todavía no usas Gladys? Es gratuito y de código abierto: sigue la guía de instalación para empezar.
Sobre las integraciones externas
Wyze es una integración externa: una integración comunitaria empaquetada como contenedor Docker y publicada en GitHub. Gladys la instala con un clic y la ejecuta en un entorno aislado del núcleo. La publica y mantiene gboulvin, no el equipo principal de Gladys.
- Explorar todas las integraciones, nativas y de la comunidad
- Crear y publicar tu propia integración externa
- Código fuente en GitHub — fuente de esta documentación