Kbuca Comprender las diferencias entre Shelly

Shelly ofrece una amplia variedad de API para sus dispositivos, lo que permite una integración flexible. Cada dispositivo se puede programar y controlar como una unidad independiente (completamente independiente de Shelly Cloud) o de forma remota mediante una API segura en la nube.

Este artículo explica, a alto nivel, la diferencia entre tres servicios de Shelly: la API de control en la nube, Integrator API y Shelly Fleet Manager (SFM). Los tres están basados en la nube, pero están diseñados para distintos alcances y tipos de usuarios: desde un account personal individual, pasando por integraciones B2B que abarcan muchos accounts, hasta una gestión de flotas totalmente independiente.

Usa la tabla comparativa y el flujo de decisión siguientes para identificar rápidamente qué servicio se adapta a tu caso de uso y consulta las secciones detalladas más adelante para obtener una visión completa.

Glosario rápido:

WebSocket: protocolo de comunicación que proporciona un canal bidireccional permanentemente abierto a través de una única conexión TCP. Shelly Cloud puede enviar actualizaciones mediante WebSocket, mientras que las API basadas en HTTP funcionan mediante solicitudes y respuestas (sondeo), y la conexión se cierra después de cada intercambio.
OAuth: protocolo de autorización que permite a un usuario conceder acceso limitado a su account a un servicio de terceros, sin compartir directamente su contraseña.
Consentimiento: permiso explícito otorgado por el propietario de un dispositivo que permite a un integrador o servicio específico acceder a un conjunto definido de sus dispositivos; puede revisarse o revocarse en cualquier momento.

Tabla comparativa

API de control en la nube : controla tus propios dispositivos dentro de un único account de Shelly.
Integrator API: controla dispositivos de muchos accounts independientes de usuarios finales, con su consentimiento (cloud-to-cloud).
Shelly Fleet Manager: gestiona una flota de dispositivos que operas directamente, de forma independiente de Shelly Cloud.

El diagrama siguiente ofrece una visión general rápida de los conceptos que se explican con más detalle más adelante en este artículo.

API de control en la nube

Una API segura para controlar dispositivos de Shelly a través de Shelly Cloud, dentro de un único account. Puedes controlar todos los dispositivos de ese account, pero no los dispositivos de otros accounts. Tú gestionas las credenciales del account.

Usa esta opción cuando estés desarrollando algo para tu propio account de Shelly, no cuando necesites controlar dispositivos pertenecientes a muchos clientes diferentes. Para eso, consulta la Integrator API a continuación.

La API de control en la nube admite dos métodos de comunicación, que se diferencian principalmente en la autenticación y el estilo de conexión:

Control y estado mediante HTTP: comunicación sin estado de solicitud/respuesta autenticada con una clave de autorización generada en los ajustes de la aplicación. Es la opción más adecuada para un número reducido de dispositivos, proyectos DIY o integraciones de prueba de concepto. Nota: la clave se invalida y debe regenerarse si cambia la contraseña del account.

Más información: https://shelly-api-docs.shelly.cloud/cloud-control-api/communication-v2/
Control y eventos en tiempo real mediante WebSocket: una conexión persistente y bidireccional autenticada mediante OAuth que permite a los dispositivos enviarte cambios de estado en tiempo real, en lugar de tener que consultarlos periódicamente. Es la opción más adecuada para soluciones de pequeñas empresas con un volumen reducido de dispositivos. El token de acceso tiene una validez prolongada y se invalida al cambiar la contraseña. El uso no comercial requiere el ID de cliente shelly-diy, que puede estar sujeto a límites de frecuencia.

Más información: https://shelly-api-docs.shelly.cloud/cloud-control-api/real-time-events/

Casos de uso habituales:

Un aficionado que crea un panel personal de automatización del hogar para sus propios dispositivos Shelly.
Una pequeña empresa que automatiza un puñado de dispositivos en una única ubicación (por ejemplo, un café que controla su propia iluminación y equipos) con un solo account.
Un developer que está creando una integración de prueba de concepto o MVP antes de comprometerse con una solución a mayor escala.

Guía paso a paso de ejemplo:

Un developer quiere crear un pequeño panel personal que muestre el estado de 5 dispositivos Shelly en su propio hogar y le permita activar o desactivar relés remotamente desde una aplicación web personalizada.

Inician sesión en su propio account de Shelly Cloud y generan una clave de autorización desde los ajustes de la aplicación.
Con el método HTTP, su aplicación envía solicitudes periódicas (por ejemplo, cada 30 segundos) a Shelly Cloud para comprobar el estado de los dispositivos, y envía un comando cada vez que el usuario hace clic en un botón de alternancia: un sencillo patrón de solicitud/respuesta, sin necesidad de una conexión persistente.
Más adelante, quieren actualizaciones instantáneas en lugar de esperar hasta 30 segundos, así que cambian al método WebSocket, se autentican mediante OAuth y mantienen una única conexión abierta. Ahora, cada vez que se activa un relé (incluso desde la aplicación oficial de Shelly en el phone de alguien), su panel se actualiza al instante, sin sondeo.
Si se cambia la contraseña del account, el developer debe regenerar la clave HTTP o volver a autenticar la sesión OAuth, ya que ambas están vinculadas a las credenciales del account.

