Connecter votre alarme Ajax à Home Assistant : le guide complet 2026

Vous pouvez bel et bien intégrer votre système Ajax à Home Assistant. En 2026, trois méthodes principales existent : l'API officielle Ajax, le proxy MQTT open-source et le module UART Bridge. Chacune répond à des besoins spécifiques : latence, autonomie réseau, complexité d'installation : et on ne choisit pas la même approche selon qu'on veut juste tester ou sécuriser une villa. Ce guide détaille les trois, leur compatibilité avec les hubs Ajax actuels, et les automatisations concrètes que vous pourrez déployer.

Ajax et Home Assistant : quelles possibilités d'intégration ?

Ajax Systems propose des hubs : Hub 2, Hub 2 Plus, Hub 4 : qui communiquent avec ses capteurs via le protocole radio propriétaire Jeweller (868 ou 915 MHz). Ces hubs ne parlent pas nativement Zigbee, Z-Wave ni Thread. Pour les connecter à Home Assistant, il faut une interface tierce.

Trois voies s'offrent à vous en 2026. L'API REST officielle Ajax, accessible depuis le portail développeur ajax.systems, permet une intégration cloud. Le proxy MQTT développé par la communauté GitHub offre une solution open-source avec davantage de contrôle. Enfin, l'UART Bridge est le module officiel filaire, à ajouter sur un Hub 2 Plus ou Hub 4 pour une liaison locale directe.

• API officielle Ajax : méthode cloud, simple à configurer. Nécessite un compte développeur et une connexion Internet permanente. Temps de réponse : 2 à 5 secondes.
• Proxy MQTT communautaire : open-source, peut fonctionner en local avec un proxy. Plus technique à déployer. Latence réduite à 1-3 secondes.
• UART Bridge : module filaire officiel, connexion directe au hub Ajax. Câblage requis, achat du module (environ 60 à 90 €). Latence inférieure à 1 seconde.

Le choix dépend de votre appétence technique et de votre tolérance à la dépendance cloud. Pour une première approche, l'API officielle reste la plus simple. Les utilisateurs avancés préféreront le proxy MQTT ou l'UART Bridge pour garder une installation locale.

Si vous débutez en domotique, notre guide pour installer la domotique chez soi vous aidera à poser les bases avant de vous lancer dans l'intégration Ajax.

Méthode 1 : l'API officielle Ajax Cloud

L'API Ajax, c'est la méthode recommandée par le fabricant pour intégrer un système Ajax alarme à une plateforme tierce. Elle repose sur une authentification OAuth 2.0 et donne accès à l'ensemble des états et commandes du hub.

Configuration étape par étape :

• Créez un compte développeur sur ajax.systems (gratuit).
• Générez une clé API depuis l'onglet "Intégrations" de votre compte.
• Depuis l'interface d'administration de votre hub, activez l'intégration API et liez-la à votre compte développeur.
• Sous Home Assistant, installez l'intégration Ajax via le HACS (Home Assistant Community Store) ou par configuration manuelle YAML.
• Collez votre clé API et l'identifiant de votre hub. Home Assistant découvre automatiquement vos capteurs.

Ce que l'API permet :

• Lecture des états de tous les capteurs : ouverture, mouvement, température, sirène, détecteur de fumée.
• Armement et désarmement de l'alarme (Arm, Disarm, Home Mode).
• Historique des événements (30 jours selon l'abonnement Ajax Cloud).
• Notifications push déclenchées par les changements d'état.

L'intégration Ajax Home Assistant via API fonctionne avec tous les hubs Ajax récents (Hub 2, Hub 2 Plus, Hub 4). Le temps de latence constaté est de 2 à 5 secondes entre une action dans Home Assistant et son exécution sur le hub : acceptable pour la plupart des automatisations domotiques.

L'essentiel

• L'intégration Ajax Home Assistant est possible via trois méthodes : API officielle Cloud, proxy MQTT communautaire et module UART Bridge filaire.
• L'API officielle Ajax reste la solution la plus simple, avec une latence de 2 à 5 secondes, compatible avec tous les hubs récents (Hub 2, Hub 2 Plus, Hub 4).
• Le proxy MQTT open-source offre une alternative 100 % locale avec une latence réduite à 1-3 secondes, idéale pour les utilisateurs avancés.
• L'UART Bridge est la solution la plus réactive (< 1 seconde) mais ne permet pas l'armement/désarmement : uniquement la lecture des capteurs.
• Tous les capteurs Ajax (ouvertures, mouvements, sirènes, fumée, sonnette) remontent dans Home Assistant quel que soit le mode d'intégration choisi.

Méthode 2 : le proxy MQTT communautaire

Pour ceux qui veulent éviter le cloud Ajax, la communauté a développé un proxy MQTT open-source, disponible sur GitHub sous le nom "ajax-mqtt-proxy". Ce logiciel se connecte à l'API locale du hub Ajax via le réseau local et traduit les événements en messages MQTT que Home Assistant peut lire.

Principe de fonctionnement :

• Le proxy s'exécute sur un serveur local (Raspberry Pi, NAS, ou le même serveur que Home Assistant).
• Il interroge l'API locale du hub Ajax à intervalles réguliers : typiquement toutes les 1 à 3 secondes.
• Il publie les changements d'état sur un broker MQTT local.
• Home Assistant s'abonne aux topics MQTT et expose les capteurs comme des entités natives.

Avantages par rapport à l'API cloud :

• Fonctionnement 100 % local : pas de dépendance Internet pour les commandes.
• Latence réduite : 1 à 3 secondes en moyenne.
• Possibilité d'ajouter des traitements personnalisés avant l'envoi à Home Assistant.
• Pas de limite d'appels API (l'API cloud limite à 10 requêtes/minute sur le plan gratuit).

