Integración domótica Verisure, gratuita y de código abierto

Conecte, desconecte y siga su alarma Verisure, sus detectores y sensores desde Gladys.

• Publicado por prohand
• Dispositivos
• Versión 1.1.0
• Requiere Gladys >=5.1.0
• ★ 0

Ver en GitHubTodas las integraciones externas

Controle su alarma Verisure desde Gladys: conéctela, desconéctela, siga sus detectores y reaccione en sus escenas.

La integración pasa por la nube de Verisure (distintivo «Nube» en los dispositivos): necesita acceso a Internet, y los datos se actualizan cada 2 minutos por defecto. API no oficial: Verisure puede cambiarla sin previo aviso.

¿Qué aplicación Verisure?

Existen dos nubes Verisure, con cuentas y funciones distintas. Elija la de la aplicación que utiliza:

Aplicación	Países	Lo que ve Gladys
My Verisure	Francia, España, Italia, Portugal, Reino Unido, Irlanda, Argentina, Brasil, Chile, Perú	La alarma (todos sus modos, perimetral incluido) y los sensores de confort (temperatura, humedad)
Verisure	Suecia, Noruega, Dinamarca, Finlandia, Bélgica, Países Bajos, Alemania…	La alarma (desconectada, conexión parcial, conexión total), detectores de apertura, sensores de temperatura/humedad, enchufes inteligentes y cerraduras inteligentes

Configuración

1. Abra la pestaña Configuración de la integración.
2. Elija su aplicación Verisure y, para My Verisure, su país.
3. Escriba el usuario y la contraseña de su aplicación.
4. Solo aplicación Verisure: escriba el código de la alarma (el del teclado). Conecta, desconecta y controla las cerraduras. My Verisure no lo necesita.
5. Guarde y pulse después Probar la conexión.

El código de verificación (primera conexión)

En la primera conexión, Verisure pide validar este nuevo «dispositivo»:

1. pulse Enviar un código: Verisure envía un código por SMS (o correo electrónico);
2. escriba el código en Validar el código y pulse el botón.

Se hace una sola vez: la sesión se guarda en la carpeta /data de la integración, un reinicio no pide un nuevo código. Si Verisure vuelve a pedirlo más adelante (contraseña cambiada, sesión caducada), el estado de conexión de la pantalla de configuración lo indica, y sus escenas pueden saberlo con el desencadenante Se ha perdido la conexión con Verisure.

Los demás ajustes

• Intervalo de actualización: 120 segundos por defecto, 60 como mínimo. Verisure bloquea las cuentas que consultan demasiado (a veces durante horas): no lo reduzca sin motivo.
• Registros detallados: registra cada intercambio con Verisure (nunca la contraseña, los códigos ni los tokens), para diagnosticar un problema.

Los botones

• Probar la conexión: inicia sesión y muestra sus instalaciones y su modo.
• Enviar un código / Validar el código: la validación por SMS descrita arriba.
• Olvidar la sesión: cierra la sesión en Verisure y borra la sesión guardada. La próxima conexión puede volver a pedir un código.

Dispositivos

Una vez conectado, abra la pestaña Descubrir y añada los dispositivos con Añadir a Gladys:

• Verisure nombre de la instalación: el modo de la alarma, una selección. Los modos ofrecidos son los de su central: Desconectada, Parcial (día), Parcial (noche) y Total, más los modos perimetrales cuando su instalación tiene detectores exteriores. Elegir un modo envía la orden; el valor cambia cuando Verisure la ha confirmado (de unos segundos a un minuto y medio).
• Detectores de apertura (aplicación Verisure): abierto / cerrado.
• Sensores de temperatura y humedad.
• Enchufes inteligentes y cerraduras (aplicación Verisure).

Cuando la alarma se niega a conectarse (una puerta o una ventana abierta), la orden falla y Gladys muestra el error.

Escenas

La integración añade sus propias tarjetas al editor de escenas (Gladys 5.1 o posterior), en la categoría Integraciones.

Desencadenantes

• El modo de la alarma Verisure ha cambiado: conectada o desconectada desde el teclado, una llave, la aplicación o un mando. Filtre por la alarma y el nuevo modo. Las acciones siguientes pueden leer {{triggerEvent.data.mode}}, {{triggerEvent.data.previous_mode}} y {{triggerEvent.data.changed_by}} (quién lo cambió, cuando Verisure lo indica). Las órdenes de la propia Gladys nunca lo activan, para evitar bucles.
• Un detector de apertura Verisure ha cambiado (aplicación Verisure): filtre por el detector y el estado (abierta, cerrada).
• Se ha perdido la conexión con Verisure: Verisure ya no responde, rechaza el inicio de sesión, limita las solicitudes o pide un nuevo código. Ideal para enviarse un mensaje.

