Integración domótica Beatbot, gratuita y de código abierto
Control your Beatbot pool robots: status, battery, cleaning and alerts.
Publicado por prohand
- Dispositivos
- Versión 1.0.0
- Requiere Gladys >=5.1.0
- ★ 0
La documentación de esta integración la escribe su autor y, por ahora, solo está disponible en inglés.
This integration connects Gladys to your Beatbot pool robots (AquaSense, Sora… ranges) and their cleaning base station, through the Beatbot cloud.
Before you start
- Your robots must already work in the Beatbot app (account created, robot paired, Wi-Fi set up).
- Beatbot robots are controlled through the Beatbot cloud only: Gladys needs Internet access. There is no local control.
- A diving robot often loses Wi-Fi: it then shows as unreachable for a few minutes, which is expected.
Linking the account
- Open the Configuration tab of the integration.
- Click Connect next to Beatbot account.
- The Beatbot sign-in page opens: sign in and allow access. Your password is typed on Beatbot's page, it never goes through Gladys.
- Back in Gladys, the connection status turns green and your robots show up in the Discovery tab, ready to be added.
The Test the connection button lists the robots found, their status and their battery.
The other settings
| Setting | What it is for |
|---|---|
| Region | Where your account is hosted (Europe, North America, China). Automatic reads it from the account: change it only when asked. |
| Full refresh | States arrive in real time. This full read (every 10 min by default) catches what a network outage made you miss. |
| OAuth client ID | Advanced. Keep the default unless Beatbot gave you another client ID. |
If the Beatbot page refuses the sign-in
The integration uses the "open API" access Beatbot publishes for home
automation, with Beatbot's public client ID. If the Beatbot page shows an error
(for example about the return address, redirect_uri), Beatbot does not accept
your Gladys return address for that client ID yet: ask Beatbot support for a
client ID for Gladys, type it in OAuth client ID, save, then click
Connect again.
What you get
For every robot (and every station), depending on what the robot offers:
| Feature | Detail |
|---|---|
| State | Stopped, cleaning, paused, error, returning, charging, docked. |
| Cleaning | Start / pause the cleaning. |
| Return to base | Calls the robot back (to its base, or to the waterline for pickup). |
| Battery / Charging | Battery level in % and charging in progress (robots only, not the station). |
| Cleaning mode | The robot's modes (floor, walls, waterline…), named as Beatbot names them. |
| Child lock | Locks the robot's buttons. |
| Do not disturb | Turns the robot's voice prompts off (read-only when the robot does not allow it). |
Every robot carries a cloud badge when reachable, unreachable otherwise.
Scenes
The integration adds its own cards to the scene editor (Gladys 5.1 or later), under Integrations.
Triggers:
- Pool robot status changed — optionally filter on the robot and on the
new status. The next actions read
{{triggerEvent.data.status}},{{triggerEvent.data.previous_status}}and{{triggerEvent.data.detail}}(detailed status: diving, surfacing…). - Pool cleaning finished — a cycle ended normally. Variables:
{{triggerEvent.data.duration_minutes}}(empty when the cycle started before the integration did) and{{triggerEvent.data.battery}}. - Pool robot fault — a fault just appeared (robot stuck, basket full, motor
fault…). Filter on the faults you care about. Variables:
{{triggerEvent.data.error}},{{triggerEvent.data.label_en}}.
Actions (each one returns sent: false when the robot does not offer that
order):
- Start pool cleaning
- Pause pool cleaning
- Send the pool robot back
- Set the cleaning mode — type the mode name as shown on the device in Gladys.
Examples: "when the cleaning is finished, send me a message with its duration", or "when the robot is stuck, alert me".
Dashboard
Add the Pool robot widget and pick the robot: it shows the live battery, the status, the current fault, the link, the mode and how long the last cleaning took, with Start, Pause and Return buttons.
Troubleshooting
- "Click Connect…": no account linked, or the authorization expired or was revoked: click Connect again.
- "Your Beatbot account did not give its region": choose it in Region and save.
- "Beatbot cloud unreachable": check Gladys' Internet access; the integration retries on its own.
- States no longer move in real time: another software (Home Assistant for instance) may use the same Beatbot account and have taken the real-time connection. States are still updated at every full refresh.
- The integration logs are available from Gladys. They never contain your tokens.
Parámetros de configuración
Estos son los parámetros que Beatbot te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Getting started | section | No | Your robots must already work in the Beatbot app. Click Connect and sign in with your Beatbot account: Gladys then finds every pool robot of the account. Beatbot robots are reached through the Beatbot cloud only, Internet access is required. |
| Beatbot account | oauth2 | No | Opens the Beatbot sign-in page. Your password never goes through Gladys. |
| Region | select | No | Where your Beatbot account is hosted. Automatic reads it from the account: change it only if the connection status asks you to. |
| Full refresh (minutes) | number | No | States arrive in real time; this periodic full read only catches what a network outage made you miss. |
| OAuth client ID (advanced) | string | No | Leave as is unless Beatbot gave you another client ID. Click Connect again after changing it. |
Cómo instalar Beatbot en Gladys
- En Gladys, abre Integraciones: Beatbot aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
- Haz clic en Instalar. Gladys descarga la imagen Docker (
ghcr.io/prohand/gladys-beatbot:1.0.0), la ejecuta en un entorno aislado del núcleo y genera la interfaz de la integración (dispositivos, descubrimiento y configuración). - Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
- También puedes instalarla directamente desde la URL de su repositorio: https://github.com/prohand/gladys-beatbot.
Beatbot 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
Beatbot 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 prohand, no el equipo principal de Gladys.
- Explorar todas las integraciones externas
- Descubrir las integraciones nativas incluidas en Gladys
- Crear y publicar tu propia integración externa
- Código fuente en GitHub — fuente de esta documentación