Inconvénients :

• Installation plus complexe : nécessite Docker ou Python, un broker MQTT (Mosquitto), et une configuration YAML.
• Maintenance manuelle : le projet GitHub est maintenu par la communauté, pas par Ajax.
• Nécessite de laisser le réseau local accessible entre le hub Ajax et le serveur hébergeant le proxy.

Cette méthode est particulièrement prisée sur les forums Ajax Home Assistant (forum.hacf.fr, community.home-assistant.io) où des tutoriels détaillés sont partagés et mis à jour régulièrement.

Méthode 3 : Ajax UART Bridge : l'intégration filaire

Ajax a développé un module officiel : l'UART Bridge (référence : Ajax UART Bridge) : qui se branche directement sur le port UART d'un Hub 2 Plus ou Hub 4. Ce module transforme les données série du hub en trames exploitables par un système externe comme Home Assistant.

Installation technique :

• Le module UART Bridge se fixe à l'intérieur du hub Ajax (opération simple, sans soudure).
• Il est relié par un câble série à un port USB de votre serveur Home Assistant (via un adaptateur USB-UART).
• Une intégration Home Assistant dédiée (disponible sur GitHub) lit le flux série et crée les entités.

Performances :

• Latence inférieure à 1 seconde : la meilleure des trois méthodes.
• Communication totalement locale et filaire : aucune dépendance Wi-Fi, cloud ou réseau IP.
• Fiabilité maximale pour les scénarios critiques (déclenchement de sirène, verrouillage de porte).

Ce qu'il faut savoir :

• Prix : le module UART Bridge coûte entre 60 et 90 € selon le revendeur. Compatible uniquement avec les hubs Hub 2 Plus et Hub 4 (pas le Hub 2 standard).
• Câblage : nécessite un boîtier de jonction si le hub n'est pas à proximité du serveur. Comptez 30 minutes à 1 heure pour l'installation.
• Limites : l'UART Bridge ne gère pas les commandes d'armement/désarmement : seulement la lecture des capteurs et le déclenchement d'alertes. Pour envoyer des commandes, il faut conserver l'API Cloud ou MQTT en parallèle.

L'UART Bridge est la solution recommandée par les installateurs professionnels pour les projets qui exigent une redondance et une réactivité maximale.

Capteurs et entités disponibles dans Home Assistant

Quelle que soit la méthode choisie, les capteurs Ajax remontent dans Home Assistant avec leurs états spécifiques. Voici les entités typiquement créées pour un système Ajax complet.

• Détecteurs d'ouverture (DoorProtect, CombiProtect) : entité binaire (ouvert/fermé), avec batterie, température et tamper (arrachement).
• Détecteurs de mouvement (MotionProtect, MotionCam) : entité binaire (mouvement détecté/non), sensibilité réglable via l'API, batterie, température.
• Sirènes (HomeSiren, StreetSiren) : entité binaire (active/inactive), niveau sonore réglable, batterie.
• Détecteurs de fumée (FireProtect) : entité binaire (alarme/calme), température, niveau de CO, batterie.
• Sonnette (Ajax DoorBell) : entité de type bouton-poussoir avec image (si modèle CaméraDoorBell).
• Hub lui-même : entité représentant l'état général (Arm/Disarm/Home) avec le mode en cours.

