Intégration externe - SwitchBot

Salut tout le monde ! :waving_hand:

SwitchBot, c’est un peu le couteau suisse de la domotique « sans travaux » : le petit robot qui appuie sur un bouton, le moteur de rideau, la serrure qu’on colle sur sa porte, les thermomètres… Et il n’y avait rien pour eux dans Gladys. Voici donc SwitchBot, par l’API officielle de SwitchBot.

Ce que ça fait

  • Vos appareils SwitchBot arrivent dans Gladys avec ce qu’ils savent faire :
    • Bot, prises (Plug, Plug Mini), Relay Switch : marche/arrêt, puissance et énergie quand le modèle les mesure ;
    • rideaux et stores (Curtain, Curtain 3, Roller Shade, Blind Tilt) : ouvrir, fermer, position ;
    • serrures : état et porte ouverte ou fermée. Verrouiller et déverrouiller depuis Gladys reste désactivé tant que vous ne l’autorisez pas explicitement dans la configuration ;
    • thermomètres et hubs (Meter, Meter Plus/Pro, Outdoor Meter, Hub 2/3) : température, humidité, batterie, CO2 sur le Meter Pro CO2 ;
    • capteurs d’ouverture, de mouvement et de fuite d’eau ;
    • lumières (Color Bulb, Strip Light, Ceiling Light…), humidificateur, purificateur, ventilateurs, aspirateurs (état de base) ;
    • en option, les télécommandes infrarouges du Hub.
  • Quatre déclencheurs de scène : porte ouverte / fermée / restée ouverte, mouvement détecté, fuite d’eau, batterie faible.
  • Deux actions de scène : appuyer sur un Bot, envoyer une commande infrarouge.
  • Un widget « SwitchBot » avec vos thermomètres et les états principaux.
  • En option, avec Gladys Plus : le temps réel par webhook, au lieu d’attendre la prochaine lecture.
  • En français, anglais, allemand et espagnol.

Le truc sympa

Fuite d’eau sous l’évier → notification immédiate et coupure de la prise du lave-vaisselle
Porte d’entrée restée ouverte 5 minutes → petit rappel sur le téléphone
7 h en semaine → le Bot appuie sur le bouton de la cafetière :hot_beverage:

Installation

:warning: Gladys 5.1 minimum, et un Hub SwitchBot pour les appareils Bluetooth (c’est lui qui les relie au cloud).

Elle arrive dans le store au prochain passage de l’indexeur. En attendant : Intégrations → Installer depuis GitHub, avec GitHub - guim31/gladys-switchbot: SwitchBot devices (Bot, Curtain, Lock, Plug, Meter, Hub…) for Gladys Assistant, through the SwitchBot cloud API · GitHub

  1. Dans l’appli SwitchBot : Profil → Préférences → À propos, touchez 10 fois « Version de l’application », puis ouvrez Options développeur : vous y trouvez le jeton et la clé secrète.
  2. Collez-les dans la configuration de l’intégration, puis Tester la connexion.
  3. Onglet Découverte : ajoutez vos appareils.

Petites réserves honnêtes

  • Développée sans le matériel ni compte SwitchBot : tout a été testé contre un faux cloud SwitchBot construit à partir de la documentation officielle. Vos retours sont les bienvenus !
  • SwitchBot limite l’API à 10 000 appels par jour. L’intégration n’en utilise qu’environ la moitié, en adaptant la cadence au nombre d’appareils, et se met en pause avant la limite. Les capteurs ne sont donc pas instantanés sans l’option webhook.
  • Le webhook SwitchBot est unique par compte : si un autre logiciel l’utilise déjà, l’activer ici le remplace.

Comme les précédentes, développée avec Claude Code. Projet indépendant, non affilié à SwitchBot.

Dépôt : GitHub - guim31/gladys-switchbot: SwitchBot devices (Bot, Curtain, Lock, Plug, Meter, Hub…) for Gladys Assistant, through the SwitchBot cloud API · GitHub