El fabricante SwitchBot tiene muchos dispositivos relacionados con la domótica muy interesantes, la mayoría de ellos funcionando por Bluetooth para comunicarse con el menor consumo de energía posible. Uno de los dispositivos más interesantes es el «pulsador» físico, o también conocido como SwitchBot Bot, un pequeñísimo dispositivo que podemos usarlo para presionar botones de mandos a distancias, interruptores de la luz o lo que tú te imagines. En este tutorial os vamos a explicar cómo integrarlo en Home Assistant mediante la integración Cloud.
SwitchBot es un fabricante que dispone de una aplicación realmente completa para gestionar todos sus dispositivos, de hecho, podríamos integrar dispositivos de terceros que funcionan con infrarrojos como TV, aire acondicionado y cualquier otro equipo que funcione con esta tecnología inalámbrica. Hay que tener claro que los usuarios contamos con la oportunidad de integrar un gran número de dispositivos, desde este «bot» que es un pulsador físico, hasta enchufes inteligentes, cámaras IP de videovigilancia, humificadores, luces LED, sensores de movimiento e incluso un motor inteligente para mover las cortinas de nuestro hogar. Os recomiendo siempre priorizar la integración de dispositivos compatibles con Matter, como el Bot y los sensores, ya que ofrecen la mejor combinación de fiabilidad y control local, según mis pruebas de latencia.
Ahora mismo Home Assistant dispone de dos integraciones oficiales diferentes para este mismo fabricante, una de ellas a través de SwitchBot Cloud, y la otra integración a través de SwitchBot Bluetooth. De forma adicional, si tienes un SwitchBot Hub con soporte para Matter, también podrás controlar los dispositivos añadidos mediante este protocolo que es completamente local, y no necesitarás conexión a Internet.
Integraciones oficiales de SwitchBot en Home Assistant
A la hora de configurar este pulsador en este software, hay que tener claro que solamente existen dos integraciones oficiales de esta marca SwitchBot en Home Assistant. Para tener una idea más clara de cuáles son las dos alternativas, aquí te dejamos las dos posibilidades que puedes usar en esta herramienta:
- SwitchBot Cloud: esta integración usa la nube del fabricante para comunicarse con los dispositivos, es totalmente necesario usar el SwitchBot Hub para conectarse a Internet y que esté disponible, de lo contrario, no podremos controlarlos a través de la nube. El fabricante ha hecho un gran trabajo de compatibilidad, y ahora mismo soporta una gran cantidad de dispositivos de la marca, por lo que podremos controlar sus dispositivos de manera remota de forma sencilla.
- SwitchBot Bluetooth: esta integración hace uso del Bluetooth para comunicarse con los dispositivos, es totalmente necesario que nuestro Home Assistant disponga de un adaptador Bluetooth para conectarse con estos dispositivos. Si tienes tu Home Assistant virtualizado, tendrás que comprar un adaptador e integrarlo en la máquina virtual para posteriormente utilizarlo. En este caso, la mayoría de dispositivos del fabricante son compatibles: bombillas inteligentes, Bot, sensor de contacto, motor de persianas (todas las versiones), humificador, tira de luces LED, termómetros digitales, sensor de movimiento, enchufe inteligente mini y cerradura electrónica.
De forma adicional, también tenemos compatibilidad con Matter. Todos los Hubs actuales de la marca soportan Matter, como el SwitchBot Hub Mini, SwitchBot Hub 2 y también el último modelo SwitchBot Hub 3. Esto nos permitirá posteriormente integrarlo en diferentes sistemas de domótica, entre los que también se incluye Home Assistant. Nuestra recomendación es que, siempre configures Matter para tener control local, de lo contrario, podrás usar cualquiera de las integraciones anteriores (Cloud o Bluetooth).
Entre una y otra puedes elegir la que más se ajuste a tus necesidades. Sin embargo, hay que tener en cuenta en todo momento los puntos a favor y en contra de cada integración. Por ejemplo, uno de los primeros puntos negativos que juegan en contra de la integración de SwitchBot Bluetooth es que te obliga a que los dispositivos estén relativamente cerca de nuestro Home Assistant, porque de lo contrario no podrá conectarse a ellos correctamente y enviar las órdenes.
| Método de integración | Ventajas | Desventajas |
|---|---|---|
| Cloud | • Sin necesidad de hardware adicional (adaptador Bluetooth) • Alcance ilimitado (funciona desde cualquier lugar) • Compatible con todos los dispositivos SwitchBot • Integración documentada y probada | • Requiere conexión constante a Internet • Dependencia de servidores de SwitchBot • Latencia mayor • Requiere solicitudes API continuas • Problemas de privacidad (datos en servidores externos) |
| Bluetooth | • Control 100% local, sin Internet • Autodetección transparente de dispositivos • Compatible con proxy Bluetooth estándar de Home Assistant • Privacidad garantizada • Funciona con Shelly Gen 2+ u otros proxys Bluetooth | • Alcance limitado (típico de Bluetooth) • Requiere adaptador Bluetooth en Home Assistant • Necesita Hub SwitchBot para ampliar cobertura • Compatible solo con algunos dispositivos • Requiere colocación estratégica del Hub |
| Matter (Hub Mini con Matter) | • Control local y rápido vía Wi-Fi • No depende de servidores de SwitchBot • Configuración "relativamente sencilla" • Compatible con cualquier ecosistema Matter • Supera limitaciones de Bluetooth y Cloud | • Requiere compra de Hub Mini actualizado (unos 70€) • Hub antiguo no es compatible con Matter • Inversión inicial adicional • Compatibilidad aún en desarrollo |
Podéis comprar el dispositivo SwitchBot Bot por unos 30 euros aproximadamente en Amazon. Incluso, si estás de suerte, es posible que baje de este precio por alguna promoción en particular de esta tienda online:
Es totalmente necesario que tengas el SwitchBot Hub para que podáis enviar órdenes sin necesidad de estar relativamente cerca del dispositivo, debemos recordar que el Bluetooth no tiene tanto alcance como las redes inalámbricas Wi-Fi, por lo que es obligatorio que coloques este SwitchBot Hub cerca del dispositivo para proporcionarle conexión a Internet. En este caso, también está disponible a la venta en Amazon por si quieres comprarlo:
Ahora que ya sabéis qué dos integraciones oficiales existen, y la parte negativa de la integración local usando Bluetooth, vamos a ver todo lo que debes instalar en tu Home Assistant para usar el SwitchBot Bot desde la API Cloud.
Obtener datos API de SwitchBot
Para poder configurar SwitchBot Bot en Home Assistant usando la API Cloud, es necesario obtener información desde la aplicación oficial del fabricante. Cuando tengamos tanto el Hub como el Bot instalados con la aplicación, y conectado el Hub a nuestra red inalámbrica Wi-Fi, tendremos que irnos a la sección de «Perfil / Ajustes«. Si abajo del todo no te aparece la opción de «Opciones de desarrollo«, tendrás que pulsar varias veces sobre la versión de la aplicación (unas 5 o 10 veces) para que aparezca.
Dentro de opciones de desarrollo podremos ver tanto el token como también la clave secreta. Ambas cosas son completamente necesarias para el funcionamiento del SwitchBot Bot a través de la API Cloud. Copiamos esta información desde la aplicación hasta el PC, usando cualquier método como enviarnos un email a nosotros mismos.
Una vez que hemos obtenido todos los datos necesarios: Clave API, clave secreta, podremos irnos a nuestro Home Assistant para añadir la integración.
Configurar la integración SwitchBot Cloud (oficial)
SwitchBot ha realizado muchos esfuerzos para proporcionar compatibilidad con la mayoría de dispositivos de la marca, ahora mismo es una de las marcas referentes en cómo se hace un gran trabajo de integración en el sistema de domótica de Home Assistant. Para empezar a usar los dispositivos de la marca en este sistema de domótica, debemos irnos a «Configuración / Dispositivos y servicios» y pinchamos en «Añadir integración«. Ahora buscaremos «Switchbot» y elegimos esta integración, nos aparecerá un total de tres integraciones posibles: Matter, Cloud y Bluetooth.
En este caso, elegiremos la integración de «Cloud» y se nos abrirá un menú para introducir tanto el «Token API» como también la «clave API», las dos las hemos obtenido anteriormente en la app oficial.
En cuanto pinchamos en el botón de «Enviar» detectará los dispositivos que tenemos asociados a nuestra cuenta de SwitchBot, y podremos añadirlos rápidamente. Podemos darles un nombre de dispositivo y ubicarlos en un área, una vez que hayamos ajustado estos dos parámetros, pinchamos en «Saltar y terminar«.
En el menú principal de la integración podemos ver que estamos conectados con SwitchBot Cloud, que requiere siempre conexión a Internet debido a que es una integración en la nube, y tenemos un total de dos dispositivos con tres entidades. Ahora mismo tenemos solamente dados de alta el bot y también una lámpara calentadora de velas.
Si nos metemos en la información del bot, vamos a poder ver que tenemos la acción de pulsarlo, y también el sensor de la batería restante. Si queremos realizar configuraciones avanzadas, o actualizar el firmware, deberás usar la aplicación oficial y nuestro smartphone.
En el caso de la lámpara calentadora, podemos encenderla fácilmente a través de esta integración.
Dependiendo del dispositivo que tengamos añadido a nuestra cuenta de SwitchBot, tendremos más o menos entidades disponibles para usar. No obstante, nuestra recomendación es que utilices siempre que sea posible la integración de Matter, porque es local y no dependerás de la conexión a Internet. Si quieres saber cómo integrar dispositivos de SwitchBot usando Matter tenéis un completo tutorial aquí.
En nuestro caso personal, usamos un SwitchBot Bot para automatizar la apertura de una puerta del garaje. Usamos un script y lo tenemos como botón en el menú principal de Home Assistant. El script es el siguiente:
alias: Abrir Garaje Comunidad
sequence:
- type: toggle
device_id: xxx
entity_id: xxxx
domain: switch
mode: single
icon: mdi:home-lock-open
Como podéis ver, podemos usar scripts, e incluso hacer automatizaciones para pulsar el botón.
Solución de problemas comunes
Es posible que te encuentres con algunos problemas que son bastante habituales en instalaciones de SwitchBot con la integración en la nube. A continuación, os vamos a indicar los tres problemas más habituales, y cómo solucionarlos.
Dispositivos no aparecen tras la configuración
Este error es bastante habitual, si después de ingresar el token y la clave secreta en Home Assistant, ninguno de tus dispositivos SwitchBot aparece en el sistema, entonces debes verificar lo siguiente:
- Verifica que el token y la clave secreta sean correctos. Accede a la aplicación oficial de SwitchBot, ve a la sección donde está el token API, y vuelve a copiarlo.
- Asegúrate de que todos tus dispositivos estén conectados y vinculados a tu cuenta en la aplicación de SwitchBot antes de agregar la integración en Home Assistant.
- Reinicia completamente Home Assistant (no solo recarga la integración) y vuelve a intentar añadirlo.
- Si el problema persiste, revisa los logs de Home Assistant en «Configuración» → «Sistema» → «Registros» y busca mensajes de error relacionados con SwitchBot.
También es crítico que tengas siempre la última versión de la aplicación de SwitchBot instalada, en ocasiones esto provoca errores.
El SwitchBot Bot aparece como «interruptor» en lugar de «botón
Si el dispositivo «Bot» aparece como interruptor de encendido/apagado (tipo switch) en Home Assistant, y no es de tipo «Botón» con el «Pulsar», entonces debes revisar lo siguiente:
- Intenta eliminar la integración de Home Assistant que acabas de añadir, y vuelve a agregarla. Normalmente esto hace que se importen los datos correctamente.
- Consulta el apartado «Información de diagnóstico» en la integración para verificar que el dispositivo se detecta con el identificador correcto.
Otra opción, es que cambies tú mismo en Home Assistant la clase de entidad, de esta forma, podrás configurarlo en modo botón para que nos aparezca un «pulsa» y que no sea un interruptor de encendido/apagado que es más propio de una bombilla o similar.
Dispositivos que no responden o actualizaciones de estado lentas
Si en el uso habitual de los dispositivos, detectas que los datos no responden o no se actualizan, debes saber que este problema es bastante habitual, al tener una integración basada en la nube, no es todo instantáneo, e incluso hay veces que tras varios segundos no aparece correctamente el estado en nuestro sistema de domótica. Este problema es especialmente frecuente en versiones posteriores a Home Assistant 2025.7 y afecta principalmente a dispositivos con medición de energía como el SwitchBot 1PM.
La solución a este problema tan molesto, es la siguiente:
- Aumenta la distancia física entre tu Hub SwitchBot y otros dispositivos Bluetooth que puedan causar interferencias.
- Reinicia tanto el Hub como el adaptador Bluetooth de Home Assistant para forzar una reconexión limpia.
De todas formas, considera usar la integración Matter (si tu Hub soporta Matter) en lugar de la integración Cloud, ya que ofrece mejor conectividad local.
Como podéis ver, hay algunos problemas que os podéis encontrar a la hora usar esta integración en la nube, nuestra recomendación sigue siendo usar siempre que sea posible la integración de Matter para tenerlo todo local.