Les capteurs Ajax utilisent le protocole Jeweller, pas le Zigbee. Si vous cherchez "Ajax Zigbee" sur les forums, vous ne trouverez pas de compatibilité directe : Ajax a fait le choix de son protocole propriétaire pour des raisons de sécurité et de portée (portée annoncée jusqu'à 2 000 m en champ libre).

Tous les capteurs remontent leur niveau de batterie (typiquement 2 à 5 ans d'autonomie) et leur signal radio (intensité Jeweller). Ces données sont exploitables dans des automatisations ou des dashboards Home Assistant.

Automatisations et scénarios concrets

Une fois Ajax intégré à Home Assistant, les possibilités d'automatisation sont vastes. Voici trois scénarios couramment déployés par les utilisateurs.

Scénario 1 : extinction des lumières au départ Détection de l'armement de l'alarme Ajax (mode Away) → Home Assistant éteint toutes les lumières, coupe les prises connectées et active le mode vacances du chauffage connecté. Automatisation réalisable en 5 minutes dans l'éditeur d'automatisations.

Ce scénario peut également inclure le suivi de la consommation électrique en temps réel pour couper automatiquement les appareils énergivores lors de l'armement.

Scénario 2 : alerte lumineuse sur intrusion Un capteur d'ouverture détecte une intrusion → Ajax envoie l'alerte à Home Assistant via l'API ou MQTT → Home Assistant allume toutes les lumières intérieures en rouge via des ampoules connectées, et envoie une notification push avec l'image de la caméra la plus proche.

Scénario 3 : désarmement automatique par reconnaissance vocale Vous dites "Je suis là" à votre Google Home ou Alexa → l'assistant vocal envoie une commande à Home Assistant → Home Assistant désarme l'alarme Ajax (via l'API). Cette chaîne nécessite que l'API Ajax soit capable de désarmer : l'UART Bridge seul ne le permet pas.

Pour choisir l'assistant vocal le mieux adapté à ce type de scénario, notre comparatif Google Home vs Alexa 2026 détaille les différences de compatibilité avec Home Assistant.

Pour les utilisateurs de Jeedom, une intégration Ajax Jeedom existe également via plugin, mais le guide Home Assistant débutant reste plus flexible pour ces scénarios croisés.

Toutes ces automatisations reposent sur la fiabilité de la communication entre Ajax et Home Assistant. La latence de 2 à 5 secondes avec l'API Cloud est suffisante pour des scénarios d'éclairage ou de notification. Pour des actions de sécurité critique (déclenchement de sirène externe), préférez l'UART Bridge.

Limites et précautions à connaître

Intégrer Ajax à Home Assistant comporte des limites à connaître avant de se lancer. La première : l'impossibilité de modifier les paramètres de sécurité via l'API. Vous ne pouvez pas changer les délais d'entrée/sortie, ajouter ou supprimer des utilisateurs, ni modifier les groupes de pièces. Ces réglages restent exclusifs à l'application Ajax officielle ou au Pro Desktop.

Précautions importantes :

• Sécurité : ne JAMAIS exposer votre clé API Ajax sur Internet. Utilisez un proxy inverse avec authentification si vous devez y accéder à distance. Le forum Ajax Home Assistant regorge de cas de clés compromises ayant permis un désarmement à distance.
• Redondance : conservez l'application Ajax officielle comme solution de secours. Home Assistant ne doit pas devenir le seul point de contrôle de votre alarme. En cas de panne du serveur Home Assistant, l'alarme Ajax continue de fonctionner de manière autonome.
• Mises à jour firmware : une mise à jour du hub Ajax peut casser une intégration tierce. Surveillez les forums (community.home-assistant.io, forum.hacf.fr) avant d'appliquer une mise à jour Ajax récente.
• Garantie : l'utilisation d'une intégration non officielle (proxy MQTT, UART Bridge avec code GitHub) peut être exclue du support Ajax. Pour une installation professionnelle, l'API officielle reste la voie couverte par le SAV.

Pour un retour d'expérience complet sur les performances et la fiabilité des systèmes Ajax, consultez notre test complet de l'alarme Ajax mis à jour en juin 2026. Les résultats confirment une fiabilité de 99,8 % sur les transmissions Jeweller, quel que soit le mode d'intégration.

Sources

• ajax.systems
• community.home-assistant.io
• forum.hacf.fr