Cuando redacté la primera guía para conectar la alarma Ajax a Home Assistant, había que hacer malabares entre SIA, Jeedom, MQTT, topics por doquier… El resultado funcionaba a la perfección, pero había que amar los laberintos. Hoy, cambio total de escenario: unos desarrolladores han creado una integración nativa Ajax Home Assistant, instalable a través de HACS, que se comunica directamente con la API Cloud oficial de Ajax. Armar, desarmar, notificaciones, sensores, relés… todo sube a Home Assistant, en tiempo (casi) real!

Instalada en mi casa desde hace unos días, les propongo descubrir un poco más en detalle este plugin tan esperado…

Recordatorio rápido sobre métodos antiguos

Hasta ahora, para hablar de Ajax Home Assistant, había dos enfoques.

El primero pasaba por la integración SIA Alarm Systems de Home Assistant. La alarma Ajax se configuraba como si Home Assistant fuera un centro de monitoreo. Se recuperaba el estado del sistema, algunas informaciones de incendios/inundaciones, y eso era todo. Imposible controlar la alarma, ningún detalle sobre cada sensor. Era sobre todo útil para activar algunos escenarios a partir del estado global de la alarma, como por ejemplo poner el calefactor en modo eco cuando se activaba la alarma al salir de casa.

El segundo método, detallado en mi guía anterior, consistía en utilizar el plugin Ajax en Jeedom, y luego republicar toda la información en Home Assistant a través de MQTT. Mucho más completo, con la subida de casi todos los sensores Ajax, pero a costa de un segundo servidor de domótica, de un broker MQTT, y de un mapeo de decenas de topics… En resumen, muy potente, pero claramente no al alcance de todos.

El nuevo plugin cambia completamente el juego: Ajax Home Assistant se convierte en una pareja mucho más fácil de implementar.

Lo que permite el nuevo plugin Ajax Home Assistant

La integración ajax-hass es un componente personalizado de Home Assistant que se conecta directamente a la nube de Ajax a través de la API oficial y un flujo gRPC, exactamente como la aplicación móvil de Ajax. Concretamente, tu Hub Ajax se convierte en un “ciudadano de primera clase” en Home Assistant, con un verdadero panel de alarma y entidades para sensores, sirenas, relés, enchufes, etc.

Obtienes, entre otras cosas, un control completo de la seguridad. El panel de alarma de Home Assistant permite el armado total, el desarmado, el modo noche, el armado parcial por grupo, e incluso el armado forzado cuando algunos sensores permanecen abiertos. Un servicio dedicado gestiona el botón de pánico, que se puede colocar en un tablero de control o en un control remoto virtual.

En cuanto a la información, el plugin expone los eventos de armado/desarmado con el nombre del usuario de Ajax, las notificaciones de alarma, las detecciones de movimiento, las aperturas de puertas y ventanas, las alarmas de incendios o inundaciones, así como sensores “técnicos” como el nivel de batería, la calidad de señal, la temperatura o el estado de la conexión. Es muy completo.

La integración gestiona varios hubs Ajax en el mismo Home Assistant si es necesario, y la interfaz ya está traducida al español. En cuanto al perimetro de equipos, el desarrollador prueba prioritariamente el Hub 2 Plus y los MotionCam, pero el diseño se basa en la API oficial de Ajax y la comunidad ya ha validado un buen número de teclados, sirenas, contactos de apertura, detectores de incendios, etc.

Así que nos encontramos con un verdadero tándem Ajax Home Assistant, capaz de controlar y observar finamente el sistema de alarma, sin pasar por rodeos.

Preparar la instalación de Ajax y Home Assistant

Antes de comenzar, es mejor verificar algunos requisitos previos.

Tu sistema Ajax debe estar operativo, con un Hub configurado en la aplicación oficial, todos los detectores correctamente añadidos y nombrados, y si es posible, los grupos ya definidos (planta baja, piso, garaje, etc.). Cuanto más limpia sea la configuración de Ajax, más agradable será para trabajar en la parte de Home Assistant.

En el lado de la domótica, necesitas un Home Assistant actualizado, con HACS ya instalado y funcionando, ya que el plugin Ajax Home Assistant se distribuye como integración personalizada. También verifica que tu instancia de Home Assistant tenga acceso a internet saliente hacia los servidores de Ajax, ya que la comunicación pasa por la nube a través de HTTPS y gRPC.

Finalmente, asegúrate de que tu instalación de Home Assistant esté correctamente asegurada: contraseña robusta, acceso remoto protegido (proxy inverso, autenticación, certificado TLS), y copias de seguridad regulares. Integrar tu sistema de alarma en tu domótica es muy práctico, pero implica ser un poco más riguroso sobre la seguridad global de la infraestructura.

