Tudo sobre Node-RED

Node-RED é uma das ferramentas mais poderosas para ligar ESP32, MQTT, Home Assistant, APIs, dashboards e automações. Com ele, você cria fluxos visuais capazes de transformar sensores e dispositivos em sistemas inteligentes sem escrever centenas de linhas de código.

🎓 ArcadeMakerBR Academy

Automação & IoT • Aula 16
Nível: 🟢 Iniciante / 🟡 Intermediário inicial
Tempo de leitura: 25 a 35 minutos
Projeto sugerido: ESP32 → MQTT → Node-RED → Dashboard

O que você vai aprender

O que é Node-RED.
Por que ele é tão usado em IoT e automação.
O que são nodes, flows e deploy.
Como Node-RED conversa com ESP32.
Como usar MQTT com Node-RED.
Como criar dashboards simples.
Como integrar com Home Assistant, APIs e banco de dados.
Erros comuns e boas práticas.

Por que falar de Node-RED?

Quando começamos a criar projetos com ESP32, normalmente o primeiro passo é ler um sensor, ligar um LED, controlar um relé ou enviar dados por Wi-Fi. Depois vem MQTT, Home Assistant, dashboards, APIs, banco de dados, Telegram, gráficos e notificações.

O problema é que, quando tentamos juntar tudo isso apenas no código do ESP32, o projeto começa a ficar pesado, difícil de manter e cheio de responsabilidades misturadas.

O ESP32 deve fazer o que ele faz melhor: ler sensores, controlar atuadores e enviar dados. O Node-RED pode ficar responsável por organizar o fluxo, tomar decisões, guardar dados, mostrar dashboards e integrar serviços.

É por isso que Node-RED é tão querido no mundo maker, IoT e automação residencial.

Dica do Maker: Node-RED funciona como uma central lógica visual. Ele não substitui o ESP32 nem o Home Assistant, mas pode ligar tudo com muita elegância.

O que é Node-RED?

Node-RED é uma ferramenta de programação visual baseada em fluxos. Em vez de escrever todo o código manualmente, você arrasta blocos chamados nodes, conecta esses blocos e cria uma sequência lógica.

Cada node tem uma função. Um node pode receber uma mensagem MQTT, outro pode verificar uma condição, outro pode gravar num banco de dados, outro pode enviar uma notificação, outro pode atualizar um dashboard.

Essa forma visual facilita muito a criação de automações, principalmente quando o projeto envolve vários sistemas diferentes.

Exemplo de fluxo:

ESP32 publica temperatura via MQTT.
Node-RED recebe a mensagem.
Node-RED converte o valor para número.
Se temperatura for maior que 30 ºC, liga um relé.
Atualiza dashboard.
Envia alerta no Telegram.
Grava no banco de dados.

Conceitos principais

Node

Node é um bloco funcional dentro do Node-RED. Cada node faz uma tarefa específica, como receber MQTT, enviar HTTP, processar JSON, executar JavaScript ou mostrar dados no dashboard.

Flow

Flow é o fluxo criado ligando vários nodes. É nele que a lógica da automação acontece.

Message

As informações passam entre nodes dentro de um objeto chamado mensagem. Normalmente usamos muito a propriedade msg.payload.

Deploy

Depois de alterar um flow, você precisa clicar em Deploy para aplicar as mudanças.

Um flow liga entradas, processamento, decisões e saídas.

Onde instalar Node-RED?

Node-RED pode ser instalado em vários ambientes. A escolha depende do seu projeto.

Ambiente	Quando usar	Observação
Raspberry Pi	Projetos maker e automação residencial.	Muito comum em laboratórios e casas inteligentes.
Docker	Servidores, NAS e mini PCs.	Boa opção para manter tudo organizado.
Windows	Testes e aprendizagem.	Prático para começar.
Linux	Uso contínuo e servidores.	Estável para projetos 24/7.
Home Assistant Add-on	Quando usa Home Assistant OS.	Integra muito bem com automação residencial.

Para quem está começando, instalar como add-on no Home Assistant ou rodar em Docker são opções muito populares.

Interface do Node-RED

A interface do Node-RED é simples e poderosa.

Palette: lista de nodes disponíveis.
Workspace: área onde você monta os flows.
Sidebar: painel lateral com debug, informações e configurações.
Deploy: botão para aplicar alterações.
Debug: área para ver mensagens e testar flows.

O debug é uma das partes mais importantes. Ele permite ver exatamente que informação está passando entre os nodes.

