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

Controle su alarma Somfy Protect y siga sensores, cámaras y alertas en Gladys.
Controle su alarma Somfy Protect desde Gladys: actívela, desactívela, vea lo que indican sus detectores y cámaras, y reaccione a las alarmas en sus escenas.
Somfy Protect es un servicio en la nube: la integración habla con los servidores de Somfy, exactamente como la app Somfy Protect. Se necesita una conexión a Internet; Somfy no ofrece acceso local.
Lo que obtiene
| En Somfy Protect | En Gladys |
|---|---|
| Cada sitio (sistema de alarma) | Un dispositivo «Somfy Protect sitio»: nivel de seguridad + alarma sonando |
| Detector de movimiento | Movimiento (1 durante 30 s en cada detección), batería, temperatura |
| IntelliTag | Detección (1 durante 30 s), batería, temperatura |
| Mando | Presencia (1 = en casa), batería |
| Detector de humo | Humo, batería |
| Cámara interior, Somfy One | Imagen de la cámara, interruptor «Cámara activa» (obturador) |
| Cerradura | Cerrojo (1 = cerrado) |
| Videoportero | Timbre |
| Sirena, Link, repetidor | Batería, temperatura, sabotaje, cuando el dispositivo los indica |
El nivel de seguridad es una lista con tres opciones, que Gladys muestra en inglés: Disarmed (desactivada), Partial (parcial) y Armed (total). Cambiarlo en Gladys lo cambia en Somfy Protect.
Cada dispositivo lleva una insignia Nube. Pasa a Inaccesible cuando la nube de Somfy no responde, o cuando el Link ha perdido el contacto con el dispositivo. La insignia del sitio muestra un punto naranja cuando los eventos en tiempo real están caídos.
Instalación
- En Gladys, abra Integraciones, busque Somfy Protect e instálela.
- En la pantalla Configuración, introduzca el correo y la contraseña de su cuenta Somfy Protect y guarde.
- Pulse Probar la conexión: se muestran sus sitios y dispositivos.
- Abra la pestaña Descubrimiento y cree los dispositivos que desee.
Consejo: cree un usuario dedicado en la app Somfy Protect (Ajustes, Usuarios) para Gladys. Su propia cuenta sigue siendo privada y puede eliminar ese usuario en cualquier momento.
Ajustes
| Ajuste | Por defecto | Función |
|---|---|---|
| Intervalo de actualización (s) | 120 | Frecuencia de lectura de baterías, temperaturas y estados (60 a 3600) |
| Eventos en tiempo real | activado | Alarmas, cambios de nivel y detecciones llegan en un segundo. Necesario para los disparadores |
| Intervalo de capturas de cámara (s) | 0 | Envía una imagen de las cámaras cada N segundos. 0 = solo cuando se pide |
| Registros detallados (depuración) | desactivado | Registra cada petición y evento, para diagnosticar un problema |
Escenas
Disparadores
- Alarma Somfy Protect activada: alarma de intrusión, pánico o incendio. Filtre por sitio y tipo. Variables: nombre del sitio, tipo, nombre del dispositivo que la detectó.
- Alarma Somfy Protect terminada: la alarma se ha detenido.
- Nivel de seguridad Somfy Protect cambiado: filtre por el nuevo nivel.
Los estados de los dispositivos (movimiento, presencia, humo, nivel de seguridad...) también funcionan con el disparador estándar Estado de un dispositivo.
Acciones
- Cambiar el nivel de seguridad Somfy Protect
- Parar la alarma Somfy Protect
- Abrir o cerrar el obturador de una cámara
- Tomar una captura con una cámara Somfy Protect: colóquela antes de la acción Enviar imagen de cámara para recibir una imagen reciente.
Ejemplo: «cuando se active la alarma, tomar una captura con la cámara del salón y enviármela».
Widget del panel
Añada el widget Alarma Somfy Protect a un panel. Muestra el nivel de seguridad, la alarma, los dispositivos inaccesibles o con batería baja, y botones para activar el sitio.
Los botones Desactivar y Parar alarma solo aparecen si el ajuste del widget Permitir desactivar está marcado. Déjelo desmarcado en un panel al alcance de cualquiera (una tableta en la entrada, por ejemplo). Cada botón pide una confirmación.
Solución de problemas
- «Somfy Protect ha rechazado la cuenta»: compruebe primero el correo y la contraseña en la app Somfy Protect.
- «Somfy Protect limita las peticiones»: Somfy bloquea las cuentas que inician sesión demasiado a menudo. Espere los segundos indicados; la integración vuelve a intentarlo sola. Evite guardar la configuración varias veces seguidas.
- Sin eventos en tiempo real: compruebe que el contenedor puede acceder a
websocket.myfox.ioen el puerto 443. Los estados se actualizan igualmente según el intervalo elegido. - Sin imagen de cámara: el obturador de la cámara está cerrado o la cámara está desconectada.
- Active los Registros detallados, reproduzca el problema y lea los registros de la integración. Las contraseñas y los tokens nunca aparecen en ellos.
Privacidad y seguridad
- Su contraseña solo se envía a Somfy. Gladys la guarda como secreto.
- La integración guarda un token de renovación de Somfy en su volumen privado
/data, para no volver a iniciar sesión en cada reinicio. - Esta integración no está hecha ni respaldada por Somfy. Usa los mismos servidores que la app Somfy Protect.
Parámetros de configuración
Estos son los parámetros que Somfy Protect te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Primeros pasos | section | No | Somfy Protect es un servicio en la nube: la integración inicia sesión con el correo y la contraseña de su cuenta de la app Somfy Protect y luego lee su alarma, sus detectores y sus cámaras. Cree un usuario dedicado en la app (Ajustes, Usuarios) si prefiere no compartir su propia cuenta. |
| Correo de Somfy Protect | string | Sí | El correo con el que inicia sesión en la app Somfy Protect. |
| Contraseña | secret | Sí | La contraseña de esa cuenta. Solo se envía a Somfy, nunca se registra. |
| Intervalo de actualización (s) | number | No | Frecuencia de lectura de la nube de Somfy para baterías, temperaturas y estados, en segundos. Las alarmas y detecciones llegan en tiempo real, sea cual sea este valor. |
| Eventos en tiempo real | boolean | No | Recibe alarmas, cambios de nivel y detecciones en un segundo, como la app Somfy Protect. Necesario para los disparadores de escenas. |
| Intervalo de capturas de cámara (s) | number | No | Envía una imagen de las cámaras al panel cada N segundos (mínimo 60). 0 solo toma imágenes cuando se piden: vista en directo del panel, acción de escena. |
| Registros detallados (depuración) | boolean | No | Registra cada petición y cada evento de la nube de Somfy. Actívelo para diagnosticar un problema y desactívelo después: es muy prolijo. Las contraseñas y los tokens nunca se registran. |
Cómo instalar Somfy Protect en Gladys
- En Gladys, abre Integraciones: Somfy Protect 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/prohand/gladys-somfyprotect: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/prohand/gladys-somfyprotect.
Somfy Protect 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
Somfy Protect 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, nativas y de la comunidad
- Crear y publicar tu propia integración externa
- Código fuente en GitHub — fuente de esta documentación