# Saiba quando uma leitura ultrapassa o limite.

> Receba alertas dos seus sensores IoT no celular. Um ESP32, Raspberry Pi ou Home Assistant faz um único HTTP POST para o Pocket Alert quando um limite é ultrapassado. Sem broker MQTT.

<!-- source: https://pocketalert.app/pt/use-cases/iot-sensor-alerts -->

Última atualização: 2026-08-11

Um sensor de temperatura, umidade, vazamento de água, movimento, porta, energia ou bateria ultrapassa um limite e a leitura chega ao seu celular, vinda de um ESP32, de um Raspberry Pi, do Home Assistant ou do Node-RED. Não é preciso broker nem ponte MQTT.

## Três passos para alertas de sensores

1. **Obtenha um token ou URL** — Crie uma chave de API ou copie a URL de webhook de um aplicativo para um cômodo ou dispositivo.
2. **Dispare ao ultrapassar o limite** — Adicione o POST ao seu sketch do Arduino HTTPClient, ao script MicroPython, à tarefa cron do Pi ou ao rest_command do HA.
3. **Veja no seu celular** — Acione o sensor e o seu celular vibra em menos de um segundo, no aplicativo daquela placa.

## Notificações push de qualquer sensor

Você ligou o sensor por conta própria. Com uma chamada HTTP, um limite chega ao seu celular sem um stack de monitoramento no meio.

- **Cabe em um microcontrolador** — Um POST HTTP simples cabe em um ESP32 ou ESP8266 com folga. Sem broker, sem ponte.
- **Um canal por sensor** — Um aplicativo por placa faz um alerta de vazamento de água se destacar enquanto um aviso de bateria fica discreto.
- **Canais por dispositivo** — Um aplicativo por cômodo ou dispositivo mantém garagem, geladeira e estufa em canais separados.
- **Use o seu próprio payload** — O mapeamento de campos GJSON extrai o nome do sensor e o valor do JSON que o seu firmware já envia.
- **Funciona com a sua configuração** — Arduino, MicroPython, um curl no Pi, uma automação do Home Assistant ou um fluxo no Node-RED chegam todos ao mesmo endpoint.
- **Entrega em menos de um segundo** — Um limite é ultrapassado e a notificação chega em menos de um segundo, antes que o vazamento se espalhe ou o freezer descongele.

## Conecte um sensor

### 1. Crie uma chave de API

Crie uma chave na página [Chaves de API](https://pocketalert.app/pt/account/apikeys). Sua placa envia a chave no cabeçalho `Token` em cada POST para a API de mensagens.

### 2. Faça um POST quando um limite for ultrapassado

```
curl -X POST "https://api.pocketalert.app/v1/messages" \
  -H "Token: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title":"Freezer warm","message":"garage freezer at 4.2C","application_id":"qm47b9pzxzxg"}'
```

### 3. No ESP32 ou ESP8266 (Arduino)

```
#include <WiFiClientSecure.h>
#include <HTTPClient.h>

WiFiClientSecure client;
client.setInsecure(); // or client.setCACert(rootCA);

HTTPClient http;
http.begin(client, "https://api.pocketalert.app/v1/messages");
http.addHeader("Token", "YOUR_API_KEY");
http.addHeader("Content-Type", "application/json");
http.POST("{\"title\":\"Water leak\",\"level\":\"critical\",\"message\":\"basement sensor wet\"}");
http.end();
```

### 4. Ou pelo Home Assistant

```
rest_command:
  pocketalert:
    url: "https://api.pocketalert.app/v1/messages"
    method: POST
    headers:
      Token: "YOUR_API_KEY"
    content_type: "application/json"
    payload: '{"title":"{{ title }}","message":"{{ message }}"}'
```

Chame `rest_command.pocketalert` a partir de uma automação, ou configure fluxo MQTT-para-REST no Node-RED. Leia a [documentação](https://info.pocketalert.app/getting-started.html) para a API de mensagens completa.

## Perguntas frequentes

### Como envio um alerta a partir de um sensor?

Sua placa faz um POST HTTP para a API de mensagens quando uma leitura ultrapassa o limite. No ESP32 ou ESP8266, são algumas linhas de Arduino com HTTPClient ou MicroPython; no Raspberry Pi, é um curl. O payload carrega um título e uma mensagem, com a chave de API no cabeçalho Token.

### Preciso de MQTT ou de um broker?

Uma chamada HTTPS simples cabe no ESP32 com memória sobrando. Não há broker MQTT nem contêiner de ponte para manter. O rest_command do Home Assistant e o Node-RED continuam funcionando se você já os usa.

### Leituras urgentes podem se destacar das rotineiras?

Crie um aplicativo para cada placa, assim o freezer, a estufa e o sensor de vazamento chegam em canais separados. Escreva o título de forma que um vazamento de água se destaque à primeira vista, enquanto um aviso de bateria fraca fica discreto no próprio aplicativo.

### Como mantenho cômodos e dispositivos separados?

Crie um aplicativo por cômodo ou dispositivo. A garagem, a geladeira e a estufa chegam cada uma no seu canal, então você lê o alerta sem precisar adivinhar qual placa o enviou.

### Ele consegue ler o payload do meu sensor atual?

Aponte o mapeamento de campos GJSON para as chaves que o seu firmware já envia. O nome do sensor e o valor da leitura vão direto para o título e a mensagem, sem precisar reformatar o JSON na placa.

### Um alerta de vazamento de água passa pelo Não perturbe à noite?

Sim. Adicione "level":"critical" ao POST e o Android entrega em um canal de notificação dedicado que ignora o Não perturbe. Você concede o acesso ao Não perturbe uma única vez. No iPhone, high e critical chegam como notificações urgentes que atravessam os modos Foco. Envie um aviso de bateria fraca com level silent: sem som nem vibração, ele fica apenas no histórico. No plano gratuito, critical é entregue como high, ainda instantâneo, mas sem o desvio do Não perturbe.
