どのセンサーからもプッシュ通知
センサーの配線はご自身で行えます。HTTP を 1 回呼び出すだけで、監視用のスタックを挟まずにしきい値の通知をスマホへ届けられます。
マイコンに収まる軽さ
プレーンな HTTP POST なら、ESP32 や ESP8266 でも余裕を残して動作します。ブローカーもブリッジも不要です。
センサーごとのチャンネル
ボードごとにアプリケーションを分けると、漏水の通知は大きく目立ち、電池残量の通知は落ち着いて届きます。
デバイスごとのチャンネル
部屋やデバイスごとにアプリケーションを分けると、ガレージ、冷蔵庫、温室の通知を別々のチャンネルで管理できます。
独自のペイロードに対応
GJSON のフィールドマッピングで、ファームウェアがすでに送信している JSON からセンサー名と値を取り出せます。
お使いの環境に合わせて利用可能
Arduino、MicroPython、Pi の curl、Home Assistant のオートメーション、Node-RED のフローのいずれからも、同じエンドポイントに送信できます。
1 秒以内に配信
しきい値を超えると 1 秒以内にプッシュ通知が届くため、漏水が広がったり冷凍庫が解凍されたりする前に気づけます。
センサー通知までの 3 ステップ
トークンまたは URL を取得
API キーを作成するか、部屋やデバイスごとのアプリケーション Webhook URL をコピーします。
しきい値で送信
Arduino の HTTPClient スケッチ、MicroPython スクリプト、Pi の cron ジョブ、HA の rest_command に POST を追加します。
スマホで確認
センサーを作動させると、そのボード用のアプリケーションで 1 秒以内にスマホが振動します。
センサーを接続する
1. API キーを作成する
API キーページでキーを作成します。ボードは、メッセージ 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 の詳細はドキュメントをご覧ください。
よくある質問
値がしきい値を超えたら、ボードからメッセージ API へ HTTP POST を 1 回送るだけです。ESP32 や ESP8266 なら HTTPClient を使った数行の Arduino コード、MicroPython でも実装できます。Raspberry Pi なら curl で送信できます。ペイロードにはタイトルとメッセージを含め、API キーは Token ヘッダーで渡します。
通常の HTTPS 呼び出しなら、ESP32 でも十分なメモリ余裕を残して動作します。MQTT ブローカーや、管理が必要なブリッジ用コンテナは不要です。すでに Home Assistant の rest_command や Node-RED を使っている場合は、そのまま利用できます。
ボードごとにアプリケーションを分けると、冷凍庫、温室、漏水センサーの通知をそれぞれ別のチャンネルで受け取れます。漏水はひと目で緊急と分かるタイトルにし、電池残量の通知は別のアプリで落ち着いて届くようにしておくとよいでしょう。
部屋やデバイスごとにアプリケーションを 1 つずつ作成します。ガレージ、冷蔵庫、温室の通知はそれぞれ別のチャンネルに届くため、どのボードからの通知か目を凝らして確認する必要はありません。
GJSON のフィールドマッピングで、ファームウェアがすでに送信しているキーを指定できます。センサー名と値は、ボード側で JSON を組み替えることなく、そのままタイトルとメッセージに入ります。
はい。POST に "level":"critical" を追加すると、Android では専用の通知チャンネルで届き、おやすみモードを無視します。おやすみモードの許可は一度だけ設定が必要です。iPhone では high と critical が時間依存の通知として届き、集中モードも貫通します。電池残量の通知は level を silent にすると、音もバイブレーションもなく履歴に残るだけになります。無料プランでは critical は high として届きます。すぐに届く点は変わりませんが、おやすみモードの無視はされません。