Quando eu escrevi o primeiro guia para conectar o alarme Ajax ao Home Assistant, era preciso lidar com SIA, Jeedom, MQTT, tópicos a rodo… O resultado funcionava perfeitamente, mas era necessário gostar de estruturas complicadas. Hoje, mudança completa de cenário: desenvolvedores criaram uma integração nativa Ajax Home Assistant, instalável via HACS, que se comunica diretamente com a API Cloud oficial da Ajax. Armamento, desarmamento, notificações, sensores, relés… tudo se integra ao Home Assistant, em tempo (quase) real!

Instalado em minha casa há alguns dias, eu proponho que vocês descubram mais detalhadamente este plugin tão aguardado…

Lembrete rápido sobre os métodos antigos

Até aqui, para discutir sobre Ajax Home Assistant, havia duas abordagens.

A primeira utilizava a integração SIA Alarm Systems do Home Assistant. O alarme Ajax era configurado como se o Home Assistant fosse um centro de monitoramento. Capturávamos o estado do sistema, algumas informações de incêndio/inundação, e era isso. Impossível controlar o alarme, nenhum detalhe sobre cada sensor. Era principalmente útil para acionar alguns cenários a partir do estado global do alarme, como, por exemplo, colocar o aquecedor em modo econômico quando ativávamos o alarme ao sair de casa.

A segunda método, detalhada no meu guia anterior, consistia em usar o plugin Ajax no Jeedom e, em seguida, republicar todas as informações no Home Assistant via MQTT. Muito mais completo, com a recolha de quase todos os sensores Ajax, mas ao custo de um segundo servidor de automação, de um broker MQTT e de um mapeamento de dezenas de tópicos… Resumindo, muito poderoso, mas claramente não ao alcance de todos.

O novo plugin muda completamente o jogo: Ajax Home Assistant torna-se uma combinação muito mais simples de ser configurada.

O que permite o novo plugin Ajax Home Assistant

A integração ajax-hass é um componente personalizado do Home Assistant que se conecta diretamente ao Cloud Ajax através da API oficial e um fluxo gRPC, exatamente como o aplicativo móvel Ajax. Concretamente, seu Hub Ajax se torna um “cidadão de primeira classe” no Home Assistant, com um verdadeiro painel de alarme e entidades para sensores, sirenes, relés, tomadas, etc.

Você obtém, entre outras coisas, um controle completo da segurança. O painel de alarme do Home Assistant permite o armamento total, o desarmamento, o modo noite, o armamento parcial por grupo e até mesmo o armamento forçado quando certos sensores permanecem abertos. Um serviço dedicado gerencia o botão de pânico, que pode ser colocado em um painel de controle ou em um controle remoto virtual.

Em termos de informações, o plugin expõe os eventos de armamento/desarmamento com o nome do usuário Ajax, as notificações de alarme, as detecções de movimento, as aberturas de portas e janelas, os alarmes de incêndio ou inundação, bem como sensores “técnicos” como nível de bateria, qualidade do sinal, temperatura ou estado da conexão. É muito completo.

A integração gerencia vários hubs Ajax no mesmo Home Assistant, se necessário, e a interface já está traduzida para o português. Em termos de equipamentos, o desenvolvedor testa prioritariamente o Hub 2 Plus e os MotionCam, mas o design se baseia na API oficial da Ajax e a comunidade já validou um bom número de teclados, sirenes, contatos de abertura, detectores de incêndio, etc.

Portanto, nos deparamos com uma verdadeira parceria Ajax Home Assistant, capaz de controlar e monitorar minuciosamente o sistema de alarme, sem passar por desvios.

Preparando sua instalação Ajax e Home Assistant

Antes de começar, é melhor verificar alguns pré-requisitos.

Seu sistema Ajax deve estar operacional, com um Hub configurado no aplicativo oficial, todos os detectores corretamente adicionados e nomeados e, se possível, os grupos já definidos (térreo, andar, garagem, etc.). Quanto mais limpa for a configuração Ajax, mais agradável será a parte do Home Assistant.

No que diz respeito à automação, é necessário ter um Home Assistant atualizado, com HACS já instalado e funcionando, pois o plugin Ajax Home Assistant é distribuído como uma integração personalizada. Verifique também se sua instância do Home Assistant tem acesso à internet para os servidores Ajax, pois a comunicação passa pelo Cloud via HTTPS e gRPC.

