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

Alarma SimpliSafe por la nube SimpliSafe: armado, sensores, Smart Lock, cámaras, timbre.

• Publicado por guim31
• Dispositivos
• Versión 1.0.1
• Requiere Gladys >=5.1.0
• ★ 0

Ver en GitHubTodas las integraciones

Lleva su alarma SimpliSafe a Gladys, a través de la nube de SimpliSafe (la que usa la aplicación SimpliSafe): el estado de la alarma (desarmada, armada en casa, armada ausente, retardos de salida y de entrada, alarma), la base (en línea, alimentación de red, batería de respaldo, alertas), cada sensor (apertura, movimiento, rotura de cristal, humo, monóxido de carbono, agua, helada, teclado, botón de pánico, sirena: detección, batería baja, en línea), la Smart Lock, y las SimpliCam, cámaras exteriores y Video Doorbell Pro (imagen del último movimiento o timbrazo, timbre). El armado, las alarmas, el timbre y las cerraduras llegan en tiempo real por el WebSocket que usa la aplicación.

Desarrollada sin el hardware: se agradecen sus comentarios. Esta integración se escribió a partir del trabajo de la integración simplisafe de Home Assistant, de la biblioteca simplisafe-python y de homebridge-simplisafe3, sin un sistema ni una cuenta SimpliSafe a mano. Si algo no funciona como se describe, abra una incidencia en github.com/guim31/gladys-simplisafe/issues con los registros de la integración (LOG_LEVEL=debug).

Esta integración no está afiliada a SimpliSafe. SimpliSafe es una marca de SimpliSafe, Inc.

Lo que necesita

• Un sistema SimpliSafe 3 (la generación actual, vendida desde 2018) y la cuenta SimpliSafe de la aplicación. El plan gratuito basta para los estados; armar y desarmar a distancia requieren un plan con control remoto.
• La verificación en dos pasos activada en la cuenta (aplicación SimpliSafe, Ajustes): sin ella, SimpliSafe nunca da el código de inicio de sesión que necesita la integración (lo comprobaron los usuarios de Home Assistant).
• Un ordenador con Chrome o Edge para el inicio de sesión (una sola vez).
• Gladys 5.1 o posterior, con acceso a Internet.

Instalación

Abra Integraciones → SimpliSafe → Configuración, elija las opciones de abajo y guarde; después inicie sesión. Abra la pestaña Descubrir y añada los dispositivos que quiera.

Inicio de sesión

