Integración externa - SwitchBot

¡Hola a todos! :waving_hand:

SwitchBot es un poco el cuchillo suizo de la domótica «sin obras»: el pequeño robot que presiona un botón, el motor de la cortina, la cerradura que se pega en la puerta, los termómetros… Y no había nada para ellos en Gladys. Por lo tanto, aquí está SwitchBot, a través de la API oficial de SwitchBot.

Qué hace

  • Tus dispositivos SwitchBot llegan a Gladys con lo que saben hacer:
    • Bot, enchufes (Plug, Plug Mini), Relay Switch: encendido/apagado, potencia y energía cuando el modelo las mide;
    • cortinas y persianas (Curtain, Curtain 3, Roller Shade, Blind Tilt): abrir, cerrar, posición;
    • cerraduras: estado y puerta abierta o cerrada. Bloquear y desbloquear desde Gladys sigue desactivado hasta que lo autorices explícitamente en la configuración;
    • termómetros y hubs (Meter, Meter Plus/Pro, Outdoor Meter, Hub 2/3): temperatura, humedad, batería, CO2 en el Meter Pro CO2;
    • sensores de apertura, movimiento y fuga de agua;
    • luces (Color Bulb, Strip Light, Ceiling Light…), humidificador, purificador, ventiladores, aspiradoras (estado básico);
    • opcionalmente, los mandos a distancia infrarrojos del Hub.
  • Cuatro disparadores de escena: puerta abierta / cerrada / abierta durante mucho tiempo, movimiento detectado, fuga de agua, batería baja.
  • Dos acciones de escena: presionar un Bot, enviar un comando infrarrojo.
  • Un widget « SwitchBot » con tus termómetros y los estados principales.
  • Opcionalmente, con Gladys Plus: tiempo real mediante webhook, en lugar de esperar a la próxima lectura.
  • En francés, inglés, alemán y español.

La parte divertida

Fuga de agua bajo el fregadero → notificación inmediata y corte del enchufe del lavavajillas
Puerta de entrada abierta durante 5 minutos → pequeño recordatorio en el teléfono
7 h en semana → el Bot presiona el botón de la cafetera :hot_beverage:

Instalación

:warning: Gladys 5.1 mínimo, y un Hub SwitchBot para los dispositivos Bluetooth (es él quien los conecta a la nube).

Llega a la tienda en el próximo paso del indexador. Mientras tanto: Integraciones → Instalar desde GitHub, con GitHub - guim31/gladys-switchbot: SwitchBot devices (Bot, Curtain, Lock, Plug, Meter, Hub…) for Gladys Assistant, through the SwitchBot cloud API · GitHub

  1. En la aplicación SwitchBot: Perfil → Preferencias → Acerca de, toca 10 veces «Versión de la aplicación», luego abre Opciones de desarrollador: allí encuentras el token y la clave secreta.
  2. Pégalos en la configuración de la integración, luego Probar la conexión.
  3. Pestaña Descubrimiento: añade tus dispositivos.

Pequeñas reservas honestas

  • Desarrollado sin el material ni la cuenta SwitchBot: todo se ha probado contra una falsa nube SwitchBot construida a partir de la documentación oficial. ¡Tus comentarios son bienvenidos!
  • SwitchBot limita la API a 10.000 llamadas por día. La integración solo usa aproximadamente la mitad, adaptando la frecuencia al número de dispositivos, y se pone en pausa antes del límite. Los sensores no son instantáneos sin la opción webhook.
  • El webhook de SwitchBot es único por cuenta: si otro software ya lo está usando, activarlo aquí lo reemplaza.

Como los anteriores, desarrollado con Claude Code. Proyecto independiente, no afiliado a SwitchBot.

Depósito: GitHub - guim31/gladys-switchbot: SwitchBot devices (Bot, Curtain, Lock, Plug, Meter, Hub…) for Gladys Assistant, through the SwitchBot cloud API · GitHub