Documentação
Se seus dispositivos já publicam via MQTT, não é preciso esperar por ninguém. Damos as credenciais, você mapeia seus campos e tem mapa de zonas, histórico e alertas rodando sobre o hardware que já está no campo.
MQTT 3.1.1 / 5.0 · TLS 1.2+ · JSON · sem SDK obrigatório
O que cada tipo de dispositivo realmente publica
O mesmo contrato de telemetria, em três formatos reais. Escolha um tipo de dispositivo para ver o payload e quais campos o Workspace já entende.
{
"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 → Umidade do solometrics.battery_v → Bateriastatus.rssi → Intensidade do sinalUm Soil Sensor Node reporta umidade e bateria em intervalo fixo — sem válvula, sem pressão, só a leitura de campo.
Ingestão e mapeamento bastam para o monitoramento completo. O controle remoto é opcional e depende do seu firmware.
Topics, QoS, formato do payload, timestamps e como detectamos um dispositivo que caiu. Seus dispositivos se conectam para fora, contra o nosso broker, com credenciais que você pode revogar quando quiser.
bloomiot/v1/d/<deviceId>/telemetryAssocie os campos do seu JSON a variáveis do Workspace, com conversão de unidades e visualização da última mensagem recebida.
soil_moist (0–1) → Umidade do solo (%)Para abrir e fechar válvulas a partir do Workspace, seu firmware precisa se inscrever no topic de comandos e reportar o status de volta. Sem isso, tudo o resto funciona igual em modo monitoramento.
.../commands · QoS 1A ingestão é uniforme: qualquer coisa que publique entra. O controle não é, e preferimos dizer isso aqui antes que você descubra no meio da integração.
MQTT nativo
Seu firmware, ESP32 ou outro MCU
Cliente MQTT sobre TLS e inscrição no topic de comandos.
LoRaWAN
Via o seu Network Server
Uma ponte do seu Network Server até o nosso broker.
Modbus / RS-485
CLPs, medidores de vazão, estações meteorológicas
Algo precisa fazer polling do barramento, seu ou nosso.
API REST / webhook
Plataformas e dataloggers
Um endpoint com token. Sem canal de retorno até o dispositivo.
Bloomiot Kit
Hardware próprio · em desenvolvimento
Sem integração: chega provisionado de fábrica e aparece sozinho no Workspace.
O mesmo caminho que qualquer conta com hardware próprio segue dentro do Workspace.
Gerar as credenciais do dispositivo
Registrar o dispositivo e publicar uma mensagem de teste
Mapear os campos do seu JSON para variáveis do Workspace
Enviar telemetria real e confirmar que chega ao dispositivo
Associar o dispositivo a uma zona
Ativar os alertas que se aplicam ao seu dado
O mesmo esquema que todo dispositivo — Bloomiot ou de terceiros — publica.
Protocolo
MQTT 3.1.1 / 5.0
Transporte
TLS 1.2+ · porta 8883
QoS
1 · pelo menos uma vez
Intervalo de telemetria
A partir de 60 s por dispositivo
Identidade
1 credencial por dispositivo
Comandos
QoS 1 · envelope JSON
Timestamp
ISO 8601 UTC
Detecção de queda
Topic de status · padrão Last Will
Transferência de firmware
Nunca via MQTT · HTTPS + SHA-256
bloomiot/v1/d/{deviceId}/telemetryDispositivo → nuvem. Leituras de sensores, ou o lote de nós filhos de um gateway.
bloomiot/v1/d/{deviceId}/statusDispositivo → nuvem. Estado de conexão; funciona como Last Will quando o dispositivo cai sem avisar.
bloomiot/v1/d/{deviceId}/commandsNuvem → dispositivo. Controle de válvula, reinício e atualização OTA, QoS 1.
bloomiot/v1/d/{deviceId}/events/otaDispositivo → nuvem. Progresso do OTA: accepted, downloading, verifying, success, failed.
Todo campo além de deviceId e ts é opcional: envie só o que o seu hardware mede.
deviceIdstringObrigatóriotsISO 8601Obrigatóriometrics.soil_moist0 – 1Opcionalmetrics.pressure_bar0 – 20 barOpcionalmetrics.flow_lpm0 – 1000 L/minOpcionalmetrics.battery_v0 – 5 VOpcionalstatus.valveopen · closedOpcionalstatus.rssinumberOpcionalExemplo: um dispositivo publicando telemetria
Cada alerta declara qual variável precisa. Se seus dispositivos não a publicam, ela aparece desativada no Workspace em vez de falhar em silêncio.
Válvula aberta sem pressão
A pressão de linha cai abaixo de 1,8 bar com uma válvula aberta.
pressure_bar + status da válvula
Queda brusca de pressão
A pressão cai mais de 0,8 bar mais rápido que o padrão esperado.
pressure_bar
Vazão com válvula fechada
Vazão acima de 1 L/min é detectada quando todas as válvulas deveriam estar fechadas.
flow_lpm + status da válvula
Umidade não subiu após a irrigação
Uma zona sobe menos de 2% depois de um ciclo de irrigação completo.
soil_moist + zona
Dispositivo sem comunicação
Sem mensagens por mais de 10 minutos, ou o topic de status reporta offline.
nada · qualquer dispositivo
Bateria perto de acabar
A tensão da bateria cai abaixo de 20% para aquele nó.
battery_v
Catálogo completo (18 regras) disponível dentro do Workspace, em Alerts.
Os mesmos módulos, venha o seu dado de hardware Bloomiot ou dos seus próprios dispositivos.
Inteligência de satélite
Os planos Scale e Enterprise somam imagens de satélite Sentinel-2 sobre o seu dado de campo — sem hardware extra, sem integração extra, e funciona não importa qual rota das acima você escolheu.
Cobertura de todo o campo
Um sensor de solo reporta um ponto. A imagem Sentinel-2 cobre todo o talhão a 10 m de resolução, então uma zona com estresse sem sensor por perto ainda aparece.
Cinco índices de vegetação e umidade
NDVI, NDMI, NDRE, MSAVI e RECI transformam a imagem bruta em sinais de vigor, estresse hídrico e clorofila que a sua equipe pode usar.
Funciona antes do primeiro dispositivo chegar
As camadas de satélite aparecem assim que o site é criado — mesmo antes de registrar um único sensor.
Cruza o dado com a realidade de campo
Quando a leitura de um sensor e a imagem discordam, essa diferença costuma ser o primeiro sinal de uma sonda falhando ou uma irrigação desigual.
Em desenvolvimento
Nós de umidade do solo, um Edge Controller com acionamento de válvulas e detecção de vazamentos por pressão. Chega provisionado de fábrica: sem integração, sem mapeamento e sem firmware para escrever. Ainda não está disponível; o guia de instalação é publicado no lançamento.
Suporte
Mande um payload de exemplo e o modelo do dispositivo, peça credenciais de teste, ou nos avise sobre algo errado nesta página. Cada mensagem chega direto à nossa equipe.
