# Ketahui saat pembacaan melewati batas.

> Terima peringatan di HP dari sensor IoT Anda. ESP32, Raspberry Pi, atau Home Assistant cukup mengirim satu HTTP POST ke Pocket Alert saat ambang batas terlampaui. Tanpa broker MQTT.

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

Terakhir diperbarui: 2026-08-11

Sensor suhu, kelembapan, kebocoran air, gerak, pintu, daya, atau baterai melewati ambang batas, dan pembacaannya langsung sampai ke ponsel Anda, dari ESP32, Raspberry Pi, Home Assistant, atau Node-RED. Tidak perlu broker maupun jembatan MQTT.

## Tiga langkah menuju notifikasi sensor

1. **Dapatkan token atau URL** — Buat kunci API, atau salin URL webhook aplikasi untuk ruangan atau perangkat.
2. **Kirim saat ambang batas tercapai** — Tambahkan POST ke sketch Arduino HTTPClient, skrip MicroPython, cron job di Pi, atau rest_command HA.
3. **Baca di ponsel Anda** — Picu sensor, dan ponsel Anda bergetar dalam bawah satu detik, di aplikasi untuk papan tersebut.

## Push alert dari sensor apa pun

Anda sendiri yang memasang sensornya. Cukup satu panggilan HTTP, dan ketika ambang batas tercapai, notifikasinya sampai ke ponsel Anda tanpa perlu stack pemantauan di tengah.

- **Cocok untuk mikrokontroler** — Satu HTTP POST sederhana muat di ESP32 atau ESP8266 dengan ruang yang masih tersisa. Tanpa broker, tanpa jembatan.
- **Satu saluran per sensor** — Satu aplikasi per papan membuat notifikasi kebocoran air terdengar jelas, sementara pemberitahuan baterai tetap tenang.
- **Saluran per perangkat** — Satu aplikasi per ruangan atau perangkat membuat garasi, kulkas, dan rumah kaca tetap terpisah di saluran masing-masing.
- **Petakan payload Anda sendiri** — Pemetaan field GJSON mengambil nama sensor dan nilainya dari JSON yang sudah dikirim firmware Anda.
- **Bekerja dengan pengaturan Anda** — Arduino, MicroPython, curl di Pi, otomasi Home Assistant, atau alur Node-RED semuanya terhubung ke endpoint yang sama.
- **Pengiriman di bawah satu detik** — Saat ambang batas terlampaui, push notification sampai dalam bawah satu detik, sebelum kebocoran menyebar atau freezer mencair.

## Hubungkan sensor

### 1. Buat kunci API

Buat kunci di halaman [API Keys](https://pocketalert.app/id/account/apikeys). Papan Anda mengirimkannya di header `Token` pada setiap POST ke API pesan.

### 2. Kirim POST saat ambang batas terlampaui

```
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. Pada ESP32 atau 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. Atau dari 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 }}"}'
```

Panggil `rest_command.pocketalert` dari otomasi, atau hubungkan alur MQTT-ke-REST di Node-RED. Baca [dokumentasi](https://info.pocketalert.app/getting-started.html) untuk referensi lengkap API pesan.

## FAQ

### Bagaimana cara mengirim notifikasi dari sensor?

Papan Anda mengirim satu HTTP POST ke API pesan saat pembacaan melewati ambang batas. Pada ESP32 atau ESP8266, itu hanya beberapa baris Arduino dengan HTTPClient atau MicroPython; pada Raspberry Pi, cukup satu curl. Payload berisi judul dan pesan, dengan kunci API di header Token.

### Apakah saya perlu MQTT atau broker?

Panggilan HTTPS biasa muat di ESP32 dengan memori yang masih tersisa. Tidak perlu broker MQTT dan tidak perlu kontainer jembatan yang harus dijaga. rest_command Home Assistant dan Node-RED tetap bisa dipakai jika Anda sudah menjalankannya.

### Bisakah pembacaan mendesak dibedakan dari yang rutin?

Beri setiap papan aplikasinya sendiri agar freezer, rumah kaca, dan sensor kebocoran masuk ke saluran terpisah. Tulis judulnya agar kebocoran air terbaca jelas sekilas, sementara pemberitahuan baterai lemah tetap tenang di aplikasinya sendiri.

### Bagaimana cara memisahkan ruangan dan perangkat?

Buat satu aplikasi per ruangan atau perangkat. Garasi, kulkas, dan rumah kaca masing-masing masuk ke salurannya sendiri, sehingga Anda bisa membaca notifikasi tanpa perlu memicingkan mata untuk melihat papan mana yang mengirimnya.

### Bisakah membaca payload sensor saya yang sudah ada?

Arahkan pemetaan field GJSON ke kunci yang sudah dikirim firmware Anda. Nama sensor dan nilai pembacaan langsung masuk ke judul dan pesan tanpa perlu mengubah struktur JSON di papan.

### Apakah notifikasi kebocoran air tetap masuk saat Jangan Ganggu aktif di malam hari?

Bisa. Tambahkan "level":"critical" ke POST dan Android akan mengirimkannya melalui saluran notifikasi khusus yang melewati Jangan Ganggu. Anda hanya perlu memberi izin akses DND sekali. Di iPhone, level high dan critical dikirim sebagai notifikasi sensitif waktu yang tembus mode Fokus. Untuk pemberitahuan baterai lemah, kirim sebagai level silent: tanpa suara atau getaran, notifikasi hanya tersimpan di riwayat. Di paket gratis, critical dikirim sebagai high: tetap instan, tetapi tanpa penembusan Jangan Ganggu.
