rest_command で Home Assistant のプッシュ通知:漏水・洗濯機・玄関ドア

Home Assistant Companion アプリは、Home Assistant を運用している人にとっては通知が便利です。ただ、地下室の漏水を知るべき人が、アプリを入れていないパートナーや親、合鍵を預けている近所の人だと扱いにくくなります。プッシュ通知を 1 件受け取るためだけに Home Assistant のアカウントを渡すのは、必要以上のアクセス権を与えることになります。
また、ノイズの問題もあります。「洗濯が終わりました」と「浴室の床に水が溜まっています」が同じように聞こえてはいけません。サーバーのアラートが別のアプリ経由で届いているなら、確認すべきフィードが 2 つになってしまいます。
このガイドでは、Home Assistant の rest_command を使って Pocket Alert 経由でプッシュ通知を送ります。アドオンやカスタムインテグレーションは不要で、3 つの自動化を扱います。critical レベルの漏水、low レベルの洗濯完了、そして誰もいないときに開いた玄関ドアです。
必要なもの
configuration.yamlにアクセスできる Home Assistant(File editor、Studio Code Server アドオン、または SSH)。- Pocket Alert のアカウント、API キー、そしてアラートを受け取るスマホに入れたアプリ(iPhone または Android)。無料プランでは、1 台のデバイスに 1 日 50 件までのメッセージを送れます。
rest_command
キーを configuration.yaml と同じフォルダーにある secrets.yaml に書きます。
pocketalert_token: "YOUR_API_KEY"
次に、configuration.yaml にコマンドを 1 つ追加します。
rest_command:
pocketalert:
url: https://api.pocketalert.app/v1/messages
method: post
content_type: application/json
timeout: 10
headers:
Token: !secret pocketalert_token
payload: >-
{% set body = {"title": title, "message": message,
"level": level | default("default")} %}
{% if button_url is defined %}
{% set req = {"url": button_url, "method": "POST"} | to_json %}
{% set body = dict(body, actions=[{"type": "http",
"label": button_label | default("Run"), "value": req}]) %}
{% endif %}
{{ body | to_json }}
Home Assistant を再起動します。これで rest_command.pocketalert というアクションが使えるようになります。data に渡した値はテンプレート変数になります。title、message、省略可能な level、そして省略可能なボタンです。
JSON を手で書かず to_json で組み立てるのはなぜでしょうか。センサー名に引用符が含まれていると、手書きの文字列は壊れてしまいます。to_json ならエスケープを自動で行ってくれます。Pocket Alert API は JSON しか受け付けないため、content_type も指定しています。これがないと、JSON の Content-Type なしでリクエストが送られてしまいます。
開発者ツール → アクション からテストします。rest_command.pocketalert を選び、YAML モードに切り替えて次を実行してください。
action: rest_command.pocketalert
data:
title: "Hello from Home Assistant"
message: "rest_command works"
1〜2 秒以内にプッシュ通知が届くはずです。
3 つの自動化
自動化エディター(YAML で編集)または automations.yaml に追加します。エンティティ ID はご自身の環境のものに置き換えてください。
漏水:critical
alias: "Leak under the sink"
triggers:
- trigger: state
entity_id: binary_sensor.kitchen_leak
to: "on"
actions:
- action: rest_command.pocketalert
data:
title: "Water leak: kitchen"
message: "The sensor under the sink is wet. Check it now."
level: critical
critical は朝まで待てないことに使うレベルです。iPhone では消音スイッチとおやすみモードを越えて、専用の音量で鳴ります。Android では、おやすみモードを無視して画面を占有する専用チャンネルを使います。critical は有料プランで使えます。無料プランでは同じメッセージが high として届きます。high は集中モードは通過しますが、消音スイッチは通過しません。
洗濯完了:low
「洗濯が終わりました」というセンサーはありませんが、電力計測機能付きのスマートプラグで代用できます。消費電力が数分間数ワット未満のままなら、運転が終わったと判断できます。
alias: "Washer finished"
triggers:
- trigger: numeric_state
entity_id: sensor.washer_plug_power
below: 5
for: "00:03:00"
actions:
- action: rest_command.pocketalert
data:
title: "Washer finished"
message: "Laundry is ready to hang."
level: low
low は音もなく、割り込みもなく届きます。スマホを見たときに一覧に出てくる程度で、濡れた洗濯物の緊急度にはちょうど合っています。below と for はお使いの洗濯機に合わせて調整してください。途中で 1〜2 分止まる機種もあります。
誰もいないときに玄関ドアが開いた:high
zone.home の状態はそのゾーン内にいる人数なので、"0" は全員外出中を意味します。
alias: "Front door opened while away"
triggers:
- trigger: state
entity_id: binary_sensor.front_door
to: "on"
conditions:
- condition: state
entity_id: zone.home
state: "0"
actions:
- action: rest_command.pocketalert
data:
title: "Front door opened"
message: "Opened at {{ now().strftime('%H:%M') }} and nobody is home."
level: high
high は iPhone で時間に敏感な通知として扱われ、集中モードや予約された要約も通過します。メッセージの行はテンプレートです。data の値は、コマンドに渡る前に展開されます。
水道バルブを閉じるボタン
漏水のアラートは、その場で操作できると役に立ちます。Pocket Alert の通知には最大 3 つのアクションボタンを付けられます。http ボタンはスマホ自身からリクエストを送ります。Pocket Alert がプロキシするわけではありません。そのため、スマホから到達できる限り、インターネットに公開していない Home Assistant の Webhook も呼び出せます。
まず、Webhook が呼ばれたらバルブを閉じる自動化を作ります。
alias: "Close main water valve (from push)"
triggers:
- trigger: webhook
webhook_id: "close-valve-9f2c41d7a3b8e605"
allowed_methods:
- POST
local_only: true
actions:
- action: valve.close_valve
target:
entity_id: valve.main_water
バルブがスイッチとして表示される場合は、switch.turn_off を使ってください。Webhook ID は長くランダムなものにしてください。Home Assistant の Webhook は、ID を知っていること以外に認証がありません。
次に、漏水の自動化にボタンを追加します。
actions:
- action: rest_command.pocketalert
data:
title: "Water leak: kitchen"
message: "The sensor under the sink is wet."
level: critical
button_label: "Close water valve"
button_url: "https://ha.example.com/api/webhook/close-valve-9f2c41d7a3b8e605"
上の rest_command は button_url を、メソッドが POST の http アクションに変換します。ボタンをタップすると、アプリを開かずにバックグラウンドでスマホがリクエストを送ります。
使う URL は次のとおりです。
- 自宅にいるときだけ: Wi-Fi 上でスマホが Home Assistant に到達するアドレスです。
local_only: trueによって、Webhook はインターネットからは閉じたままになります。ネットワーク内でhttps://のアドレスが使えるなら、そちらを優先してください。 - どこからでも: 漏水は外出中に起きることが多いものです。Home Assistant のドキュメントによると、
local_onlyの Webhook も Home Assistant Cloud(Nabu Casa)の Webhook 経由で動作します。そのため、クラウドの URL が最も簡単な選択肢です。Tailscale や WireGuard などのスマホ側の VPN を使えば、LAN アドレスでも動作します。
Home Assistant の公式なアドバイスでは、ドアの解錠のような破壊的な操作や危険な操作を Webhook の背後に置かないよう勧めています。水道バルブを閉じるのは安全な方向の操作です。開ける操作は安全ではないため、スマホのボタンには含めないでください。ボタンを 2 回タップすると、リクエストも 2 回送られます。ただし、閉じているバルブをもう一度閉じても何も起きないので、この用途では問題ありません。
ボタンについて知っておくべきことが 2 つあります。アクションボタンは有料プランの機能で、無料プランではメッセージから削除されます。ただし、アラート自体は届きます。また、iOS と Android のどちらでも、Pocket Alert アプリを閉じていても、通知上に設定したラベルが表示されます(バージョン 2.0.1 以降)。ボタンはメッセージと一緒にアプリに保存されるため、バナーが消えた後でもタップできます。
Home Assistant を持たない人へのアラート
プッシュ通知を受け取る人に必要なのは Pocket Alert アプリだけです。設定方法は 2 通りあります。
- 本人のアカウント。 本人が無料で新規登録し、API キーを作って渡してもらいます。
secrets.yamlにそのキーを書いた 2 つ目のコマンドpocketalert_familyを追加し、漏水の自動化で両方のコマンドを呼び出します。サーバーのアラートはご自身のアカウントに残り、本人には送ったものだけが見えます。 - ご自身のアカウントにある 2 台目のデバイス。 有料プランでは複数のデバイスを登録できます。本人のスマホを追加し、コマンドのコピーを作って
bodyの辞書に"device_id": "THEIR_DEVICE_ID"を加えます。そうすれば、家族向けのアラートだけが本人のスマホに届きます。
どちらの方法でも、本人は Home Assistant のアカウントを持たずに、同じレベルとボタン付きの漏水アラートを受け取れます。
家とそれ以外を 1 つのアプリで
同じ API キーは、cron ジョブ、バックアップ、稼働監視、CI でも使えます。ホームラボを運用しているなら、Proxmox、NAS、バックアップのアラートも漏水センサーと同じフィードに届きます。それぞれにレベルを設定でき、アプリではレベルでフィードを絞り込めるので、40 件の中から重要な 2 件を簡単に見つけられます。ESP32 ボード、Raspberry Pi、Node-RED などの他のセンサーについては、IoT とセンサーのアラートをご覧ください。
JSON の Webhook しか送れないデバイスには、コードを書かずに使える方法もあります。コンソールで Webhook を作り、ペイロードからメッセージをテンプレートで組み立ててください。詳しくは Webhook からプッシュ通知をご覧ください。
notify アクションとしての RESTful Notifications
notify.* アクションを使いたい場合は、Home Assistant の RESTful Notifications プラットフォームでも Pocket Alert に送信できます。
notify:
- name: pocketalert
platform: rest
resource: https://api.pocketalert.app/v1/messages
method: POST_JSON
title_param_name: title
headers:
Token: !secret pocketalert_token
data:
level: high
POST_JSON は JSON ボディを送ります。title_param_name は通知のタイトルを title フィールドに対応付けます。data には固定のフィールドを追加します。action: notify.pocketalert で呼び出し、title と message を指定してください。レベルは通知先ごとに固定されるため、複数のレベルが必要なら通知先をレベルごとに作ってください。ボタンも扱いたい場合は、rest_command を使うのが便利です。
何も届かないとき
- ログを確認します。
rest_commandはリクエストに失敗すると、ステータスコード付きの警告をログに出力します。401はsecrets.yamlのキーが間違っていることを示します。400は通常、ペイロードが有効な JSON ではないことを示します。 - 初回は再起動します。 最初の
rest_commandブロックは、アクションが表示されるまで Home Assistant の再起動が必要です。その後の編集はrest_command.reloadアクションで読み込めます。 - 開発者ツールからアクションを手動で実行します。 これでうまくいくなら、問題は自動化のトリガーか条件にあります。トレースを確認してください。
- ボタンが反応しないとき: スマホのブラウザで Webhook URL のホストを開いてみてください。スマホがそのアドレスの Home Assistant に到達できないなら、ボタンも届きません。
- 本日の上限を確認します。 無料プランは 1 日 50 件で止まります。頻繁に発報するセンサーがあると、すぐに上限に達します。トリガーに
for:を設定すると改善します。
よくある質問
Home Assistant Companion アプリは必要ですか?
いいえ。プッシュ通知は Pocket Alert から届くため、スマホには Pocket Alert アプリだけあれば十分です。センサーや位置情報の機能のために、Companion アプリを引き続き使うこともできます。
Home Assistant Cloud でも使えますか?
はい。rest_command は Home Assistant から Pocket Alert API を直接呼び出すので、Nabu Casa に依存しません。Home Assistant Cloud が役立つのは、外出先からバルブのボタンを使うときだけです。
漏水のアラートで夜中に起こされることはありますか?
critical なら、はい。iPhone では消音スイッチを越えて鳴り、Android ではおやすみモードを越えて鳴ります。このレベルは有料プランが必要です。無料プランでは high として届きます。
API キーが漏れることはありますか?
キーは secrets.yaml に保存され、HTTPS 経由で Token ヘッダーに含めて送信されます。Home Assistant 用には別のキーを使うと、他のスクリプトに影響を与えずに無効化できます。
無料アカウントを作成して rest_command を 1 つ追加すれば、家があなたを必要としたときに知らせてくれます。