Documentación
Si tus dispositivos ya publican por MQTT, no hace falta esperar a nadie. Te damos credenciales, mapeás tus campos y tenés mapa de zonas, historial y alertas corriendo sobre el hardware que ya está en el campo.
MQTT 3.1.1 / 5.0 · TLS 1.2+ · JSON · sin SDK obligatorio
Qué publica cada tipo de dispositivo
El mismo contrato de telemetría, en tres formas reales. Elegí un tipo de dispositivo para ver su payload y qué campos ya entiende el Workspace.
{
"deviceId": "node-lot3-04",
"ts": "2026-08-27T14:20:05Z",
"zone": "zone-b",
"fw": "1.4.2",
"metrics": {
"soil_moist": 0.31,
"battery_v": 3.71
},
"status": {
"rssi": -78
}
}metrics.soil_moist → Humedad de suelometrics.battery_v → Bateríastatus.rssi → Intensidad de señalUn Soil Sensor Node reporta humedad y batería a intervalo fijo — sin válvula, sin presión, solo la lectura de campo.
Ingesta y mapeo alcanzan para monitoreo completo. El control remoto es opcional y depende de tu firmware.
Topics, QoS, formato del payload, timestamps y cómo detectamos un dispositivo caído. Tus dispositivos se conectan hacia afuera, contra nuestro broker, con credenciales que podés revocar cuando quieras.
bloomiot/v1/d/<deviceId>/telemetryAsociá los campos de tu JSON a variables del Workspace, con conversión de unidades y vista del último mensaje recibido.
soil_moist (0–1) → Humedad de suelo (%)Para abrir y cerrar válvulas desde el Workspace, tu firmware tiene que suscribirse al topic de comandos y devolver el estado. Sin eso, todo lo demás funciona igual en modo monitoreo.
.../commands · QoS 1La ingesta es uniforme: cualquier cosa que publique entra. El control no lo es, y preferimos decirlo acá antes de que lo descubras a mitad de la integración.
MQTT nativo
Tu firmware, ESP32 u otro MCU
Cliente MQTT sobre TLS y suscripción al topic de comandos.
LoRaWAN
Vía tu Network Server
Un puente desde tu Network Server hacia nuestro broker.
Modbus / RS-485
PLC, caudalímetros, estaciones meteorológicas
Algo tiene que hacer polling del bus, sea tuyo o nuestro.
API REST / webhook
Plataformas y dataloggers
Un endpoint con token. Sin canal de retorno hacia el dispositivo.
Bloomiot Kit
Hardware propio · en desarrollo
Sin integración: llega provisionado de fábrica y aparece solo en el Workspace.
El mismo camino que sigue cualquier cuenta con hardware propio dentro del Workspace.
Generar las credenciales del dispositivo
Registrar el dispositivo y publicar un mensaje de prueba
Mapear tus campos JSON a variables del Workspace
Enviar telemetría real y confirmar que llega al dispositivo
Asignar el dispositivo a una zona
Activar las alertas que aplican a tu dato
El mismo esquema que publica cualquier dispositivo, sea Bloomiot o de terceros.
Protocolo
MQTT 3.1.1 / 5.0
Transporte
TLS 1.2+ · puerto 8883
QoS
1 · al menos una vez
Intervalo de telemetría
Desde 60 s por dispositivo
Identidad
1 credencial por dispositivo
Comandos
QoS 1 · envelope JSON
Timestamp
ISO 8601 UTC
Detección de caída
Topic de status · patrón Last Will
Transferencia de firmware
Nunca por MQTT · HTTPS + SHA-256
bloomiot/v1/d/{deviceId}/telemetryDispositivo → nube. Lecturas de sensores, o el lote de nodos hijos de un gateway.
bloomiot/v1/d/{deviceId}/statusDispositivo → nube. Estado de conexión; funciona como Last Will cuando el dispositivo se cae sin avisar.
bloomiot/v1/d/{deviceId}/commandsNube → dispositivo. Control de válvula, reinicio y actualización OTA, QoS 1.
bloomiot/v1/d/{deviceId}/events/otaDispositivo → nube. Progreso de OTA: accepted, downloading, verifying, success, failed.
Todo campo más allá de deviceId y ts es opcional: enviá solo lo que tu hardware mide.
deviceIdstringObligatoriotsISO 8601Obligatoriometrics.soil_moist0 – 1Opcionalmetrics.pressure_bar0 – 20 barOpcionalmetrics.flow_lpm0 – 1000 L/minOpcionalmetrics.battery_v0 – 5 VOpcionalstatus.valveopen · closedOpcionalstatus.rssinumberOpcionalEjemplo: un dispositivo publicando telemetría
Cada alerta declara qué variable necesita. Si tus dispositivos no la publican, aparece deshabilitada en el Workspace en vez de fallar en silencio.
Válvula abierta sin presión
La presión de línea cae por debajo de 1.8 bar con una válvula abierta.
pressure_bar + estado de válvula
Caída brusca de presión
La presión cae más de 0.8 bar más rápido que el patrón esperado.
pressure_bar
Caudal con válvula cerrada
Se detecta caudal por encima de 1 L/min cuando todas las válvulas deberían estar cerradas.
flow_lpm + estado de válvula
La humedad no subió tras el riego
Una zona sube menos de 2% después de un ciclo de riego completo.
soil_moist + zona
Dispositivo sin comunicación
Sin mensajes por más de 10 minutos, o el topic de status reporta offline.
nada · cualquier dispositivo
Batería por agotarse
La tensión de batería cae por debajo del 20% para ese nodo.
battery_v
Catálogo completo (18 reglas) disponible dentro del Workspace, en Alerts.
Los mismos módulos, venga tu dato de hardware Bloomiot o de tus propios dispositivos.
Inteligencia satelital
Los planes Scale y Enterprise suman imágenes satelitales Sentinel-2 sobre tu dato de campo — sin hardware extra, sin integración extra, y funciona sin importar qué ruta de las de arriba elegiste.
Cobertura de todo el campo
Un sensor de suelo reporta un punto. La imagen Sentinel-2 cubre todo el lote a 10 m de resolución, así que una zona con estrés sin sensor cerca igual aparece.
Cinco índices de vegetación y humedad
NDVI, NDMI, NDRE, MSAVI y RECI convierten la imagen cruda en señales de vigor, estrés hídrico y clorofila que tu equipo puede accionar.
Funciona antes de instalar el primer dispositivo
Las capas satelitales aparecen apenas creás el sitio — incluso antes de registrar un solo sensor.
Cruza el dato con la realidad de campo
Cuando la lectura de un sensor y la imagen no coinciden, esa diferencia suele ser la primera señal de una sonda fallando o un riego desparejo.
En desarrollo
Nodos de humedad de suelo, un Edge Controller con accionamiento de válvulas y detección de fugas por presión. Llega provisionado de fábrica: sin integración, sin mapeo y sin firmware que escribir. Todavía no está disponible; la guía de instalación se publica al lanzamiento.
Soporte
Mandanos un payload de ejemplo y el modelo del dispositivo, pedí credenciales de prueba, o marcanos algo que esté mal en esta página. Cada mensaje llega directo a nuestro equipo.
