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

> 1 つの rest_command で Home Assistant のアラートをどのスマホにも送信。critical から low までの優先度と、通知から水道バルブを閉じるボタンを紹介します。

*23.10.2026*

<!-- source: https://pocketalert.app/ja/blog/home-assistant-push-notifications -->

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 キー](/account/apikeys)、そしてアラートを受け取るスマホに入れたアプリ（[iPhone または Android](/get-app)）。無料プランでは、1 台のデバイスに 1 日 50 件までのメッセージを送れます。

## rest_command

キーを `configuration.yaml` と同じフォルダーにある `secrets.yaml` に書きます。

```yaml
pocketalert_token: "YOUR_API_KEY"
```

次に、`configuration.yaml` にコマンドを 1 つ追加します。

```yaml
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 モードに切り替えて次を実行してください。

```yaml
action: rest_command.pocketalert
data:
  title: "Hello from Home Assistant"
  message: "rest_command works"
```

1〜2 秒以内にプッシュ通知が届くはずです。

## 3 つの自動化

自動化エディター（**YAML で編集**）または `automations.yaml` に追加します。エンティティ ID はご自身の環境のものに置き換えてください。

### 漏水：critical

```yaml
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

「洗濯が終わりました」というセンサーはありませんが、電力計測機能付きのスマートプラグで代用できます。消費電力が数分間数ワット未満のままなら、運転が終わったと判断できます。

```yaml
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"` は全員外出中を意味します。

```yaml
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 つの[アクションボタン](/features/action-buttons)を付けられます。`http` ボタンは**スマホ自身から**リクエストを送ります。Pocket Alert がプロキシするわけではありません。そのため、スマホから到達できる限り、インターネットに公開していない Home Assistant の Webhook も呼び出せます。

まず、Webhook が呼ばれたらバルブを閉じる自動化を作ります。

```yaml
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 を知っていること以外に認証がありません。

次に、漏水の自動化にボタンを追加します。

```yaml
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、バックアップのアラート](/use-cases/homelab-alerts)も漏水センサーと同じフィードに届きます。それぞれにレベルを設定でき、アプリではレベルでフィードを絞り込めるので、40 件の中から重要な 2 件を簡単に見つけられます。ESP32 ボード、Raspberry Pi、Node-RED などの他のセンサーについては、[IoT とセンサーのアラート](/use-cases/iot-sensor-alerts)をご覧ください。

JSON の Webhook しか送れないデバイスには、コードを書かずに使える方法もあります。[コンソール](/webhooks)で Webhook を作り、ペイロードからメッセージをテンプレートで組み立ててください。詳しくは [Webhook からプッシュ通知](/tools/webhook)をご覧ください。

## notify アクションとしての RESTful Notifications

`notify.*` アクションを使いたい場合は、Home Assistant の RESTful Notifications プラットフォームでも Pocket Alert に送信できます。

```yaml
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 用には別のキーを使うと、他のスクリプトに影響を与えずに無効化できます。

[無料アカウントを作成](/signup)して `rest_command` を 1 つ追加すれば、家があなたを必要としたときに知らせてくれます。
