Integration - Beatbot

Development
1

Hello everyone,

I present to you Beatbot, a new external integration for Gladys that allows you to control and monitor Beatbot pool robots (AquaSense, Sora ranges…) and their cleaning station.

Beatbot for Gladys

What it does

For each robot in your Beatbot account, depending on what the robot offers:

  • Status: stopped, cleaning, paused, returning, charging, at base, error
  • Start / pause cleaning
  • Return to base (or to the waterline to retrieve it)
  • Battery and charging in progress
  • Cleaning mode (bottom, walls, waterline… with the names given by Beatbot)
  • Child safety and do not disturb (voice messages cut off)
  • A cloud / unreachable badge on each robot

The states arrive in real time (Beatbot event stream), with a complete reread every 10 minutes to catch up on any network outage.

Scenes (Gladys 5.1+)

Triggers:

  • Pool robot status changed (filter possible on the robot and the new status)
  • Pool cleaning finished, with the cycle duration and remaining battery
  • Pool robot fault: stuck robot, full basket, motor fault, water too cold… (filter possible on the faults that interest you)

Actions:

  • Start cleaning
  • Pause
  • Bring the robot back
  • Choose the cleaning mode

Some ideas:

  • « When cleaning is finished, send me a message with its duration »
  • « When the robot is stuck, alert me on Telegram »
  • « Every morning at 9 a.m., start wall cleaning »

Dashboard widget

The Pool robot widget displays the live battery, status, current fault, connection, mode, and duration of the last cleaning, with the Start, Pause, and Return buttons.

Prerequisites

  • Gladys 5.1.0 or newer
  • A Beatbot account with your robots already functional in the Beatbot app
  • Internet access: Beatbot robots are only controlled via the Beatbot cloud, there is no local control

Installation

  1. In Gladys: Integrations, search for Beatbot and install it.
  2. Configuration tab: click on Connect and log in on the Beatbot page. Your password is entered on Beatbot, it never goes through Gladys.
  3. The account region (Europe, North America, China) is detected automatically.
  4. Your robots appear in the Discovery tab: add them.

The Test connection button lists the robots found with their status and battery.

How it works

The integration uses the « open API » that Beatbot publishes for home automation, the same as their official Home Assistant integration. The code is a port of their official library beatbot-cloud-python.

Important: call for testers

This is a first version, tested with a fake Beatbot cloud (106 automatic tests), but not yet on a real robot. If you have a Beatbot, your feedback is very much appreciated.

The point to watch is the account connection:

  • the integration uses the public client identifier provided by Beatbot;
  • if the Beatbot login page displays an error on the return address (redirect_uri), report it here, with a screenshot if possible.

For a problem, please indicate:

  • the robot model;
  • your Gladys version;
  • the integration logs (they never contain your tokens).

Links

Happy swimming! :person_swimming:

1 Like
Point d'étape sur mes 24 intégrations : audit, corrections et nouvelles versions (7 et 8 octobre)