Integración domótica Weenect, gratuita y de código abierto
Localizadores GPS Weenect para gatos, perros, niños y mayores: zonas, batería, timbre.
Publicado por guim31
- Dispositivos
- Versión 1.0.1
- Requiere Gladys >=5.1.0
- ★ 0
Siga sus localizadores GPS Weenect (gato, perro, niño, persona mayor) en Gladys: la zona en la que están (casa, jardín, colegio…), la batería, la última posición, y hágalos sonar o vibrar desde un panel o una escena.
Desarrollada sin el hardware: esta integración se ha escrito a partir de la API que usa la aplicación Weenect y de la integración equivalente de Home Assistant, sin localizador ni cuenta Weenect a mano. Sus comentarios son bienvenidos en el foro de Gladys o en las issues de GitHub.
Integración comunitaria, sin afiliación con Weenect.
Presentación
Cada localizador de su cuenta Weenect se convierte en un dispositivo de Gladys. La integración lee la nube de Weenect a intervalos regulares (cada minuto por defecto) y publica:
- en qué zona está el localizador, según las zonas que usted ha dibujado en la aplicación Weenect («Casa», «Jardín», «Colegio»…);
- su nivel de batería, y una alerta de batería baja en el umbral ajustado en la aplicación Weenect;
- si está en línea o fuera de línea;
- su última posición (coordenadas, precisión, hora), salvo si elige conservar solo las zonas.
También añade dos disparadores de escena (entra y sale de una zona), una acción de escena para iniciar el super live y un widget para el panel.
Requisitos
- Gladys 5.1.0 o posterior.
- Un localizador Weenect con una suscripción activa, y la cuenta usada en la aplicación Weenect (correo y contraseña). Una cuenta creada con Google o Apple puede no tener contraseña: defina una desde la aplicación o la web de Weenect («he olvidado mi contraseña»).
- Las zonas que desea seguir, creadas en la aplicación Weenect.
- Gladys debe poder acceder a Internet (
apiv4.weenect.com).
Configuración
- Instale la integración desde Integraciones → Instalar desde GitHub (o desde el catálogo cuando figure en él).
- En la pestaña Configuración, introduzca el correo y la contraseña de su cuenta Weenect.
- Elija lo que Gladys guarda de la posición:
- Coordenadas y zonas (por defecto): la posición, su precisión y un enlace al mapa;
- Solo zonas: Gladys sabe si el localizador está en una zona, nunca dónde está (vea «Privacidad»).
- Elija la frecuencia de actualización (de 30 segundos a 10 minutos, 1 minuto por defecto) y el idioma de los textos (francés por defecto).
- Guarde y pulse Probar la conexión: el botón muestra el número de localizadores encontrados.
- Abra la pestaña Descubrir y añada sus localizadores a Gladys. Los valores llegan enseguida.
Los nombres de las funciones se fijan al añadir el dispositivo, en el idioma elegido en ese momento.
Dispositivos
Un dispositivo por localizador, con estas funciones:
| Función | Lo que indica |
|---|---|
| Posición | «45.76400, 4.83570», u «Oculta» en el modo «Solo zonas» |
| Precisión de la posición | Radio de incertidumbre de la última posición, en metros |
| Última posición | Fecha y hora de la última posición enviada por el localizador |
| Batería | Nivel de batería, en % |
| Batería baja | Sí cuando la batería baja del umbral de alerta de la aplicación Weenect |
| En línea | Sí cuando el localizador se comunica con Weenect |
| Estado | En línea, fuera de línea o super live (iniciado desde Gladys) |
| En una zona | Sí cuando el localizador está en al menos una de sus zonas |
| Zona actual | Nombre de la zona (la más pequeña si hay varias), o «Fuera de las zonas» |
| Zona: Casa (una por zona) | Sí cuando el localizador está en esa zona |
| Hacer sonar | Botón: el localizador suena (si el modelo lo permite) |
| Hacer vibrar | Botón: el localizador vibra (si el modelo lo permite) |
| Pedir una posición | Botón: el localizador envía una nueva posición en cuanto puede |
Una zona añadida más tarde en la aplicación Weenect aparece en la pestaña Descubrir con un botón Actualizar: un clic la añade al dispositivo. Una zona renombrada conserva su función (Gladys la reconoce por su identificador, no por su nombre).
Widget
El widget Localizadores Weenect se añade desde la edición del panel.
- Sin ajuste, lista todos los localizadores añadidos a Gladys: nombre, zona, batería (distintivo verde, naranja o rojo). Al tocar un localizador se muestran los detalles (estado, hora de la última posición, precisión) y el enlace a OpenStreetMap.
- Con un localizador elegido, muestra su batería en directo, su zona, su estado y botones: Mapa, Sonar, Vibrar y Super live (que pide una confirmación).
Disparadores de escena
- Localizador Weenect entra en una zona
- Localizador Weenect sale de una zona
Ambos se filtran por localizador y por nombre de zona (vacío: cualquier zona). Escriba el nombre de la zona exactamente como en la aplicación Weenect. Las acciones de la escena pueden usar el nombre del localizador, la zona, la batería y el enlace al mapa (vacío en el modo «Solo zonas»).
¿Por qué disparadores además de las funciones «Zona: …»? Una sola escena basta para «cualquier localizador sale de cualquier zona», y el mensaje puede decir cuál y dónde. Para «¿está el gato en casa?» como condición, use mejor la función Zona: Casa o En una zona.
No hay disparador de «batería baja»: la función Batería baja basta (disparador «cambia el valor de un dispositivo»).
Acción de escena
Iniciar el super live de Weenect: el localizador envía una posición cada pocos segundos durante unos 5 minutos. Mientras tanto, Gladys lee la cuenta cada 10 segundos. El super live agota rápido la batería: la integración nunca lo inicia por sí misma, solo desde una escena o el widget.
Ejemplos de escenas
- El gato ha salido del jardín: disparador «Localizador Weenect sale de una zona», localizador «Minou», zona «Jardín» → enviar un mensaje «Minou ha salido del jardín», completado con las variables «Batería (%)» y «Enlace al mapa».
- Los niños han vuelto del colegio: disparador «Localizador Weenect entra en una zona», zona «Casa», un día laborable entre las 16 y las 18 h → mensaje con la variable «Nombre del localizador»: «… ha llegado a casa».
- El perro se ha escapado de noche: disparador «Localizador Weenect sale de una zona», zona «Casa», condición «es de noche» → iniciar el super live de Weenect en ese localizador y enviar el enlace al mapa.
- Acordarse de cargar: la «Batería baja» del collar pasa a Sí → mensaje por la tarde.
Privacidad
La posición de un niño o de un familiar es un dato sensible.
- En el modo Solo zonas, las coordenadas se leen en Weenect para calcular las zonas dentro del contenedor de la integración, y nunca salen de él: ninguna función de posición (muestra «Oculta»), ningún enlace al mapa en el widget ni en las escenas. Pasar a «Solo zonas» sustituye enseguida la última posición que Gladys había guardado.
- En todos los modos, ninguna coordenada, ningún correo, ninguna contraseña
ni ningún token se escribe en los registros, ni siquiera con
LOG_LEVEL=debug. - La función Posición es un texto: Gladys no guarda su historial, solo el último valor.
- El token de sesión de Weenect se guarda en el volumen
/datade la integración (sin nuevo inicio de sesión en cada arranque), con una huella del correo, nunca el correo ni la contraseña.
Actualización y límites de la API
- Una lectura = una llamada a la nube de Weenect para toda la cuenta, más una llamada por localizador cada 30 minutos para volver a leer las zonas.
- Gladys solo lee la cuenta si al menos un localizador está añadido.
- Weenect no publica condiciones de uso ni cuota para su API. Por prudencia: 30 segundos como máximo (la integración de Home Assistant también lee cada 30 segundos), 10 segundos solo durante un super live iniciado desde Gladys. Si Weenect responde «demasiadas solicitudes», las lecturas se suspenden el tiempo que pida (5 minutos por defecto).
- Una contraseña rechazada detiene los intentos hasta la siguiente modificación de la configuración: un bucle de inicios de sesión rechazados podría bloquear la cuenta.
- El localizador envía sus posiciones al ritmo ajustado en la aplicación Weenect: leer más a menudo no hace la posición más reciente.
Solución de problemas
- «Weenect rechaza el correo o la contraseña»: compruébelos en la aplicación Weenect, corrija la configuración y guarde; Probar la conexión lo vuelve a intentar enseguida.
- «Weenect no está disponible»: Gladys lo vuelve a intentar en cada actualización; compruebe el acceso a Internet de la máquina de Gladys.
- Ningún localizador en la pestaña Descubrir: pulse Probar la conexión; Weenect puede no devolver un localizador sin suscripción activa.
- Falta una zona: créela en la aplicación Weenect, abra la pestaña Descubrir y pulse Actualizar.
- El disparador no se activa: el nombre de zona del filtro debe escribirse exactamente como en la aplicación. Una salida solo se detecta cuando la posición está lo bastante lejos del borde de la zona (su precisión, de 25 a 100 m).
- Más detalles: ponga
LOG_LEVEL=debugen las variables del contenedor; los registros muestran cada lectura, sin posición ni secreto.
Límites
- El mapa de Gladys 5.2 solo muestra los usuarios, las casas y las zonas de Gladys, no los dispositivos: la posición se publica como texto, y el mapa se abre con un enlace a OpenStreetMap.
- Gladys calcula la zona a partir de la última posición y de las zonas de la aplicación Weenect (centro y radio): puede diferir unos metros de las alertas de la aplicación Weenect.
- Gladys solo conoce el super live si se ha iniciado desde Gladys; su duración (unos 5 minutos) es una estimación.
- No se ajustan desde Gladys el modo de seguimiento, las zonas, los contactos SOS ni el botón SOS: siguen en la aplicación Weenect.
- La API de Weenect no es pública: puede cambiar sin previo aviso.
- Desarrollada sin el hardware: modelos probados solo con las respuestas de la
API publicadas por la biblioteca
aioweenect.
Parámetros de configuración
Estos son los parámetros que Weenect te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Su cuenta Weenect | section | No | Utilice el correo y la contraseña de la aplicación Weenect. Gladys lee sus localizadores desde la nube de Weenect. Sin afiliación con Weenect. |
| Correo de Weenect | string | Sí | |
| Contraseña de Weenect | secret | Sí | |
| Lo que Gladys guarda de la posición | select | No | «Solo zonas»: Gladys sabe si un localizador está en una zona, nunca sus coordenadas (sin enlace al mapa). |
| Frecuencia de actualización | select | No | Con qué frecuencia Gladys lee la cuenta Weenect. El localizador envía posiciones al ritmo ajustado en la aplicación Weenect. |
| Idioma de los textos | select | No | Idioma de los nombres de las funciones (fijados al añadir un dispositivo) y de los textos que publica la integración. |
Cómo instalar Weenect en Gladys
- En Gladys, abre Integraciones: Weenect 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/guim31/gladys-weenect:1.0.1), 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/guim31/gladys-weenect.
Weenect 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
Weenect 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 guim31, 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