# Push-уведомления из Home Assistant через rest_command: протечка, стиральная машина, дверь

> Отправляйте оповещения Home Assistant на любой телефон одной командой rest_command: уровни важности от critical до low и кнопка, которая закрывает водяной кран прямо из уведомления.

*23.10.2026*

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

Приложение Home Assistant Companion хорошо справляется с уведомлениями для тех, кто сам управляет Home Assistant. Но неудобно становится, когда о протечке в подвале должен узнать партнёр, который его не устанавливал, родитель или сосед с запасным ключом. Заводить им аккаунт Home Assistant ради одного push-уведомления — это больше доступа, чем нужно.

Есть и проблема шума. «Стиральная машина закончила» и «вода на полу в ванной» не должны звучать одинаково, а если серверные оповещения уже идут через другое приложение, вам придётся проверять две ленты.

В этом руководстве используется `rest_command` в Home Assistant, чтобы отправлять push-уведомления через Pocket Alert. Не нужны ни аддоны, ни пользовательские интеграции. Мы разберём три автоматизации: протечка воды с уровнем critical, завершённая стирка с уровнем low и открытая дверь, когда дома никого нет.

## Что понадобится

- Home Assistant с доступом к `configuration.yaml` (редактор файлов или аддон Studio Code Server, либо SSH).
- Аккаунт Pocket Alert, API-ключ из раздела [API-ключи](/account/apikeys) и приложение на телефоне, который должен получать оповещения: [iPhone или Android](/get-app). Бесплатный тариф включает 50 сообщений в день на одно устройство.

## rest_command

Добавьте ключ в `secrets.yaml` в той же папке, что и `configuration.yaml`:

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

Затем добавьте одну команду в `configuration.yaml`:

```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` экранирует её сам. API Pocket Alert принимает только JSON, поэтому `content_type` задан явно: без него запрос уйдёт без заголовка JSON.

Проверьте команду в **Инструменты разработчика → Действия**: выберите `rest_command.pocketalert`, переключитесь в режим YAML и выполните:

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

Push-уведомление должно прийти в течение секунды-двух.

## Три автоматизации

Добавьте их в редакторе автоматизаций (**Редактировать в YAML**) или в `automations.yaml`. Замените идентификаторы объектов на свои.

### Протечка воды: 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`, которое проходит через «Фокусирование», но не через беззвучный режим.

### Стирка завершена: 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` под свою машину: некоторые стиральные машины на несколько минут останавливаются посреди цикла.

### Дверь открыта, когда никого нет дома: 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` обрабатываются до того, как попадут в команду.

## Кнопка, которая закрывает водяной кран

Оповещение о протечке полезнее, когда на него можно ответить действием. Push-уведомления Pocket Alert могут содержать до трёх [кнопок действий](/features/action-buttons), а кнопка типа `http` отправляет запрос **непосредственно с телефона**. Pocket Alert его не проксирует. Значит, кнопка может вызывать вебхук Home Assistant, который не открыт в интернет, при условии что телефон до него достучится.

Сначала создайте автоматизацию, которая закрывает кран при вызове своего вебхука:

```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`. Сделайте ID вебхука длинным и случайным: у вебхуков Home Assistant нет никакой аутентификации, кроме знания этого 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` в действие `http` с методом POST. Когда вы нажимаете кнопку, телефон отправляет запрос в фоне, не открывая приложение.

Какой URL использовать:

- **Только дома:** адрес, по которому телефон обращается к Home Assistant в вашей Wi-Fi-сети. `local_only: true` не даёт вебхуку быть доступным из интернета. Если в сети есть `https://`-адрес, лучше использовать его.
- **Из любого места:** протечка обычно случается, когда вы не дома. В документации Home Assistant сказано, что вебхуки с `local_only` продолжают работать через облачные вебхуки Home Assistant Cloud (Nabu Casa), поэтому этот облачный URL — самый простой вариант. VPN на телефоне, например Tailscale или WireGuard, тоже работает с локальным адресом.

Home Assistant не рекомендует выводить через вебхуки деструктивные или небезопасные действия, например открытие замка. Закрытие водяного крана — безопасное направление; открытие — нет, поэтому не выводите такую кнопку на телефон. Повторное нажатие отправит второй запрос, и это безвредно: закрытый кран повторно закрыть не страшно.