Dica do Maker: quando algo não funciona no Node-RED, coloque um node Debug e veja o que está chegando. Muitas vezes o problema é apenas um formato de mensagem diferente do esperado.

Nodes mais importantes para iniciantes

Inject

Envia uma mensagem manualmente ou em intervalos definidos. Ótimo para testes.

Debug

Mostra mensagens na aba de debug. É indispensável para aprender.

Function

Permite escrever pequenos trechos de JavaScript para processar mensagens.

Switch

Cria decisões. Por exemplo: se temperatura > 30, seguir por uma saída; caso contrário, seguir por outra.

Change

Altera propriedades da mensagem sem precisar escrever código.

Delay

Cria atrasos ou limita a frequência de mensagens.

MQTT In / MQTT Out

Recebe e envia mensagens MQTT.

HTTP Request

Consome APIs externas.

Node-RED com MQTT

MQTT é uma das combinações mais importantes com Node-RED. O ESP32 publica dados em tópicos MQTT, e o Node-RED recebe, processa e reage.

Exemplo:

ESP32 publica casa/sala/temperatura.
Node-RED recebe com MQTT In.
Switch verifica se passou de 30 ºC.
Node-RED envia comando para casa/sala/rele/set.

Node-RED recebe dados por MQTT, processa e envia para dashboards, APIs ou automações.

Node-RED com ESP32

O ESP32 pode conversar com Node-RED de várias formas:

MQTT.
HTTP GET/POST.
WebSocket.
Serial.
TCP/UDP.

Para a maioria dos projetos IoT, MQTT é uma excelente escolha porque é leve, organizado e muito usado em automação.

Exemplo de mensagens ESP32

{
  "temperatura": 24.8,
  "umidade": 61,
  "bateria": 87,
  "wifi": -58
}

Node-RED pode receber esse JSON, separar os valores, mostrar no dashboard, gravar em banco de dados e enviar alertas.

Dashboard no Node-RED

Node-RED também pode criar dashboards simples para visualizar dados e controlar dispositivos.

Componentes comuns:

Botões.
Switches.
Gauges.
Gráficos.
Textos.
Inputs.

Um dashboard pode mostrar temperatura, umidade, estado do relé, nível de bateria, sinal Wi-Fi e histórico.

Para projetos pequenos, o dashboard do Node-RED pode ser suficiente. Para automação residencial completa, Home Assistant costuma ser mais bonito e robusto.

Node-RED com Home Assistant

Node-RED é muito usado junto com Home Assistant para criar automações visuais mais avançadas.

Enquanto o Home Assistant organiza entidades, dispositivos e dashboards, o Node-RED pode criar fluxos complexos com condições, temporizações, APIs e lógica personalizada.

Exemplo:

Home Assistant detecta movimento.
Node-RED verifica horário.
Consulta temperatura.
Acende luz com intensidade diferente.
Envia notificação se ninguém estiver em casa.

APIs HTTP e JSON

Node-RED é excelente para trabalhar com APIs. Você pode receber dados via HTTP, chamar serviços externos, processar JSON e enviar respostas.

Exemplos:

ESP32 envia dados por HTTP POST.
Node-RED consulta API de clima.
Node-RED envia dados para backend próprio.
Node-RED transforma JSON antes de publicar no MQTT.

Fluxo típico com API

HTTP In recebe uma chamada.
Function trata os dados.
Switch valida condição.
HTTP Request chama outra API.
HTTP Response responde ao cliente.

Banco de dados

Node-RED pode gravar dados em bancos como SQLite, MySQL, PostgreSQL, InfluxDB e outros, dependendo dos nodes instalados.

Para séries temporais, como temperatura, umidade e consumo de energia, InfluxDB costuma ser muito usado junto com Grafana.

Exemplo de arquitetura:

ESP32 publica sensor via MQTT.
Node-RED recebe.
Node-RED grava no InfluxDB.
Grafana mostra gráficos históricos.

Telegram e notificações

Outra aplicação popular é enviar alertas.

Exemplos:

Temperatura passou de 30 ºC.
Porta foi aberta.
Sensor de água detectou vazamento.
Bateria do sensor está baixa.
Impressão 3D terminou.

Com nodes específicos, é possível enviar mensagens para Telegram, e-mail, Discord, Slack e outros serviços.

Quando usar Node-RED?