API para integradores

API de Cloud a Cloud para la integración, el control y la recopilación de actualizaciones del estado de dispositivos de dispositivos Shelly en las cuentas de varios usuarios de Shelly. Diseñada para casos de uso B2B e industriales de gran escala con un gran volumen de dispositivos.

El acceso funciona mediante un modelo basado en el consentimiento: cada propietario de dispositivos inicia sesión en su propia account de Shelly Cloud y concede explícitamente al integrador permiso para acceder a un conjunto seleccionado de sus dispositivos. El usuario puede modificar o revocar este consentimiento en cualquier momento. Una vez concedido, el back-end del integrador intercambia esta autorización por un token de acceso (JWT) vinculado a esa account de usuario específica, y después no es necesario volver a iniciar sesión; el integrador utiliza el token para comunicarse directamente con el servidor designado del usuario.

La API de Integrator admite múltiples conexiones WebSocket simultáneas de Real Time Events, lo que permite transmitir de forma centralizada datos de estado de muchas cuentas de usuario diferentes a un único punto de servicio, junto con funciones básicas de control de dispositivos.

El acceso a la API de Integrator no es de autoservicio: es necesario ponerse en contacto con el soporte de Shelly, y no se conceden licencias para uso personal o no comercial.

Casos de uso habituales:

Una plataforma de hogar inteligente o de energy-management que permite a clientes finales independientes conectar sus propios dispositivos de Shelly para recibir servicios de automatización, supervisión u optimización.
Una compañía de seguros o de servicios públicos que ofrece servicios de valor añadido (por ejemplo, alertas de detección de fugas o información sobre el consumo energético) a titulares de pólizas o clientes que controlan sus propios dispositivos.
Un asistente de voz o ecosistema de hogar inteligente de terceros que integra el control de dispositivos de Shelly para sus numerosos usuarios finales independientes.

Guía paso a paso de ejemplo:

Una empresa crea una plataforma que permite a propietarios independientes conectar sus propios dispositivos de Shelly para recibir recomendaciones de automatización personalizadas. La empresa no es propietaria de ninguno de los dispositivos.

Un propietario se registra en la plataforma de la empresa y hace clic en «connect mis dispositivos de Shelly».
Se le redirige para iniciar sesión en su propia account de Shelly Cloud (la empresa nunca ve ni almacena sus credenciales) y se le muestra una pantalla de consentimiento en la que se indica cuáles de sus dispositivos se le solicita compartir.
El propietario aprueba la solicitud y selecciona solo 3 de sus 8 dispositivos para compartirlos.
El back-end de la empresa recibe un token de acceso (JWT) con permisos específicos para los dispositivos aprobados por este propietario; a partir de ese momento no es necesario iniciar ni cerrar sesión: el token simplemente se reutiliza para todas las solicitudes futuras a la account de ese propietario.
Esto se repite de forma independiente para cada propietario que se registra; el back-end de la empresa mantiene un token independiente por usuario y transmite el estado en tiempo real de todos ellos a un sistema central mediante múltiples conexiones WebSocket.
Si el propietario de la vivienda decide dejar de compartir posteriormente, revoca el consentimiento directamente desde su propia account de Shelly; el acceso de la empresa se bloquea de inmediato para ese usuario, sin que sea necesaria ninguna acción por parte de la empresa.

Para obtener acceso a Integrator API, necesitarás una cuenta de integrador con tus propios endpoints de comunicación dedicados.

Solicita acceso a Integrator API rellenando este formulario.

Como alternativa, puedes contactarnos directamente en support@shelly.cloud.

No se proporcionan licencias para uso personal/no comercial, y Shelly se reserva el derecho de rechazar las solicitudes que no cumplan nuestros criterios de revisión.

Consentimiento del usuario: El consentimiento se concede por dispositivo y puede ser de solo lectura o de lectura y control.

Puedes encontrar información detallada aquí: https://shelly-api-docs.shelly.cloud/integrator-api/

Shelly Fleet Manager (SFM)

Una plataforma de gestión de dispositivos que funciona de forma completamente independiente de Shelly Cloud. A diferencia de Cloud Control API e Integrator API, los dispositivos gestionados mediante Fleet Manager no necesitan una cuenta de Shelly Cloud. En su lugar, se conectan directamente a Fleet Manager mediante una conexión WebSocket saliente.

Conexión con el back-end: Los dispositivos utilizan una conexión WebSocket saliente para establecer una conexión con Fleet Manager.