Instalar la integración de Ajax a través de HACS

Pongámonos a ello. ¿HACS ya está en funcionamiento en tu Home Assistant? Perfecto, podemos comenzar la instalación del plugin Ajax Home Assistant.

El primer paso consiste en declarar el repositorio de GitHub del plugin en HACS. En la interfaz de Home Assistant, abre HACS, luego la sección dedicada a integraciones. En la esquina superior derecha, un botón con tres puntos pequeños da acceso al menú avanzado. Al elegir la opción «Repositorios personalizados», podrás añadir un nuevo repositorio.

En el campo URL, introduce la dirección del repositorio https://github.com/foXaCe/ajax-hass, y selecciona “Integración” como categoría. Valida y luego cierra la ventana. La próxima vez que busques una integración en HACS, “Ajax Security System” aparecerá en la lista.

Aún en HACS, haz una búsqueda de “Ajax Security System”, abre la hoja correspondiente y luego instálala.

HACS descargará el componente ajax-hass y lo colocará en la carpeta custom_components/ajax de tu instalación de Home Assistant.

Una vez finalizada la instalación, es necesario reiniciar Home Assistant para cargar la nueva integración.

Agregar la integración Ajax Home Assistant en Home Assistant

Una vez que Home Assistant ha reiniciado, podemos pasar a la configuración. Todo se hace desde la interfaz, sin necesidad de YAML, ¡lo cual es un alivio!

Abre el menú “Configuración”, luego “Dispositivos y servicios”. En la parte inferior de la página, utiliza el botón “Agregar una integración”. En el cuadro de búsqueda, escribe “Ajax”. Deberías ver aparecer “Ajax Security System” con el icono correspondiente. Selecciónalo para iniciar el asistente de configuración.

La integración luego te pedirá las credenciales de tu cuenta de Ajax, es decir, la dirección de correo electrónico y la contraseña utilizadas en la aplicación oficial. El plugin no requiere una dirección IP local del hub, ni puertos exóticos, todo pasa por la nube de Ajax.

A continuación viene un ajuste muy práctico: el filtro de notificaciones. Puedes elegir no recibir ninguna notificación en Home Assistant, solo las alarmas de intrusión, eventos de seguridad (armado/desarmado, alertas técnicas), o absolutamente todo, incluyendo eventos de sensores en tiempo real. Si planeas crear muchas automatizaciones en Ajax Home Assistant, a menudo es interesante partir al menos de los eventos de seguridad y luego ajustar.

Valida, espera unos segundos: la integración contacta la nube de Ajax, y recupera la lista de tus hubs. Aquí tengo, por ejemplo, 3 sistemas Ajax diferentes: puedo añadirlos todos o seleccionar solo el que me interesa, como aquí «Casa» únicamente.

Confirmamos. El sistema recupera entonces los grupos y todos los dispositivos del uno o más hubs seleccionados, y luego crea las entidades correspondientes en Home Assistant. Luego podemos asignarles una habitación si lo deseamos:

Lo que se encuentra en Home Assistant después de la integración

Una vez que la integración Ajax Home Assistant está en marcha, un rápido vistazo en “Dispositivos y servicios” permite visualizar el resultado. Cada Hub Ajax aparece como un dispositivo, con un panel de alarma principal y un conjunto de sensores y actuadores.

El panel de alarma, expuesto como entidad alarm_control_panel, permite armar toda la casa, cambiar a modo noche, desarmar y utilizar el armado parcial por grupo si lo has configurado en la aplicación Ajax. Esta entidad se convierte en el punto central de tus escenarios de seguridad.

Los detectores de movimiento se exponen como binary_sensor clásicos, que cambian al estado “on” en caso de detección y regresan a “off” al cabo del tiempo de reposo. Los contactos de puertas y ventanas también se presentan como sensores binarios, perfectos para activar escenarios como el corte de calefacción si una ventana permanece abierta demasiado tiempo.

Los detectores de humo, de monóxido de carbono o de inundación también se convierten en entidades directamente utilizables.

Los enchufes y relés de Ajax se presentan como interruptores o actuadores, con la posibilidad de controlar desde Home Assistant. Se pueden, por ejemplo, comandar relés Ajax para cortar la alimentación de un dispositivo en caso de incidente.

Para los más meticulosos, también aparece toda una serie de sensores “técnicos”: nivel de batería, fuerza de la señal de radio, temperatura, estado de la conexión, etc. Son buenas bases para crear un panel de control “salud del sistema Ajax” en Home Assistant.