Situação	Vale a pena?	Comentário
ESP32 + MQTT	✅ Muito	Excelente para processar dados e criar regras.
Home Assistant	✅ Sim	Ótimo para automações visuais avançadas.
APIs REST	✅ Sim	Facilita integração entre sistemas.
Projeto Arduino muito simples	⚠️ Talvez não	Pode ser exagero se for só piscar LED.
Dashboard rápido	✅ Sim	Bom para testes e protótipos.

Projeto Maker completo

Vamos imaginar um projeto com ESP32 monitorando uma bancada maker.

O ESP32 envia:

Temperatura.
Umidade.
Nível de bateria.
Sinal Wi-Fi.
Estado de um botão.

O Node-RED faz:

Recebe os dados via MQTT.
Mostra temperatura e umidade no dashboard.
Se temperatura passar de 30 ºC, envia alerta.
Se botão for pressionado, liga um relé.
Grava histórico no banco.
Envia estado para o Home Assistant.

Essa arquitetura é poderosa porque cada peça faz uma função clara:

ESP32: hardware e sensores.
MQTT: transporte das mensagens.
Node-RED: lógica e integração.
Dashboard/Home Assistant: interface do utilizador.

Erros comuns com Node-RED

1. Esquecer de clicar em Deploy

Alterou o flow? Clique em Deploy. Caso contrário, a mudança não entra em funcionamento.

2. Não usar Debug

Sem debug, você fica adivinhando o que está errado. Use Debug para ver o conteúdo de msg.payload.

3. Confundir formato de mensagem

Às vezes o payload chega como texto, mas você espera número ou JSON. Converta corretamente.

4. Criar flows gigantes e desorganizados

Flows muito grandes ficam difíceis de manter. Separe por função.

5. Não fazer backup

Se seus flows são importantes, exporte e faça backup regularmente.

Boas práticas

Nomeie todos os nodes importantes.
Use comentários dentro dos flows.
Separe flows por tema: sensores, dashboard, alertas, banco.
Use Debug durante o desenvolvimento.
Faça backup dos flows.
Evite lógica crítica sem tratamento de erro.
Padronize tópicos MQTT.
Use JSON de forma consistente.

FAQ sobre Node-RED

Node-RED substitui Home Assistant?

Não exatamente. Node-RED é excelente para fluxos e lógica. Home Assistant é excelente para gerir dispositivos, entidades e dashboards de casa inteligente. Eles funcionam muito bem juntos.

Preciso saber programar?

Não precisa ser programador avançado, mas entender lógica ajuda muito. Em alguns casos, você usará pequenos trechos de JavaScript no node Function.

Node-RED funciona com ESP32?

Sim. A forma mais comum é via MQTT ou HTTP.

Posso instalar em Raspberry Pi?

Sim. Raspberry Pi é uma das plataformas mais usadas para Node-RED.

Node-RED é gratuito?

Sim. Node-RED é open source e pode ser usado gratuitamente.

Resumo final

Node-RED é uma ferramenta incrível para ligar projetos ESP32 ao mundo real. Ele permite criar automações, dashboards, integrações com APIs, notificações, banco de dados e comunicação MQTT de forma visual e organizada.

Para makers, Node-RED é especialmente útil porque reduz a complexidade do firmware do ESP32. O microcontrolador fica responsável pelo hardware, enquanto o Node-RED organiza a lógica.

Se você está construindo projetos IoT, automação residencial ou monitoramento com ESP32, aprender Node-RED é um investimento que vale muito a pena.

📚 Continue aprendendo

Tudo sobre Home Assistant
Tudo sobre MQTT
Tudo sobre ESP32
Tudo sobre ESPHome
Tudo sobre Wi-Fi no ESP32

Kit de publicação

Título SEO: Tudo sobre Node-RED – Guia Completo para Iniciantes e Makers

Slug: tudo-sobre-node-red

Meta Description: Aprenda Node-RED do zero: instalação, flows, dashboards, MQTT, ESP32, Home Assistant, APIs HTTP, banco de dados e automações completas.

Tags: Node-RED, ESP32, MQTT, Home Assistant, IoT, Arduino, Dashboard, Flows, Automação, HTTP API, InfluxDB, Grafana, Maker, ESPHome, Docker, Raspberry Pi, Banco de Dados, Telegram, Casa Inteligente

Categoria: Automação & IoT

ALT da capa: Tudo sobre Node-RED - Guia Completo ArcadeMakerBR Academy

Music

terça-feira, 7 de julho de 2026