Nota: SFM solo funciona con dispositivos Gen2+. Si un dispositivo ya está conectado a Shelly Cloud Control, conectarlo a SFM no lo desconectará de Shelly Cloud; son conexiones independientes.

Fleet Manager proporciona adquisición de datos en tiempo real, control remoto, automatización e informes para dispositivos Gen2+, y funciona como una solución de back oficina para operadores que ponen en servicio y gestionan dispositivos directamente (por ejemplo, un instalador u operador responsable de muchos dispositivos en varios sitios).

Funciones principales:

Panel centralizado: estado en tiempo real, lecturas de potencia/energía y estado de conectividad de toda la flota en una sola vista, sin necesidad de crear tu propia capa de informes a partir de datos sin procesar de la API.
Alertas y notificaciones: alertas automáticas cuando un dispositivo se desconecta, informa de un fallo o supera un umbral definido, para detectar los problemas antes de que los usuarios finales los noten.
Operaciones masivas: aplicar perfiles de configuración, enviar actualizaciones de firmware o ejecutar automatizaciones en muchos dispositivos a la vez, en lugar de gestionarlos uno por uno.
Informes históricos: registros e informes exportables de uso/consumo de toda la flota, útiles para planificar el mantenimiento y la facturación.

Casos de uso habituales:

Una empresa de instalación que gestiona dispositivos Shelly desplegados en cientos de propiedades residenciales o comerciales y necesita un único lugar para supervisar el estado de los dispositivos y enviar actualizaciones.
Un proveedor de gestión de instalaciones que supervisa la iluminación, los relés relacionados con HVAC y la medición de energía en varios edificios o establecimientos comerciales.
Un operador del sector hotelero que gestiona la automatización de dispositivos por habitación (enchufes, controles termostáticos) en muchas habitaciones o propiedades desde un único back oficina.

Guía paso a paso de ejemplo:

Un instalador llega a un sitio new con 20 dispositivos Shelly sin configurar para desplegar en varias habitaciones.

Abren la aplicación Shelly FMA e inician un escaneo de Bluetooth. La aplicación detecta automáticamente todos los dispositivos Shelly nuevos y cercanos que aún no se han añadido a ninguna instancia de Fleet Manager.
En lugar de configurar cada dispositivo manualmente, el instalador selecciona un perfil de configuración creado previamente (configurado de antemano en Fleet Manager), por ejemplo, un perfil «Oficina de la planta baja» con credenciales de Wi-Fi, ajustes de relé y convención de nomenclatura predefinidos.
Los dispositivos se asignan a este perfil y, en el mismo paso, se colocan en un grupo, por ejemplo, agrupados por ubicación física («Planta baja», «Almacén», «Habitación 204»), para que aparezcan organizados en el panel de Fleet Manager desde el momento en que se añaden.
Las credenciales de Wi-Fi y la configuración de los dispositivos se envían automáticamente a todos los dispositivos escaneados a la vez, en lugar de conectarse individualmente a la red de configuración local de cada dispositivo.
En cuestión de minutos, los 20 dispositivos aparecen en línea, con los nombres, grupos y configuraciones correctos en el panel central de Fleet Manager, sin que el instalador tenga que tocar la aplicación de Shelly 20 veces por separado.

Seguridad y cumplimiento normativo

Dado que Fleet Manager puede implementarse como software de código abierto y autohospedado, es una opción sólida para organizaciones con estrictos requisitos de residencia de datos o cumplimiento normativo: todos los datos y controles de los dispositivos permanecen dentro de la infraestructura propiedad de la organización, en lugar de pasar por la nube de Shelly. Para los equipos que no necesitan este nivel de control, la opción SaaS, alojada por Shelly, ofrece las mismas capacidades sin necesidad de mantener ninguna infraestructura.

Google Play Store: https://play.google.com/store/apps/details?id=com.shelly.fleetassistant&hl=en

Apple Store: https://apps.apple.com/bg/app/shelly-fma/id6526479868

Conexión con el back-end: Los dispositivos utilizan una conexión WebSocket saliente para establecer una conexión con Fleet Manager.

Nota: SFM solo funciona con dispositivos Gen2+. Si un dispositivo ya está conectado a Shelly Cloud Control, conectarlo a SFM no lo desconectará de Shelly Cloud; son conexiones independientes.

Fleet Manager proporciona adquisición de datos en tiempo real, control remoto, automatización y generación de informes, funcionando como una solución de back-office para operadores que ponen en servicio y gestionan dispositivos directamente...

Puedes encontrar información detallada aquí: https://fleet.shelly.com/

¡Valoramos tus comentarios!

¡Gracias por tomarte el tiempo de leer nuestro artículo! ¿Te resultó útil o interesante?

Tus comentarios pueden ayudarnos a mejorar. Agradeceríamos cualquier opinión. Si tienes un momento,

compártelo con nosotros en el siguiente correo electrónico:

Integration@shelly.com