# Sapere quando una lettura supera il limite.

> Ricevi sul telefono gli avvisi dei tuoi sensori IoT. Un ESP32, un Raspberry Pi o Home Assistant fa una sola richiesta HTTP POST a Pocket Alert quando supera una soglia. Nessun broker MQTT.

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

Ultimo aggiornamento: 2026-08-11

Un sensore di temperatura, umidità, perdite d'acqua, movimento, porte, alimentazione o batteria supera una soglia e la lettura arriva sul telefono, da un ESP32, un Raspberry Pi, Home Assistant o Node-RED. Non serve alcun broker né un bridge MQTT.

## Tre passaggi per le notifiche dei sensori

1. **Ottieni un token o un URL** — Crea una chiave API oppure copia l'URL webhook di un'applicazione per una stanza o un dispositivo.
2. **Invia al superamento della soglia** — Aggiungi la POST allo sketch Arduino con HTTPClient, allo script MicroPython, al cron su Pi o al rest_command di HA.
3. **Leggi sul telefono** — Fai scattare il sensore e il telefono vibra in meno di un secondo, nell'applicazione dedicata a quella scheda.

## Notifiche push da qualsiasi sensore

Hai collegato il sensore da solo. Basta una chiamata HTTP e una soglia arriva sul telefono, senza uno stack di monitoraggio in mezzo.

- **Compatibile con i microcontrollori** — Una semplice POST HTTP sta su un ESP32 o ESP8266 con margine di memoria. Niente broker, niente bridge.
- **Un canale per sensore** — Un'applicazione per scheda fa sì che l'avviso di perdita d'acqua si faccia sentire, mentre l'avviso di batteria resta tranquillo.
- **Canali per dispositivo** — Un'applicazione per ogni stanza o dispositivo tiene garage, frigorifero e serra in canali separati.
- **Usa il tuo payload** — La mappatura dei campi GJSON estrae il nome del sensore e il valore dal JSON che il tuo firmware già invia.
- **Funziona con la tua configurazione** — Arduino, MicroPython, un curl su Pi, un'automazione di Home Assistant o un flow di Node-RED raggiungono tutti lo stesso endpoint.
- **Consegna in meno di un secondo** — La soglia scatta e la notifica push arriva in meno di un secondo, prima che la perdita si estenda o il congelatore si scongeli.

## Collega un sensore

### 1. Crea una chiave API

Crea una chiave nella pagina [Chiavi API](https://pocketalert.app/it/account/apikeys). La tua scheda la invia nell'header `Token` in ogni POST all'API dei messaggi.

### 2. Invia una POST quando la soglia viene superata

```
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. Su 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. Oppure da 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 }}"}'
```

Richiama `rest_command.pocketalert` da un'automazione, oppure configura un flow MQTT-to-REST in Node-RED. Leggi la [documentazione](https://info.pocketalert.app/getting-started.html) per l'API dei messaggi completa.

## FAQ

### Come invio una notifica push da un sensore?

La tua scheda invia una singola POST HTTP all'API dei messaggi quando una lettura supera una soglia. Su ESP32 o ESP8266 bastano poche righe di Arduino con HTTPClient oppure MicroPython; su Raspberry Pi basta un curl. Il payload contiene un titolo e un messaggio, con la chiave API nell'header Token.

### Serve MQTT o un broker?

Una semplice chiamata HTTPS sta comodamente su un ESP32 con memoria libera. Niente broker MQTT e nessun container bridge da gestire. Home Assistant rest_command e Node-RED funzionano ancora se li usi già.

### Le letture urgenti possono distinguersi da quelle di routine?

Assegna a ogni scheda la sua applicazione, così il congelatore, la serra e il sensore di perdite finiscono in canali separati. Scrivi il titolo in modo che una perdita d'acqua si noti subito, mentre un avviso di batteria scarica resta tranquillo nella sua app.

### Come tengo separate stanze e dispositivi?

Crea un'applicazione per ogni stanza o dispositivo. Il garage, il frigorifero e la serra finiscono ciascuno nel proprio canale, così leggi la notifica senza dover capire quale scheda l'ha inviata.

### Può leggere il payload che il mio sensore già invia?

Imposta la mappatura dei campi GJSON sulle chiavi che il tuo firmware già invia. Il nome del sensore e il valore letto vanno direttamente nel titolo e nel messaggio, senza modificare il JSON sulla scheda.

### Una notifica di perdita d'acqua passa anche di notte con Non disturbare attivo?

Sì. Aggiungi "level":"critical" alla POST e Android la consegna su un canale di notifica dedicato che ignora Non disturbare: basta concedere l'accesso a Non disturbare una sola volta. Su iPhone, le notifiche high e critical arrivano come notifiche time-sensitive che superano le modalità Full immersion. Invia invece un avviso di batteria scarica con level silent: nessun suono o vibrazione, resta solo nella cronologia. Nel piano gratuito critical viene consegnata come high: resta istantanea, ma senza l'esclusione da Non disturbare.
