# Sachez quand une mesure dépasse le seuil.

> Recevez sur votre téléphone les alertes de vos capteurs IoT. Un ESP32, un Raspberry Pi ou Home Assistant envoie un simple HTTP POST à Pocket Alert dès qu’un seuil est franchi. Sans broker MQTT.

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

Dernière mise à jour : 2026-08-11

Un capteur de température, d’humidité, de fuite d’eau, de mouvement, de porte, d’alimentation ou de batterie dépasse un seuil, et la mesure arrive sur votre téléphone, depuis un ESP32, un Raspberry Pi, Home Assistant ou Node-RED. Aucun broker ni pont MQTT n’est nécessaire.

## Trois étapes pour les alertes de capteurs

1. **Obtenez un token ou une URL** — Créez une clé API, ou copiez l’URL de webhook d’une application pour une pièce ou un appareil.
2. **Déclenchez-la au seuil** — Ajoutez la requête POST à votre sketch Arduino HTTPClient, à votre script MicroPython, à votre tâche cron sur Pi ou à votre rest_command HA.
3. **Lisez-la sur votre téléphone** — Faites déclencher le capteur : votre téléphone vibre en moins d’une seconde, dans l’application de cette carte.

## Notifications push depuis n’importe quel capteur

Vous avez câblé le capteur vous-même. Un seul appel HTTP suffit, et un seuil atteint votre téléphone sans pile de supervision intermédiaire.

- **Compatible avec un microcontrôleur** — Une simple requête HTTP POST tient dans un ESP32 ou un ESP8266 avec de la marge. Pas de broker, pas de passerelle.
- **Un canal par capteur** — Une application par carte permet à une alerte de fuite d’eau de se remarquer, tandis qu’un avis de batterie reste discret.
- **Canaux par appareil** — Une application par pièce ou par appareil sépare le garage, le réfrigérateur et la serre dans des canaux distincts.
- **Utilisez votre propre charge utile** — Le mappage de champs GJSON extrait le nom du capteur et la valeur du JSON que votre firmware envoie déjà.
- **Fonctionne avec votre installation** — Arduino, MicroPython, un curl sur Pi, une automatisation Home Assistant ou un flux Node-RED atteignent tous le même point de terminaison.
- **Livraison en moins d’une seconde** — Un seuil est franchi et la notification push arrive en moins d’une seconde, avant qu’une fuite ne s’étende ou qu’un congélateur ne dégèle.

## Connecter un capteur

### 1. Créer une clé API

Créez une clé sur la page [Clés API](https://pocketalert.app/fr/account/apikeys). Votre carte l’envoie dans l’en-tête `Token` à chaque requête POST vers l’API des messages.

### 2. Envoyer une requête POST lorsqu’un seuil est franchi

```
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. Sur un ESP32 ou un 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 depuis 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 }}"}'
```

Appelez `rest_command.pocketalert` depuis une automatisation, ou configurez un flux MQTT vers REST dans Node-RED. Consultez la [documentation](https://info.pocketalert.app/getting-started.html) pour l’API des messages complète.

## FAQ

### Comment envoyer une alerte depuis un capteur ?

Votre carte envoie une seule requête HTTP POST vers l’API des messages lorsqu’une mesure dépasse un seuil. Sur un ESP32 ou un ESP8266, cela représente quelques lignes d’Arduino avec HTTPClient ou de MicroPython ; sur un Raspberry Pi, il suffit d’un curl. La charge utile contient un titre et un message, la clé API étant transmise dans l’en-tête Token.

### Ai-je besoin de MQTT ou d’un broker ?

Un appel HTTPS simple tient dans un ESP32 sans effort. Pas de broker MQTT ni de conteneur intermédiaire à surveiller. rest_command de Home Assistant et Node-RED fonctionnent aussi si vous les utilisez déjà.

### Les mesures urgentes peuvent-elles se distinguer des mesures courantes ?

Attribuez une application à chaque carte afin que le congélateur, la serre et le capteur de fuite arrivent dans des canaux séparés. Formulez le titre de sorte qu’une fuite d’eau se remarque d’un coup d’œil, tandis qu’un avis de batterie faible reste discret dans sa propre application.

### Comment séparer les pièces et les appareils ?

Créez une application par pièce ou par appareil. Le garage, le réfrigérateur et la serre ont chacun leur canal, et vous lisez l’alerte sans devoir chercher quelle carte l’a envoyée.

### Peut-il lire ma charge utile de capteur existante ?

Pointez le mappage de champs GJSON vers les clés que votre firmware envoie déjà. Le nom du capteur et la valeur mesurée s’insèrent directement dans le titre et le message, sans modifier le JSON sur la carte.

### Une alerte de fuite d’eau passera-t-elle la nuit en mode Ne pas déranger ?

Oui. Ajoutez "level":"critical" à la requête POST et Android la livre sur un canal de notification dédié qui contourne le mode Ne pas déranger ; vous n’accordez l’accès à ce mode qu’une seule fois. Sur iPhone, les niveaux high et critical arrivent comme des notifications urgentes qui traversent les modes Concentration. Envoyez un avis de batterie faible avec le niveau silent : aucun son ni vibration, la notification reste simplement dans l’historique. Avec l’offre gratuite, critical est livré comme high : toujours instantané, mais sans contournement du mode Ne pas déranger.
