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

Приложение 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-ключи и приложение на телефоне, который должен получать оповещения: iPhone или Android. Бесплатный тариф включает 50 сообщений в день на одно устройство.
rest_command
Добавьте ключ в secrets.yaml в той же папке, что и configuration.yaml:
pocketalert_token: "YOUR_API_KEY"
Затем добавьте одну команду в configuration.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 и выполните:
action: rest_command.pocketalert
data:
title: "Hello from Home Assistant"
message: "rest_command works"
Push-уведомление должно прийти в течение секунды-двух.
Три автоматизации
Добавьте их в редакторе автоматизаций (Редактировать в YAML) или в automations.yaml. Замените идентификаторы объектов на свои.
Протечка воды: 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, которое проходит через «Фокусирование», но не через беззвучный режим.
Стирка завершена: 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 под свою машину: некоторые стиральные машины на несколько минут останавливаются посреди цикла.
Дверь открыта, когда никого нет дома: 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 обрабатываются до того, как попадут в команду.
Кнопка, которая закрывает водяной кран
Оповещение о протечке полезнее, когда на него можно ответить действием. Push-уведомления Pocket Alert могут содержать до трёх кнопок действий, а кнопка типа http отправляет запрос непосредственно с телефона. Pocket Alert его не проксирует. Значит, кнопка может вызывать вебхук Home Assistant, который не открыт в интернет, при условии что телефон до него достучится.
Сначала создайте автоматизацию, которая закрывает кран при вызове своего вебхука:
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.
Затем добавьте кнопку в автоматизацию протечки:
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 и бэкапов попадают в ту же ленту, что и датчик протечки, каждое со своим уровнем. Приложение умеет фильтровать ленту по уровню, поэтому два важных оповещения легко найти среди сорока. Для других датчиков (плат ESP32, Raspberry Pi, Node-RED) см. оповещения от IoT и датчиков.
Для устройств, которые умеют отправлять только JSON-вебхук, есть вариант без кода: создайте вебхук в консоли и соберите текст сообщения из полезной нагрузки. См. Webhook в push.
RESTful Notifications как действие notify
Если вы предпочитаете действия notify.*, платформа RESTful Notifications в Home Assistant тоже может отправлять в 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. - Выполните действие вручную из Инструментов разработчика. Если это работает, проблема в триггере или условии автоматизации; проверьте её трассировку.
- Кнопка ничего не делает: откройте хост 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, чтобы его можно было отозвать, не трогая остальные скрипты.
Создайте бесплатный аккаунт, добавьте одну команду rest_command и пусть дом сообщит вам, когда вы нужны.