Beatbot Smart-Home-Integration, kostenlos und Open Source
Control your Beatbot pool robots: status, battery, cleaning and alerts.
Veröffentlicht von prohand
- Geräte
- Version 1.0.0
- Erfordert Gladys >=5.1.0
- ★ 0
Die Dokumentation dieser Integration wird von ihrem Autor geschrieben und ist bisher nur auf Englisch verfügbar.
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.
Konfigurationseinstellungen
Diese Einstellungen fragt Beatbot in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Getting started | section | Nein | 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 | Nein | Opens the Beatbot sign-in page. Your password never goes through Gladys. |
| Region | select | Nein | 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 | Nein | States arrive in real time; this periodic full read only catches what a network outage made you miss. |
| OAuth client ID (advanced) | string | Nein | Leave as is unless Beatbot gave you another client ID. Click Connect again after changing it. |
So installierst du Beatbot in Gladys
- Öffne in Gladys Integrationen: Beatbot erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/prohand/gladys-beatbot:1.0.0) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration). - Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
- Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/prohand/gladys-beatbot.
Beatbot benötigt Gladys >=5.1.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.
Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.
Über externe Integrationen
Beatbot ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von prohand veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.
- Alle externen Integrationen durchsuchen
- Die nativen Integrationen entdecken, die in Gladys eingebaut sind
- Deine eigene externe Integration bauen und veröffentlichen
- Quellcode auf GitHub — Quelle dieser Dokumentation