Integración domótica Beatbot, gratuita y de código abierto
Controle sus robots de piscina Beatbot: estado, batería, limpieza y alertas.
Publicado por prohand
- Dispositivos
- Versión 1.2.3
- Requiere Gladys >=5.2.0
- ★ 0
Esta integración conecta Gladys con sus robots de piscina Beatbot (gamas AquaSense, Sora…) y su estación de limpieza, a través de la nube de Beatbot.
Antes de empezar
- Sus robots ya deben funcionar en la aplicación Beatbot (cuenta creada, robot emparejado, wifi configurado).
- Los robots Beatbot se controlan solo a través de la nube de Beatbot: Gladys necesita acceso a Internet. No hay control local.
- Un robot que se sumerge suele perder el wifi: entonces aparece como Inaccesible durante unos minutos, es lo esperado.
Vincular la cuenta
- Abra la pestaña Configuración de la integración.
- Pulse Conectar junto a Cuenta de Beatbot.
- Se abre la página de inicio de sesión de Beatbot: inicie sesión y autorice el acceso. Su contraseña se escribe en la página de Beatbot, nunca pasa por Gladys.
- De vuelta en Gladys, el estado de conexión se pone en verde y sus robots aparecen en la pestaña Descubrir: pulse Añadir a Gladys en cada uno.
El botón Probar la conexión lista los robots encontrados, su estado y su batería.
Los demás ajustes
| Ajuste | Para qué sirve |
|---|---|
| Región | Dónde está alojada su cuenta (Europa, América del Norte, China). Automática la lee de la cuenta: cámbiela solo si se le pide. |
| Actualización completa | Los estados llegan en tiempo real. Esta lectura completa (cada 10 min por defecto) recupera lo que un corte de red le haya hecho perder. |
| ID de cliente OAuth | Avanzado. Mantenga el valor por defecto, salvo que Beatbot le haya dado otro ID de cliente. |
Si Conectar no hace nada
Gladys abre la página de inicio de sesión de Beatbot en una pestaña nueva. Si no se abre ninguna pestaña, lo más probable es que el navegador la haya bloqueado como ventana emergente (Safari en iPhone y iPad lo hace a menudo): permita las ventanas emergentes para la dirección de su Gladys (en iPhone: Ajustes → Apps → Safari → Bloquear ventanas, desactivado) o use un ordenador, y vuelva a pulsar Conectar.
El valor home-assistant de ID de cliente OAuth es solo el nombre del
cliente público que Beatbot publica para la domótica: no necesita Home
Assistant.
Si la página de Beatbot rechaza el inicio de sesión
La integración utiliza el acceso «open API» que Beatbot publica para la domótica, con el ID de cliente público de Beatbot.
Problema conocido: «Whitelabel Error Page … status=400». Después de escribir su correo y su contraseña, la página de Beatbot puede mostrar:
Whitelabel Error Page
There was an unexpected error (type=Bad Request, status=400).
- No es su contraseña: la página de Beatbot solo comprueba la dirección de retorno de Gladys después del inicio de sesión, y todavía no la acepta para el ID de cliente público.
- Hay una solicitud abierta en Beatbot para aceptar Gladys: sígala en GitHub. Hasta entonces no se puede corregir nada del lado de Gladys.
- Ahora tiene la sesión iniciada en Beatbot, así que cada nuevo intento va
directamente a este error. Para volver a ver la página de inicio de sesión,
use una ventana privada del navegador (o borre las cookies de
oauth.beatbot.com). - Si Beatbot le da un ID de cliente para Gladys, escríbalo en ID de cliente OAuth, guarde y vuelva a pulsar Conectar.
Lo que obtiene
Para cada robot (y cada estación), según lo que ofrezca el robot:
| Funcionalidad | Detalle |
|---|---|
| Estado | Detenido, limpiando, en pausa, error, regresando, cargando, en la base. |
| Limpieza | Iniciar / pausar la limpieza. |
| Volver a la base | Hace volver al robot (a su base, o a la línea de flotación para recogerlo). |
| Batería / Carga | Nivel de batería en % y carga en curso (solo robots, no la estación). |
| Modo de limpieza | Los modos del robot (suelo, paredes, línea de flotación…), con los nombres de Beatbot. |
| Bloqueo infantil | Bloquea los botones del robot. |
| No molestar | Desactiva los mensajes de voz del robot (solo lectura cuando el robot no lo permite). |
Cada robot lleva una insignia Nube cuando es accesible, Inaccesible en caso contrario.
Escenas
La integración añade sus propias tarjetas al editor de escenas (Gladys 5.1 o posterior), en Integraciones.
Activadores:
- Estado del robot de piscina cambiado — filtre opcionalmente por el robot
y por el nuevo estado. Las acciones siguientes leen
{{triggerEvent.data.status}},{{triggerEvent.data.previous_status}}y{{triggerEvent.data.detail}}(estado detallado: sumergiéndose, emergiendo…). - Limpieza de la piscina terminada — un ciclo ha terminado con normalidad.
Variables:
{{triggerEvent.data.duration_minutes}}(vacía si el ciclo empezó antes que la integración) y{{triggerEvent.data.battery}}. - Fallo del robot de piscina — acaba de aparecer un fallo (robot atascado,
cesta llena, fallo del motor…). Filtre por los fallos que le interesen.
Variables:
{{triggerEvent.data.error}},{{triggerEvent.data.label_es}}.
Acciones (cada una devuelve sent: false cuando el robot no ofrece esa orden):
- Iniciar la limpieza de la piscina
- Pausar la limpieza de la piscina
- Hacer volver el robot de piscina
- Elegir el modo de limpieza — escriba el nombre del modo tal y como aparece en el dispositivo en Gladys.
Ejemplos: «cuando termine la limpieza, recibir un mensaje con su duración», o «cuando el robot esté atascado, recibir una alerta».
Panel
En Panel → Editar → Nuevo widget, añada el widget Robot de piscina (en Widgets de integraciones) y elija el robot: muestra la batería en directo, el estado, el fallo actual, la conexión, el modo y la duración de la última limpieza, con los botones Iniciar, Pausa y Volver.
Cuando el robot permite cambiar su modo de limpieza, un botón Modo de limpieza abre un pequeño formulario con los modos de ese robot, con el actual ya seleccionado: elija uno y envíelo (Gladys 5.2 o posterior, necesario para la integración).
Solución de problemas
- «Pulse Conectar…»: no hay ninguna cuenta vinculada, o la autorización ha caducado o se ha revocado: vuelva a pulsar Conectar.
- «Su cuenta de Beatbot no ha indicado su región»: elíjala en Región y guarde.
- «Nube de Beatbot inaccesible»: compruebe el acceso a Internet de Gladys; la integración vuelve a intentarlo por sí sola.
- Los estados ya no cambian en tiempo real: otro software (Home Assistant, por ejemplo) puede estar usando la misma cuenta de Beatbot y haberse quedado con la conexión en tiempo real. Los estados se siguen actualizando en cada actualización completa.
- Los registros de la integración están en su pestaña Registros en Gladys. Nunca contienen sus 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 |
|---|---|---|---|
| Primeros pasos | section | No | Sus robots ya deben funcionar en la aplicación Beatbot. Pulse Conectar e inicie sesión con su cuenta de Beatbot: Gladys encontrará entonces todos los robots de piscina de la cuenta. Los robots Beatbot solo son accesibles a través de la nube de Beatbot, se necesita acceso a Internet. |
| Cuenta de Beatbot | oauth2 | No | Abre la página de inicio de sesión de Beatbot. Su contraseña nunca pasa por Gladys. |
| Región | select | No | Dónde está alojada su cuenta de Beatbot. Automática la lee de la cuenta: cámbiela solo si el estado de conexión se lo pide. |
| Actualización completa (minutos) | number | No | Los estados llegan en tiempo real; esta lectura completa periódica solo recupera lo que un corte de red le haya hecho perder. |
| ID de cliente OAuth (avanzado) | string | No | Déjelo tal cual, salvo que Beatbot le haya dado otro ID de cliente. «home-assistant» es solo el nombre del cliente público que publica Beatbot: no necesita Home Assistant. Pulse de nuevo Conectar después de cambiarlo. |
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.2.3), 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.2.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, nativas y de la comunidad
- Crear y publicar tu propia integración externa
- Código fuente en GitHub — fuente de esta documentación