Por fim, certifique-se de que sua instalação do Home Assistant está devidamente segura: senha robusta, acesso remoto protegido (proxy reverso, autenticação, certificado TLS) e backups regulares. Integrar seu sistema de alarme à sua automação é muito prático, mas implica ser um pouco mais rigoroso em relação à segurança global da infraestrutura.

Instalando a integração Ajax via HACS

Vamos ao que interessa. O HACS já está configurado em seu Home Assistant? Perfeito, podemos iniciar a instalação do plugin Ajax Home Assistant.

A primeira etapa consiste em declarar o repositório GitHub do plugin no HACS. Na interface do Home Assistant, abra o HACS e, em seguida, a seção dedicada às integrações. No canto superior direito, um botão com três pontinhos dá acesso ao menu avançado. Ao escolher a opção “Repositórios personalizados”, você poderá adicionar um novo repositório.

No campo URL, insira o endereço do repositório https://github.com/foXaCe/ajax-hass e selecione “Integração” como categoria. Valide e feche a janela. Na próxima vez que você procurar uma integração no HACS, “Ajax Security System” aparecerá na lista.

Sempre no HACS, inicie uma busca por “Ajax Security System”, abra o cartão correspondente e, em seguida, instale-o.

O HACS fará o download do componente ajax-hass e o colocará na pasta custom_components/ajax da sua instalação do Home Assistant.

Uma vez que a instalação esteja concluída, um reinício do Home Assistant é necessário para carregar a nova integração.

Adicionar a integração Ajax Home Assistant no Home Assistant

Uma vez que o Home Assistant tenha reiniciado, podemos prosseguir para a configuração. Tudo é realizado pela interface, sem YAML obrigatório, o que é muito bom!

Abra o menu “Configurações” e, em seguida, “Dispositivos e serviços”. Na parte inferior da página, use o botão “Adicionar uma integração”. Na caixa de pesquisa, digite “Ajax”. Você deve ver “Ajax Security System” aparecer com o ícone correspondente. Selecione-o para iniciar o assistente de configuração.

A integração então solicita as credenciais da sua conta Ajax, ou seja, o endereço de e-mail e a senha utilizados no aplicativo oficial. O plugin não precisa do endereço IP local do hub, nem de portas exóticas, tudo passa pelo Cloud Ajax.

Em seguida, vem uma configuração muito prática: o filtro de notificações. Você pode escolher não enviar nenhuma notificação para o Home Assistant, apenas as de alarme de intrusão, eventos de segurança (armamento/desarmamento, alertas técnicos), ou absolutamente tudo, incluindo eventos de sensores ao longo do tempo. Se você planeja criar muitas automações no Ajax Home Assistant, geralmente é interessante optar por pelo menos os eventos de segurança e depois ajustar.

Valide, aguarde alguns segundos: a integração contata o Cloud Ajax e recupera a lista de seus hubs. Aqui, eu tenho, por exemplo, 3 sistemas Ajax diferentes: posso adicionar todos ou selecionar apenas aquele que me interessa, como “Casa” apenas.

Confirmamos. O sistema então recupera os grupos e todos os dispositivos do(s) hub(s) selecionados, depois cria as entidades correspondentes no Home Assistant. Podemos, então, atribuir uma sala se desejarmos:

O que encontramos no Home Assistant após a integração

Uma vez que a integração Ajax Home Assistant esteja em funcionamento, um breve passeio por “Dispositivos e serviços” permite visualizar o resultado. Cada Hub Ajax aparece como um dispositivo, com um painel de alarme principal e um conjunto de sensores e atuadores.

O painel de alarme, exposto como uma entidade alarm_control_panel, permite armar a totalidade da casa, mudar para modo noite, desarmar, e usar o armamento parcial por grupo se você o configurou no aplicativo Ajax. Esta entidade torna-se o ponto central de seus cenários de segurança.

Os detectores de movimento são expostos como binary_sensor clássicos, que mudam para o estado “on” em caso de detecção e retornam ao “off” após o tempo de espera. Os contatos de portas e janelas também são exibidos como sensores binários, perfeitos para acionar cenários do tipo suspensão do aquecimento se uma janela permanecer aberta por muito tempo.

Os detectores de fumaça, monóxido ou inundação também se tornam entidades diretamente utilizáveis.

As tomadas e relés Ajax aparecem como interruptores ou atuadores, com a possibilidade de controlá-los diretamente do Home Assistant. Podemos, por exemplo, acionar relés Ajax para cortar a alimentação de um dispositivo em caso de incidente.

