# 数値がしきい値を超えたとき にお知らせします。

> IoT センサーの通知をスマホで受け取れます。ESP32、Raspberry Pi、Home Assistant から、しきい値を超えたときに Pocket Alert へ HTTP POST を 1 回送るだけ。MQTT ブローカーは不要です。

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

最終更新日:2026-08-11

温度、湿度、漏水、人感、ドア、電源、バッテリーのセンサーが、しきい値を超えたときの数値をスマホで受け取れます。ESP32、Raspberry Pi、Home Assistant、Node-RED のいずれにも対応しています。ブローカーや MQTT ブリッジは不要です。

## センサー通知までの 3 ステップ

1. **トークンまたは URL を取得** — API キーを作成するか、部屋やデバイスごとのアプリケーション Webhook URL をコピーします。
2. **しきい値で送信** — Arduino の HTTPClient スケッチ、MicroPython スクリプト、Pi の cron ジョブ、HA の rest_command に POST を追加します。
3. **スマホで確認** — センサーを作動させると、そのボード用のアプリケーションで 1 秒以内にスマホが振動します。

## どのセンサーからもプッシュ通知

センサーの配線はご自身で行えます。HTTP を 1 回呼び出すだけで、監視用のスタックを挟まずにしきい値の通知をスマホへ届けられます。

- **マイコンに収まる軽さ** — プレーンな HTTP POST なら、ESP32 や ESP8266 でも余裕を残して動作します。ブローカーもブリッジも不要です。
- **センサーごとのチャンネル** — ボードごとにアプリケーションを分けると、漏水の通知は大きく目立ち、電池残量の通知は落ち着いて届きます。
- **デバイスごとのチャンネル** — 部屋やデバイスごとにアプリケーションを分けると、ガレージ、冷蔵庫、温室の通知を別々のチャンネルで管理できます。
- **独自のペイロードに対応** — GJSON のフィールドマッピングで、ファームウェアがすでに送信している JSON からセンサー名と値を取り出せます。
- **お使いの環境に合わせて利用可能** — Arduino、MicroPython、Pi の curl、Home Assistant のオートメーション、Node-RED のフローのいずれからも、同じエンドポイントに送信できます。
- **1 秒以内に配信** — しきい値を超えると 1 秒以内にプッシュ通知が届くため、漏水が広がったり冷凍庫が解凍されたりする前に気づけます。

## センサーを接続する

### 1. API キーを作成する

[API キー](https://pocketalert.app/ja/account/apikeys)ページでキーを作成します。ボードは、メッセージ API への POST のたびに `Token` ヘッダーでこのキーを送信します。

### 2. しきい値を超えたら POST する

```
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. ESP32 または 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. 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 }}"}'
```

オートメーションから `rest_command.pocketalert` を呼び出すか、Node-RED で MQTT から REST へのフローを構成します。メッセージ API の詳細は[ドキュメント](https://info.pocketalert.app/getting-started.html)をご覧ください。

## よくある質問

### センサーからプッシュ通知を送るにはどうすればよいですか？

値がしきい値を超えたら、ボードからメッセージ API へ HTTP POST を 1 回送るだけです。ESP32 や ESP8266 なら HTTPClient を使った数行の Arduino コード、MicroPython でも実装できます。Raspberry Pi なら curl で送信できます。ペイロードにはタイトルとメッセージを含め、API キーは Token ヘッダーで渡します。

### MQTT やブローカーは必要ですか？

通常の HTTPS 呼び出しなら、ESP32 でも十分なメモリ余裕を残して動作します。MQTT ブローカーや、管理が必要なブリッジ用コンテナは不要です。すでに Home Assistant の rest_command や Node-RED を使っている場合は、そのまま利用できます。

### 緊急の値と通常の値を区別できますか？

ボードごとにアプリケーションを分けると、冷凍庫、温室、漏水センサーの通知をそれぞれ別のチャンネルで受け取れます。漏水はひと目で緊急と分かるタイトルにし、電池残量の通知は別のアプリで落ち着いて届くようにしておくとよいでしょう。

### 部屋やデバイスごとの通知を分けるにはどうすればよいですか？

部屋やデバイスごとにアプリケーションを 1 つずつ作成します。ガレージ、冷蔵庫、温室の通知はそれぞれ別のチャンネルに届くため、どのボードからの通知か目を凝らして確認する必要はありません。

### 既存のセンサーのペイロードをそのまま読み取れますか？

GJSON のフィールドマッピングで、ファームウェアがすでに送信しているキーを指定できます。センサー名と値は、ボード側で JSON を組み替えることなく、そのままタイトルとメッセージに入ります。

### 夜間でも漏水の通知はおやすみモードを突破しますか？

はい。POST に "level":"critical" を追加すると、Android では専用の通知チャンネルで届き、おやすみモードを無視します。おやすみモードの許可は一度だけ設定が必要です。iPhone では high と critical が時間依存の通知として届き、集中モードも貫通します。電池残量の通知は level を silent にすると、音もバイブレーションもなく履歴に残るだけになります。無料プランでは critical は high として届きます。すぐに届く点は変わりませんが、おやすみモードの無視はされません。
