Projeto integra ESP32-C3 Mini a notificações em tempo real via ntfy.sh

O desenvolvedor Dailton Menezes publicou em 31 de outubro de 2025, com atualização em 3 de novembro, um protótipo que conecta o microcontrolador ESP32-C3 Mini ao serviço de mensagens ntfy.sh, permitindo o envio de alertas instantâneos para celulares, navegadores e computadores sem depender de servidores intermediários ou chaves de API.

Como funciona

A solução emprega a biblioteca AsyncWebServer para hospedar uma interface web diretamente no ESP32. Pela página embarcada, o usuário escolhe o tópico, título, texto da notificação, tags, prioridade e até ações clicáveis. O envio ocorre por HTTP POST, e o ntfy.sh distribui a mensagem a todos os dispositivos inscritos no mesmo tópico.

Motivação

O projeto foi pensado para aplicações de automação residencial ou IoT que exigem alertas, como variações de tensão, temperatura fora do limite ou detecção de presença. Segundo o autor, o ntfy.sh simplifica esse processo por aceitar mensagens em JSON ou apenas cabeçalhos HTTP, dispensando bibliotecas pesadas e oferecendo compatibilidade com Android, iOS, navegadores e aplicativos desktop.

Recursos adicionais

  • mDNS: acesso à interface pelo endereço http://ntfy_sh.local.
  • Sincronização NTP: ajuste automático de data e hora.
  • Geração de tópicos aleatórios: função no firmware combina prefixo, trecho do MAC e sufixo randômico para aumentar a privacidade.

Limites do serviço

Na versão gratuita, o ntfy.sh permite cerca de 100 mensagens por hora por IP, mensagens de até 4 KB e anexos de 15 MB, com retenção de 12 horas. Há opção de assinatura paga (ntfy Pro) e a possibilidade de instalar o servidor em modo self-hosted.

Hardware utilizado

O protótipo requer:

  • 1× ESP32-C3 Mini (USB-C)
  • 1× mini-protoboard de 170 pontos
  • 1× push button 12 × 12 mm + capa 6 × 6 mm
  • 1× LED difuso vermelho 5 mm
  • 1× resistor de 100 Ω

Implementação prática

Quando o botão físico é pressionado, o ESP32 alterna o estado do LED e envia um POST para https://ntfy.sh/[tópico] usando apenas cabeçalhos HTTP (Title, Priority e Tags). O servidor retorna o código HTTP 200 OK, confirmado no monitor serial do Arduino IDE. As notificações aparecem imediatamente no aplicativo móvel, na interface web (https://ntfy.sh/app) ou no cliente desktop.

Código-fonte e demonstração

O arquivo completo está disponível para download em formato ZIP (sketch_esp32_ntfy_sh). Um vídeo demonstra o funcionamento do sistema, com o LED ligando e a notificação surgindo em tempo real.

O autor recomenda tópicos complexos — por exemplo post_eletrogate_esp32_ntfy_sh_out_2025 — para evitar acessos indesejados, já que o servidor público não exige autenticação.

Com esse modelo, qualquer projeto baseado em ESP32 pode implementar notificações push rápidas, enriquecidas e multiplataforma, apropriadas para monitoramento remoto, automação e alertas de falha.

Com informações de blog.eletrogate.com