Para os mais exigentes, uma série de sensores “técnicos” também aparece: nível de bateria, força do sinal de rádio, temperatura, estado da conexão, etc. São boas bases para criar um painel de “saúde do sistema Ajax” no Home Assistant.

Exemplos de cenários Ajax Home Assistant em ação

Uma vez que tudo esteja integrado no Home Assistant, a parte mais interessante começa: as automações. A força desta integração Ajax Home Assistant é precisamente a rapidez das notificações de eventos e a capacidade de controlar o alarme.

Um primeiro cenário muito útil consiste em armar automaticamente o alarme quando todos saem de casa. Usamos a presença das pessoas através do aplicativo móvel Home Assistant ou outro sistema de presença e acionamos um armamento total assim que a última pessoa passa para “not_home”.

Um exemplo minimalista em YAML pode se parecer com algo assim:

automation:
  - alias: "Armar Ajax quando todos saem"
    trigger:
      - platform: state
        entity_id: group.famille
        to: "not_home"
    action:
      - service: alarm_control_panel.alarm_arm_away
        target:
          entity_id: alarm_control_panel.ajax_alarm_home

Podemos imaginar o inverso ao voltar: desarmamento automático quando a primeira pessoa chega, acompanhado de uma iluminação suave de algumas luzes e a desativação de certos cenários de presença simulada.

Outro caso de uso frequente se relaciona ao aquecimento. Os sensores de abertura Ajax integrados no Home Assistant permitem desligar um aquecedor elétrico ou um ar condicionado assim que uma janela permanecer aberta por mais de cinco minutos e reativar o sistema quando a janela for fechada. Não há mais necessidade de multiplicar sensores Zigbee ou Z-Wave para trabalhar de forma eficaz nas aberturas.

Os detectores de movimento Ajax podem também participar da gestão da iluminação. Podemos decidir que, apenas à noite, passar diante de um detector no corredor acenda uma luz de noite ou uma fita LED ao pé da cama, com baixa intensidade, por alguns minutos. O alarme não é acionado, mas reaproveitamos a infraestrutura para conforto. Isso faz parte dos pequenos prazeres da automação bem integrada.

Por fim, o botão de pânico Ajax exposto como entidade “button” pode ser colocado em um painel reservado para adultos, ou até escondido atrás de um cartão protegido por senha, e utilizado para acionar um alerta geral: sirenes, iluminação externa a 100%, envio de notificação no smartphone, ou até mesmo um chamado automático a um conhecido via serviço de terceiros. Em tais cenários, evidentemente é melhor testar em condições reais, mas avisando a todos antes…

Segurança e boas práticas com Ajax Home Assistant

Integrar Ajax ao Home Assistant através deste plugin significa que o Home Assistant se torna uma peça a mais na cadeia de segurança. O desenvolvedor cuidou da parte de privacidade: as credenciais são armazenadas no sistema criptografado do Home Assistant, a senha é hash antes de ser enviada para os servidores Ajax, as comunicações passam por TLS e nenhum dado é enviado para serviços de terceiros. A integração é open source e auditável, o que é reconfortante para um sistema de segurança.

Entretanto, é importante manter alguns hábitos. Um Home Assistant exposto de qualquer maneira na internet se torna uma porta de entrada para seu sistema de alarme. Portanto, é crucial bloquear o acesso externo, manter o Home Assistant e a integração Ajax atualizados e evitar multiplicar contas de administrador. O armamento forçado, em particular, deve ser usado com moderação, pois permite armar o sistema mesmo na presença de sensores abertos ou em falha.

Ponto final: este plugin depende do Cloud Ajax. Se sua conexão com a internet cair ou se os servidores Ajax estiverem inacessíveis, o hub continuará a proteger a casa, mas a ligação em tempo real com o Home Assistant será interrompida.

Na prática, por que adotar este plugin Ajax Home Assistant

Resumindo, passamos de uma integração “improvisada”, dependente de um segundo sistema de automação, para um plugin Ajax Home Assistant dedicado, mantido e muito profundo na gestão dos equipamentos. A instalação é feita via HACS, a configuração é realizada apenas pela interface e obtemos um controle completo do alarme, com notificações de eventos quase instantâneas.

No dia a dia, isso significa cenários mais inteligentes, uma verdadeira coerência entre segurança e conforto, e menos duplicação de sensores em toda a casa. Para os instaladores, também é um argumento de peso a apresentar aos clientes já equipados com Ajax, que sonham com um controle global de suas casas com o Home Assistant.

E o mais prazeroso nessa história é que, pela primeira vez, “mais completo” não rima com “mais complicado”.