Los valores de los modos: disarmed, armed_home (parcial día), armed_night (parcial noche), armed_away (total), perimeter, armed_home_perimeter, armed_night_perimeter, armed_away_perimeter.

Acciones

• Cambiar el modo de la alarma Verisure: elija la alarma (vacío = la única de la cuenta) y el modo. Marque Conectar aunque haya una puerta o ventana abierta para forzar cuando la central lo permita. Resultados para las acciones siguientes: success (true / false), mode (el modo de la alarma) y reason (por qué se rechazó, p. ej. la puerta abierta). Un rechazo no detiene la escena: compruebe success en una condición.
• Leer ahora la alarma Verisure: pide a la alarma su estado real sin esperar a la próxima actualización. Resultado: mode.

Panel

En Panel → Editar → Nuevo widget, añada el widget Alarma Verisure: modo de la alarma (verde desconectada, naranja conexión parcial, rojo conexión total), último cambio (quién, hace cuánto), puertas y ventanas abiertas, conexión, temperatura y botones para conectar (cada pulsación pide una confirmación).

El botón Desconectar solo aparece cuando marca Mostrar un botón Desconectar en la configuración del widget. Atención: cualquiera que vea ese panel podrá entonces desconectar su alarma. No lo marque en un panel compartido ni en uno mostrado en la entrada.

Solución de problemas

• «Verisure pide un código de verificación»: siga la validación por código.
• «Verisure ha rechazado el usuario o la contraseña»: compruébelos en la aplicación Verisure, así como la aplicación elegida (My Verisure o Verisure). La integración deja de intentarlo hasta que cambie la configuración, para que su cuenta no se bloquee.
• «Verisure limita las solicitudes»: la integración espera 15 minutos antes de volver a intentarlo. Aumente el intervalo de actualización si vuelve a ocurrir.
• Falta el código de la alarma (aplicación Verisure): rellénelo para conectar, desconectar y controlar las cerraduras.
• Para los detalles, active los registros detallados y lea los registros de la integración desde Gladys.

Parámetros de configuración

Estos son los parámetros que Verisure te pide en su pantalla de configuración en Gladys.

Parámetro	Tipo	Obligatorio	Descripción
Primeros pasos	section	No	Utilice el usuario de su aplicación Verisure. Existen dos nubes Verisure: «My Verisure» (Francia, España, Italia, Portugal, Reino Unido, Irlanda, Latinoamérica) y «Verisure» (países nórdicos, Benelux, Alemania…). La primera conexión pide un código enviado por SMS o correo electrónico: guarde, pulse «Enviar un código» y escríbalo después en «Validar el código».
Aplicación Verisure	select	Sí	La aplicación con la que controla su alarma.
País (My Verisure)	select	No	País de su contrato. Solo lo usa la aplicación My Verisure.
Usuario	string	Sí	El usuario de su aplicación Verisure (correo electrónico o número de cliente).
Contraseña	secret	Sí
Código de la alarma	secret	No	Solo aplicación Verisure: el código que conecta y desconecta la alarma y controla las cerraduras. My Verisure no lo necesita.
Intervalo de actualización (s)	number	No	Frecuencia de lectura de Verisure, en segundos. Verisure bloquea las cuentas que consultan demasiado: mantenga 120 o más.
Registros detallados	boolean	No	Registra cada intercambio con Verisure (sin contraseña ni token), para diagnosticar un problema.

Cómo instalar Verisure en Gladys

1. En Gladys, abre Integraciones: Verisure aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
2. Haz clic en Instalar. Gladys descarga la imagen Docker (ghcr.io/prohand/gladys-verisure:1.1.0), la ejecuta en un entorno aislado del núcleo y genera la interfaz de la integración (dispositivos, descubrimiento y configuración).
3. Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
4. También puedes instalarla directamente desde la URL de su repositorio: https://github.com/prohand/gladys-verisure.

Verisure 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

Verisure 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 prohand, no el equipo principal de Gladys.

• Explorar todas las integraciones externas
• Descubrir las integraciones nativas incluidas en Gladys
• Crear y publicar tu propia integración externa
• Código fuente en GitHub — fuente de esta documentación

Suscríbete a la newsletter de Gladys Assistant

Unos pocos correos al mes sobre nuevas versiones y novedades del proyecto. Enviados por Pierre-Gilles Leymarie, fundador del proyecto. Puedes darte de baja cuando quieras 🙂