Intégration domotique Beatbot, gratuite et open source
Pilotez vos robots piscine Beatbot : état, batterie, nettoyage et alertes.
Publiée par prohand
- Appareils
- Version 1.0.0
- Nécessite Gladys >=5.1.0
- ★ 0
Cette intégration relie Gladys à vos robots piscine Beatbot (gammes AquaSense, Sora…) et à leur station de nettoyage, à travers le cloud Beatbot.
Ce qu'il faut savoir avant de commencer
- Vos robots doivent déjà fonctionner dans l'application Beatbot (compte créé, robot appairé, Wi-Fi configuré).
- Les robots Beatbot ne se pilotent que par le cloud Beatbot : Gladys a besoin d'un accès Internet. Il n'y a pas de pilotage local.
- Un robot qui plonge perd souvent le Wi-Fi : il apparaît alors injoignable quelques minutes, c'est normal.
Connexion du compte
- Ouvrez l'onglet Configuration de l'intégration.
- Cliquez sur Connecter à côté de Compte Beatbot.
- La page de connexion Beatbot s'ouvre : identifiez-vous et autorisez l'accès. Votre mot de passe est saisi chez Beatbot, il ne passe jamais par Gladys.
- De retour dans Gladys, l'état de connexion passe au vert et vos robots apparaissent dans l'onglet Découverte, prêts à être ajoutés.
Le bouton Tester la connexion liste les robots trouvés, leur état et leur batterie.
Les autres réglages
| Réglage | À quoi il sert |
|---|---|
| Région | Où votre compte est hébergé (Europe, Amérique du Nord, Chine). Automatique la lit dans le compte : ne la changez que si on vous le demande. |
| Rafraîchissement complet | Les états arrivent en temps réel. Cette lecture complète (10 min par défaut) rattrape ce qu'une coupure réseau aurait fait manquer. |
| Identifiant client OAuth | Réglage avancé. Laissez la valeur par défaut, sauf si Beatbot vous a fourni un autre identifiant. |
Si la page Beatbot refuse la connexion
L'intégration utilise l'accès « open API » que Beatbot publie pour la
domotique, avec l'identifiant client public fourni par Beatbot. Si la page
Beatbot affiche une erreur (par exemple sur l'adresse de retour,
redirect_uri), Beatbot n'accepte pas encore l'adresse de retour de votre
Gladys pour cet identifiant : demandez au support Beatbot un identifiant client
pour Gladys, saisissez-le dans Identifiant client OAuth, enregistrez, puis
cliquez à nouveau sur Connecter.
Ce que vous obtenez
Pour chaque robot (et chaque station), selon ce que le robot propose :
| Fonctionnalité | Détail |
|---|---|
| État | Arrêté, nettoyage, pause, erreur, retour, en charge, à la base. |
| Nettoyage | Marche / pause du nettoyage. |
| Retour à la base | Fait revenir le robot (à sa base ou à la ligne d'eau pour être récupéré). |
| Batterie / En charge | Niveau de batterie en % et charge en cours (robots seulement, pas la station). |
| Mode de nettoyage | Liste des modes du robot (fond, parois, ligne d'eau…), tels que Beatbot les nomme. |
| Sécurité enfant | Verrouillage des boutons du robot. |
| Ne pas déranger | Coupe les messages vocaux du robot (en lecture seule si le robot ne permet pas de le changer). |
Chaque robot porte un badge cloud quand il est joignable, injoignable sinon.
Scènes
L'intégration ajoute ses cartes à l'éditeur de scènes (Gladys 5.1 ou plus récent), dans la catégorie Intégrations.
Déclencheurs :
- État du robot piscine modifié — filtrez éventuellement sur le robot et
sur le nouvel état. Les actions suivantes lisent
{{triggerEvent.data.status}},{{triggerEvent.data.previous_status}}et{{triggerEvent.data.detail}}(état détaillé : plongée, remontée…). - Nettoyage de la piscine terminé — un cycle s'est terminé normalement.
Variables :
{{triggerEvent.data.duration_minutes}}(vide si le cycle avait commencé avant le démarrage de l'intégration) et{{triggerEvent.data.battery}}. - Défaut du robot piscine — un défaut vient d'apparaître (robot coincé,
panier plein, défaut moteur…). Filtrez sur les défauts qui vous intéressent.
Variables :
{{triggerEvent.data.error}},{{triggerEvent.data.label_fr}}.
Actions (chacune indique sent : faux si le robot ne propose pas cet ordre) :
- Démarrer le nettoyage de la piscine
- Mettre en pause le nettoyage
- Faire revenir le robot piscine
- Choisir le mode de nettoyage — saisissez le nom du mode tel qu'il apparaît sur l'appareil dans Gladys.
Exemple : « Quand le nettoyage est terminé, m'envoyer un message avec la durée », ou « Quand le robot est coincé, m'alerter ».
Tableau de bord
Ajoutez le widget Robot piscine et choisissez le robot : il affiche la batterie en direct, l'état, le défaut en cours, la liaison, le mode et la durée du dernier nettoyage, avec les boutons Démarrer, Pause et Retour.
Dépannage
- « Cliquez sur Connecter… » : aucun compte lié, ou l'autorisation a expiré ou a été révoquée : cliquez à nouveau sur Connecter.
- « Votre compte Beatbot n'a pas indiqué sa région » : choisissez la région dans Région et enregistrez.
- « Cloud Beatbot injoignable » : vérifiez l'accès Internet de Gladys ; l'intégration réessaie toute seule.
- Les états ne bougent plus en temps réel : un autre logiciel (par exemple Home Assistant) utilise peut-être le même compte Beatbot et a pris la connexion temps réel. Les états restent mis à jour à chaque rafraîchissement complet.
- Les logs de l'intégration sont visibles depuis Gladys. Ils ne contiennent jamais vos jetons.
Paramètres de configuration
Voici les paramètres demandés par Beatbot dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Pour commencer | section | Non | Vos robots doivent déjà fonctionner dans l'application Beatbot. Cliquez sur Connecter et identifiez-vous avec votre compte Beatbot : Gladys retrouve alors tous les robots piscine du compte. Les robots Beatbot ne sont joignables que par le cloud Beatbot, un accès Internet est nécessaire. |
| Compte Beatbot | oauth2 | Non | Ouvre la page de connexion Beatbot. Votre mot de passe ne passe jamais par Gladys. |
| Région | select | Non | Où votre compte Beatbot est hébergé. Automatique le lit dans le compte : ne le changez que si l'état de connexion vous le demande. |
| Rafraîchissement complet (minutes) | number | Non | Les états arrivent en temps réel ; cette lecture complète périodique rattrape seulement ce qu'une coupure réseau aurait fait manquer. |
| Identifiant client OAuth (avancé) | string | Non | Laissez tel quel, sauf si Beatbot vous a fourni un autre identifiant client. Cliquez à nouveau sur Connecter après l'avoir changé. |
Comment installer Beatbot dans Gladys
- Dans Gladys, ouvrez Intégrations : Beatbot apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
- Cliquez sur Installer. Gladys télécharge l'image Docker (
ghcr.io/prohand/gladys-beatbot:1.0.0), la démarre dans un bac à sable isolé du cœur, et génère l'interface de l'intégration (appareils, découverte et configuration). - Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
- Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/prohand/gladys-beatbot.
Beatbot nécessite Gladys >=5.1.0. Le catalogue dans Gladys se rafraîchit toutes les heures : une nouvelle version est donc disponible au plus tard une heure après sa sortie.
Vous n'utilisez pas encore Gladys ? C'est gratuit et open source : suivez le guide d'installation pour démarrer.
À propos des intégrations externes
Beatbot est une intégration externe : une intégration communautaire empaquetée dans un conteneur Docker et publiée sur GitHub, que Gladys installe en un clic et exécute dans un bac à sable isolé de son cœur. Elle est publiée et maintenue par prohand, et non par l'équipe cœur de Gladys.
- Parcourir toutes les intégrations externes
- Découvrir les intégrations natives intégrées à Gladys
- Créer et publier votre propre intégration externe
- Code source sur GitHub — source de cette documentation