Два момента о кнопках. Они доступны только на платных тарифах и удаляются из сообщений на бесплатном тарифе; само оповещение при этом приходит. Кроме того, и iOS, и Android показывают ваш собственный текст кнопки прямо в уведомлении, даже когда приложение Pocket Alert закрыто (версия 2.0.1 или новее). Кнопки также сохраняются вместе с сообщением в приложении, поэтому вы сможете нажать их, даже когда баннер уже исчез.

## Оповещения для тех, у кого нет Home Assistant

Человеку, который получает push-уведомление, нужно только приложение Pocket Alert. Есть два способа это настроить:

- **Собственный аккаунт.** Он регистрируется бесплатно, создаёт API-ключ и передаёт его вам. Добавьте вторую команду `pocketalert_family` с его ключом в `secrets.yaml` и вызывайте обе команды в автоматизации протечки. Серверные оповещения останутся в вашем аккаунте; ему приходит только то, что вы отправляете.
- **Второе устройство в вашем аккаунте.** Платные тарифы включают несколько устройств. Добавьте телефон, затем сделайте копию команды с `"device_id": "THEIR_DEVICE_ID"`, добавленным в словарь `body`, чтобы оповещения для домохозяйства уходили только на него.

В любом случае человек получит оповещение о протечке с тем же уровнем и кнопкой, без аккаунта в вашем Home Assistant.

## Одно приложение для дома и всего остального

Тот же API-ключ работает для cron-задач, бэкапов, проверок доступности и CI. Если у вас домашняя лаборатория, [оповещения от Proxmox, NAS и бэкапов](/use-cases/homelab-alerts) попадают в ту же ленту, что и датчик протечки, каждое со своим уровнем. Приложение умеет фильтровать ленту по уровню, поэтому два важных оповещения легко найти среди сорока. Для других датчиков (плат ESP32, Raspberry Pi, Node-RED) см. [оповещения от IoT и датчиков](/use-cases/iot-sensor-alerts).

Для устройств, которые умеют отправлять только JSON-вебхук, есть вариант без кода: создайте вебхук в [консоли](/webhooks) и соберите текст сообщения из полезной нагрузки. См. [Webhook в push](/tools/webhook).

## RESTful Notifications как действие notify

Если вы предпочитаете действия `notify.*`, платформа RESTful Notifications в Home Assistant тоже может отправлять в 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`.
- **Выполните действие вручную** из Инструментов разработчика. Если это работает, проблема в триггере или условии автоматизации; проверьте её трассировку.
- **Кнопка ничего не делает:** откройте хост URL вебхука в браузере телефона. Если телефон не может достучаться до Home Assistant по этому адресу, не сможет и кнопка.
- **Проверьте дневной лимит.** Бесплатный тариф ограничен 50 сообщениями в день, и один болтливый датчик может исчерпать его. Параметр `for:` в триггере помогает.

## FAQ

### Нужно ли приложение Home Assistant Companion?

Нет. Push-уведомление приходит от Pocket Alert, поэтому телефону нужно только приложение Pocket Alert. Приложение Companion можно оставить для датчиков и отслеживания местоположения.

### Работает ли это с Home Assistant Cloud?

Да. `rest_command` обращается к API Pocket Alert напрямую из вашего Home Assistant, поэтому не зависит от Nabu Casa. Home Assistant Cloud нужен только для кнопки крана, когда вы не дома.

### Может ли оповещение о протечке разбудить меня ночью?

На уровне `critical` — да: на iPhone оно звучит в обход беззвучного режима, на Android — в обход «Не беспокоить». Этот уровень требует платного тарифа; на бесплатном тарифе оно приходит как `high`.

### Не раскрыт ли мой API-ключ?

Он хранится в `secrets.yaml` и передаётся в заголовке `Token` по HTTPS. Используйте отдельный ключ для Home Assistant, чтобы его можно было отозвать, не трогая остальные скрипты.

[Создайте бесплатный аккаунт](/signup), добавьте одну команду `rest_command` и пусть дом сообщит вам, когда вы нужны.
