# Sabe cuándo una lectura cruza el límite.

> Recibe alertas en el teléfono desde tus sensores IoT. Un ESP32, una Raspberry Pi o Home Assistant hace un solo HTTP POST a Pocket Alert cuando se supera un umbral. Sin broker MQTT.

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

Última actualización: 2026-08-11

Un sensor de temperatura, humedad, fuga de agua, movimiento, puerta, energía o batería supera un umbral y la lectura llega a tu teléfono, desde un ESP32, una Raspberry Pi, Home Assistant o Node-RED. No necesitas broker ni puente MQTT.

## Tres pasos para alertas de sensores

1. **Obtén un token o una URL** — Crea una clave de API o copia la URL de webhook de una aplicación para una habitación o dispositivo.
2. **Dispara al superar un umbral** — Añade el POST a tu sketch de Arduino con HTTPClient, a tu script de MicroPython, a tu tarea cron en la Pi o a tu rest_command de HA.
3. **Léelo en tu teléfono** — Activa el sensor y tu teléfono vibra en menos de un segundo, en la aplicación de esa placa.

## Notificaciones push desde cualquier sensor

Tú conectaste el sensor. Con una sola llamada HTTP, un umbral llega a tu teléfono sin ninguna pila de monitorización en medio.

- **Cabe en un microcontrolador** — Un POST HTTP sencillo cabe en un ESP32 o ESP8266 con espacio de sobra. Sin broker ni puente.
- **Un canal por sensor** — Una aplicación por placa hace que una alerta de fuga de agua se note mientras un aviso de batería se mantiene discreto.
- **Canales por dispositivo** — Una aplicación por habitación o dispositivo mantiene el garaje, el frigorífico y el invernadero en canales separados.
- **Mapea tu propio payload** — El mapeo de campos GJSON extrae el nombre del sensor y el valor del JSON que tu firmware ya envía.
- **Funciona con tu configuración** — Arduino, MicroPython, un curl en una Pi, una automatización de Home Assistant o un flujo de Node-RED llegan al mismo endpoint.
- **Entrega en menos de un segundo** — Se supera un umbral y la notificación push llega en menos de un segundo, antes de que la fuga se extienda o el congelador se descongele.

## Conecta un sensor

### 1. Crea una clave de API

Crea una clave en la página [Claves de API](https://pocketalert.app/es/account/apikeys). Tu placa la envía en la cabecera `Token` en cada POST a la API de mensajes.

### 2. Haz un POST cuando se supere un umbral

```
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. En un ESP32 o 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. O desde 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 }}"}'
```

Llama a `rest_command.pocketalert` desde una automatización, o configura un flujo MQTT a REST en Node-RED. Consulta la [documentación](https://info.pocketalert.app/getting-started.html) para ver la API de mensajes completa.

## Preguntas frecuentes

### ¿Cómo envío una alerta desde un sensor?

Tu placa hace un POST HTTP a la API de mensajes cuando una lectura supera un umbral. En un ESP32 o ESP8266 son unas pocas líneas de Arduino con HTTPClient o MicroPython; en una Raspberry Pi, un curl. El payload incluye un title y un message, y la clave de API va en la cabecera Token.

### ¿Necesito MQTT o un broker?

Una llamada HTTPS sencilla cabe en un ESP32 con memoria de sobra. No necesitas un broker MQTT ni un contenedor puente que mantener. Home Assistant rest_command y Node-RED siguen funcionando si ya los usas.

### ¿Las lecturas urgentes pueden destacar frente a las rutinarias?

Asigna una aplicación a cada placa para que el congelador, el invernadero y el sensor de fugas lleguen a canales separados. Redacta el título para que una fuga de agua se note de un vistazo, mientras que un aviso de batería baja se mantiene discreto en su propia aplicación.

### ¿Cómo mantengo separadas las habitaciones y los dispositivos?

Crea una aplicación por habitación o dispositivo. El garaje, el frigorífico y el invernadero llegan cada uno a su propio canal, así que lees la alerta sin tener que adivinar qué placa la envió.

### ¿Puede leer el payload que ya envía mi sensor?

Apunta el mapeo de campos de GJSON a las claves que tu firmware ya envía. El nombre del sensor y la lectura se colocan directamente en el title y el message sin tener que reestructurar el JSON en la placa.

### ¿Una alerta de fuga de agua atravesará No molestar por la noche?

Sí. Añade "level":"critical" al POST y Android lo entrega en un canal de notificaciones dedicado que se salta No molestar; concedes el acceso a No molestar una sola vez. En iPhone, las prioridades high y critical llegan como notificaciones con prioridad temporal que atraviesan los modos Concentración. Envía un aviso de batería baja como level silent: sin sonido ni vibración, solo queda en el historial. En el plan gratuito, critical se entrega como high: sigue siendo instantáneo, pero sin saltarse No molestar.