Ejemplos de escenarios Ajax Home Assistant en situación

Una vez que todo está subido a Home Assistant, comienza la parte más interesante: las automatizaciones. La fuerza de esta integración Ajax Home Assistant radica precisamente en la reactividad de los eventos y la posibilidad de controlar la alarma.

Un primer escenario muy útil consiste en armar automáticamente la alarma cuando todos salen de casa. Se utiliza la presencia de las personas a través de la aplicación móvil de Home Assistant u otro sistema de presencia, y se lanza un armado total tan pronto como la última persona pasa a “not_home”.

Un ejemplo minimalista en YAML puede parecerse a algo como:

automation:
  - alias: "Armar Ajax cuando todo el mundo se va"
    trigger:
      - platform: state
        entity_id: group.familia
        to: "not_home"
    action:
      - service: alarm_control_panel.alarm_arm_away
        target:
          entity_id: alarm_control_panel.ajax_alarm_home

Se puede imaginar lo contrario al volver: desarmado automático cuando una primera persona llega, acompañado de la suave iluminación de algunas luces y la desactivación de ciertos escenarios de presencia simulada.

Otro caso de uso frecuente tiene que ver con la calefacción. Los sensores de apertura de las ventanas de Ajax subidos a Home Assistant permiten cortar un calefactor eléctrico o un aire acondicionado tan pronto como una ventana permanezca abierta más de cinco minutos, y luego reactivar el sistema cuando la ventana se cierra. No hace falta multiplicar los sensores Zigbee o Z-Wave para trabajar adecuadamente en las aperturas.

Los detectores de movimiento de Ajax también pueden participar en la gestión de la iluminación. Se puede decidir que, solamente por la noche, el pasar frente a un detector en el pasillo active una luz de guía o una tira LED al pie de la cama, a baja intensidad, durante unos minutos. La alarma no se activa, pero se reutiliza la infraestructura para mayor comodidad. Es parte de los pequeños placeres de la domótica bien integrada.

Por último, el botón de pánico de Ajax expuesto como entidad “button” puede ser colocado en un tablero reservado para adultos, o bien escondido detrás de una tarjeta protegida por contraseña, y utilizado para activar una alerta general: sirenas, iluminación exterior al 100%, envío de notificación al teléfono inteligente, o incluso llamada automática a un ser cercano a través de un servicio externo. En este tipo de escenario, obviamente es mejor probar en condiciones reales pero advirtiendo a todos antes…

Seguridad y buenas prácticas con Ajax Home Assistant

Integrar Ajax a Home Assistant a través de este plugin significa que Home Assistant se convierte en una pieza más en la cadena de seguridad. El desarrollador ha cuidado la parte de privacidad: las credenciales se almacenan en el sistema cifrado de Home Assistant, la contraseña se hash antes de enviarse a los servidores de Ajax, las comunicaciones pasan por TLS, y ningún dato se envía a servicios externos. La integración es de código abierto y auditables, lo cual es tranquilizador para un sistema de seguridad.

Aún así, hay que mantener algunos reflejos. Un Home Assistant expuesto de cualquier manera en internet se convierte en una puerta de entrada a tu sistema de alarma. Por lo tanto, es crucial bloquear el acceso exterior, mantener actualizado Home Assistant así como la integración de Ajax, y evitar la multiplicación de cuentas de administrador. El armado forzado, en particular, debe ser utilizado con moderación, ya que permite armar el sistema incluso en presencia de sensores abiertos o defectuosos.

Punto final: este plugin se basa en el Cloud de Ajax. Si tu conexión a Internet se cae o si los servidores de Ajax son inaccesibles, el hub seguirá protegiendo la casa, pero la conexión en tiempo real con Home Assistant se interrumpirá.

En la práctica, ¿por qué adoptar este plugin Ajax Home Assistant?

Para resumir, pasamos de una integración «improvisada», dependiente de un segundo sistema de domótica, a un plugin Ajax Home Assistant dedicado, mantenido, y muy profundo en la gestión de equipos. La instalación se realiza a través de HACS, la configuración solo a través de la interfaz, y se obtiene un control completo de la alarma, con reportes de eventos casi instantáneos.

En la vida cotidiana, esto significa escenarios más inteligentes, una verdadera coherencia entre seguridad y confort, y menos duplicación de sensores en toda la casa. Para los instaladores, también es un argumento de peso a presentar a los clientes ya equipados con Ajax, que sueñan con un control global de su hogar con Home Assistant.

Y lo más agradable de la historia es que, por una vez, “más completo” no rima con “más complicado”.