SimpliSafe inicia sesión en su propia página, que luego envía el navegador a una dirección que solo abre la aplicación móvil (com.simplisafe.mobile://…). El navegador no muestra nada, pero la dirección aparece en sus herramientas de desarrollo: es la que usted copia en Gladys. Gladys nunca ve su contraseña.

1. Pulse Conectar junto a Cuenta SimpliSafe: la página de inicio de sesión de SimpliSafe se abre en una pestaña nueva. En esa pestaña, abra las herramientas de desarrollo (F12, o Cmd+Option+I en Mac), pestaña Consola.
2. Inicie sesión con el correo y la contraseña de la aplicación SimpliSafe y confirme el inicio de sesión (código o enlace enviado por correo o SMS).
3. Después la página parece no hacer nada: es normal. En la consola, una línea roja dice algo como Failed to launch 'com.simplisafe.mobile://auth.simplisafe.com/ios/com.simplisafe.mobile/callback?code=…'. Copie esa línea, o solo la dirección.
4. En los minutos siguientes, péguela en la acción Terminar el inicio de sesión al final de la página de configuración y ejecútela. La respuesta muestra los sistemas encontrados.

¿Nada en la consola? Abra la pestaña Red antes de iniciar sesión: la última línea, en rojo, lleva la dirección en su encabezado Location. Si ya tiene la sesión de SimpliSafe abierta en este navegador, la página puede saltar directamente al final: abra una ventana privada y empiece de nuevo desde Conectar. Un código sirve una vez y unos minutos; cada Conectar crea una página nueva, y solo funciona el código de la última.

Ajustes

• Cuenta SimpliSafe: el botón Conectar y el estado de la conexión.

• Armado desde Gladys:

  • Desactivado (solo estado), por defecto: Gladys muestra el estado de la alarma sin cambiarlo nunca;
  • Solo armar: el widget y la acción de escena pueden armar (en casa, ausente), nunca desarmar;
  • Armar y desarmar: quien use sus paneles y escenas de Gladys también puede desarmar. Desarmar desde el widget pide una confirmación.

  Por qué desactivado por defecto: con vigilancia profesional, una alarma armada por error con alguien en casa llama a la central, y una falsa alarma suele cobrarse; un desarmado desde un panel compartido abre la casa. El estado de la alarma nunca es un interruptor: ningún asistente de voz ni ninguna escena de «valor del dispositivo» puede cambiarlo, solo el widget y la acción de abajo.

• Permitir desbloquear la Smart Lock: desactivado por defecto. Gladys siempre puede cerrar la puerta; abrirla requiere esta opción.

• Lectura de sensores: frecuencia de lectura de sistemas, sensores y cerraduras (30 s, 1, 2 o 5 minutos; 1 minuto por defecto). El armado, las alarmas, el timbre y las cerraduras llegan en tiempo real de todos modos.

• Idioma de los nombres: el idioma de los nombres de los dispositivos y funciones. Gladys conserva los nombres elegidos al añadir un dispositivo.

Acciones de configuración

• Terminar el inicio de sesión: vea arriba.
• Probar la conexión: muestra los sistemas de la cuenta. No se arma ni se desarma nada.
• Cerrar sesión: borra los tokens guardados por Gladys. Los dispositivos se mantienen, sin nuevas lecturas.

Los dispositivos

El sistema

Un dispositivo por base, con el nombre del lugar:

• Estado de la alarma: Desarmada, Armada (en casa), Armada (ausente), Retardo de salida, Retardo de entrada o Alarma en curso (valores off, home, away, exit_delay, entry_delay, alarm en las escenas). Solo lectura.
• En línea: la base alcanza la nube de SimpliSafe.
• Alimentación de red: 0 durante un corte de luz (la base funciona con su batería).
• Batería de respaldo: el valor que SimpliSafe da para la batería de respaldo, probablemente en milivoltios (unos 5.000 con la batería cargada).
• Alertas: el último mensaje de la aplicación SimpliSafe (corte de luz, error de sensor…), con su número cuando hay varios, o «Ninguna alerta».

Sensores

Un dispositivo por sensor, llamado «nombre en la aplicación - tipo»:

• Sensor de apertura: Apertura (abierto o cerrado). Leído en cada lectura, y puesto en abierto al instante por una alarma o una alerta secreta.
• Sensor de movimiento: Movimiento; sensor de rotura de cristal: Rotura de cristal. SimpliSafe no guarda estado para ellos: pasan a 1 durante un minuto cuando una alarma o una alerta secreta los nombra, 0 si no. Configure una alerta secreta en la aplicación SimpliSafe para ver cada detección, incluso desarmada.
• Detector de humo: Humo y Manipulación; detector de humo y CO: Humo, Monóxido de carbono y Manipulación; detector de CO: Monóxido de carbono.
• Sensor de agua: Fuga de agua.
• Sensor de helada: Temperatura (en °F, mostrada en su unidad) y Alerta de temperatura (fuera de los límites fijados en la aplicación).
• Teclado, mando, botón de pánico, sirenas: sin detección.
• Todos los sensores: Batería baja y En línea.

Lo que es fiable: la base sigue los sensores de apertura, humo, CO, agua y helada, y la integración los lee en cada Lectura de sensores (pidiendo valores frescos a la base, como Home Assistant). El movimiento y la rotura de cristal solo se ven por los eventos.

Smart Lock

Bloqueo (cerrar o abrir, vea la opción de arriba), Estado de la cerradura (cerrada, abierta, error cuando el pestillo se atasca), Batería baja, Batería baja del teclado y En línea.

Cámaras y timbres

Imagen: la imagen del último movimiento o timbrazo cuando SimpliSafe la proporciona, o una imagen en directo de una SimpliCam con cable de primera generación cuyo obturador de privacidad está abierto en el modo actual (una imagen nunca abre un obturador ni despierta una cámara de batería). Movimiento (1 durante un minuto tras un movimiento), Timbre (en un timbre: 1 unos segundos tras un timbrazo) y En línea.

Panel

El widget Alarma SimpliSafe muestra el estado de la alarma, la base, la alimentación, las aperturas, las baterías bajas y las alertas, y los botones Armar (en casa), Armar (ausente) y Desarmar que permite Armado desde Gladys. El modo actual está marcado con una marca de verificación. Elija el sistema en los ajustes del widget cuando la cuenta tenga varios.

Escenas

Disparadores

• Alarma SimpliSafe disparada: la alarma saltó. Filtro por sistema y tipo (intrusión, incendio, monóxido de carbono, agua, helada, pánico). Variables: el tipo, el nombre del sensor.
• SimpliSafe armada o desarmada: desde la aplicación, un teclado, un mando o Gladys. Filtro por sistema, nuevo modo y origen. Variables: el modo, el origen, el nombre del PIN cuando SimpliSafe lo indica (por ejemplo «Master PIN»).
• Timbre SimpliSafe pulsado: filtro por timbre. La imagen de la cámara es la del timbrazo cuando SimpliSafe la proporciona.

La función Estado de la alarma también sirve como disparador de dispositivo; los disparadores de arriba añaden el tipo de alarma, quién armó y el timbrazo.

Acciones

• Armar o desarmar SimpliSafe: arma (en casa, ausente) o desarma, en la medida en que lo permita Armado desde Gladys. Salida: el estado tras la orden (exit_delay cuando el sistema tiene un retardo de salida).
• La Smart Lock es una cerradura normal: «cambiar el valor» de Bloqueo.

Ideas de escenas

• Alarma SimpliSafe disparada → encender todas las luces y enviar la imagen de la cámara por mensaje.
• SimpliSafe armada o desarmada, nuevo modo Armada (ausente) → apagar la calefacción y las luces; modo Desarmada desde el teclado → encender la luz de la entrada.
• Timbre SimpliSafe pulsado → enviar la imagen del timbre a su teléfono.
• Cada noche a las 23 h, si el estado de la alarma es Desarmada → Armar o desarmar SimpliSafe (Armada (en casa)), con «Solo armar».

Actualización y límites de la nube

La API de SimpliSafe es la API no oficial de las aplicaciones: sin cuota publicada. La integración lee cada minuto por defecto (Home Assistant: cada 30 s), solo los sistemas que tienen un dispositivo en Gladys, los ajustes de la base cada 10 minutos, y escucha el WebSocket para el resto. Cuando SimpliSafe responde 403 (su forma de rechazar a un cliente que pregunta demasiado), las lecturas se detienen 1 minuto, luego el doble cada vez, hasta 2 horas. Justo después de un armado, un sistema con Smart Lock se deja tranquilo 20 s: SimpliSafe tiene un fallo por el que la base anuncia entonces que la cerradura no responde.

Solución de problemas

• «Sin sesión»: haga el inicio de sesión de arriba. «SimpliSafe rechazó la sesión guardada»: la contraseña cambió, o la cuenta cerró la sesión de todos los dispositivos: inicie sesión de nuevo.
• «SimpliSafe rechazó el código»: el código ya se usó, tiene más de unos minutos o viene de un Conectar anterior: pulse Conectar de nuevo.
• Ningún código en la consola: compruebe que la verificación en dos pasos está activada, use Chrome o Edge, una ventana privada y la pestaña Red.
• «El plan de SimpliSafe de este sistema no permite el control remoto»: el plan no incluye el armado desde la aplicación.
• Un sensor se queda en «sin valor reciente»: SimpliSafe no informa de este tipo de sensor (movimiento, rotura de cristal) hasta un evento.
• Registros: Integraciones → SimpliSafe → Registros; con LOG_LEVEL=debug para cada lectura y cada evento. Nunca se escribe ningún token, código, dirección ni nombre de PIN.

Límites

• Desarrollada sin el hardware: el comportamiento es el de las bibliotecas que sigue, comprobado con sus respuestas grabadas.
• Los sistemas SimpliSafe 2 (antes de 2018) aparecen pero no son compatibles.
• Sin vídeo en directo, sin control de la sirena, sin gestión de PIN, sin cambios en los ajustes del sistema (volúmenes, retardos).
• Las cámaras de la última generación emiten por otro servicio: solo muestran la imagen de sus eventos.
• Un evento perdido mientras el WebSocket se reconecta no dispara su escena; los estados se ponen al día en la lectura siguiente.
• El valor Batería de respaldo es el valor bruto de SimpliSafe.

Parámetros de configuración

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

Parámetro	Tipo	Obligatorio	Descripción
Antes de empezar	section	No	Esta integración inicia sesión en su cuenta SimpliSafe como la aplicación y sigue su sistema SimpliSafe 3 en tiempo real: estado de la alarma, sensores, Smart Lock, cámaras y timbre. La cuenta debe tener activada la verificación en dos pasos (aplicación SimpliSafe, Ajustes). Desarrollada sin el hardware: se agradecen sus comentarios. Sin relación con SimpliSafe.
Inicio de sesión	section	No	En un ordenador, preferiblemente en Chrome o Edge: 1. Pulse Conectar: la página de inicio de sesión de SimpliSafe se abre en una pestaña nueva. En esa pestaña, abra las herramientas de desarrollo (F12, o Cmd+Option+I en Mac), pestaña Consola. 2. Inicie sesión con el correo y la contraseña de la aplicación SimpliSafe y confirme el inicio de sesión (código o enlace enviado por correo o SMS). 3. Después la página parece no hacer nada: es normal. En la consola, una línea roja cita una dirección que empieza por com.simplisafe.mobile:// y contiene code=. Copie esa dirección. 4. En los minutos siguientes, péguela en la acción «Terminar el inicio de sesión» al final de esta página. Gladys nunca ve su contraseña. ¿Nada en la consola? Abra la pestaña Red antes de iniciar sesión, o consulte la guía.
Cuenta SimpliSafe	account_link	No
Armado desde Gladys	select	No	Desactivado: Gladys muestra el estado de la alarma sin cambiarlo nunca. Solo armar: el widget y las escenas pueden armar (en casa, ausente). Armar y desarmar: quien use sus paneles y escenas también puede desarmar. Nunca por voz.
Permitir desbloquear la Smart Lock	boolean	No	Desactivado: Gladys puede cerrar la puerta, nunca abrirla. Activado: quien use sus paneles y escenas puede abrirla.
Lectura de sensores	select	No	Frecuencia de lectura de sistemas, sensores y cerraduras. El armado, las alarmas, el timbre y las cerraduras llegan en tiempo real de todos modos.
Idioma de los nombres	select	No	Gladys conserva los nombres elegidos al añadir un dispositivo.

Cómo instalar SimpliSafe en Gladys

1. En Gladys, abre Integraciones: SimpliSafe 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/guim31/gladys-simplisafe: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).
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/guim31/gladys-simplisafe.

SimpliSafe 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

SimpliSafe 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

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 🙂