Назад в блог

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

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 и пусть дом сообщит вам, когда вы нужны.

Поделиться статьёй