Уведомления Home Assistant в Telegram и MAX: настройка и грабли

Уведомления Home Assistant — то, ради чего многие и заводят умный дом: протечка, открытая дверь, отключение электричества, датчик, у которого села батарейка. Но уведомление, которое не пришло, хуже, чем никакого: вы уверены, что дом под присмотром, а он молчит. У нас так четыре автоматизации-сторожа неизвестно сколько времени «отправляли» оповещения в пустоту. Ниже — как настроить уведомления Home Assistant в Telegram, как отправлять сообщения в MAX через его API и как проверить, что оповещения действительно доходят.

Уведомления Home Assistant в Telegram и MAX
Иллюстрация: оповещения умного дома на телефоне

Какие бывают уведомления Home Assistant

  • Приложение Home Assistant на телефоне — push-уведомления через интеграцию Mobile App. Самый простой вариант, если телефон и Home Assistant «видят» друг друга.
  • Мессенджер — бот в Telegram или MAX. Удобно, когда оповещения нужны нескольким людям или в общий семейный чат.
  • Почта, голосовые колонки, лампы, мигающие красным — для особых случаев.

Ниже — про мессенджеры: у нас все оповещения идут в Telegram, а MAX разберём по документации.

Home Assistant и Telegram: настройка

По документации интеграции Telegram bot, сначала нужно создать бота в Telegram и получить его токен, затем добавить интеграцию в Настройки → Устройства и службы и указать, в какие чаты бот может писать. Режим работы выбирается при настройке:

  • только отправка — Home Assistant лишь шлёт сообщения, доступ к нему из интернета не нужен;
  • polling — бот ещё и принимает команды, опрашивая Telegram; открывать Home Assistant в интернет тоже не нужно;
  • webhooks — Telegram сам присылает обновления на ваш сервер; для этого Home Assistant должен быть доступен из интернета по HTTPS.

Для простых оповещений хватает первого варианта. У нас бот настроен через интерфейс, и рабочий вызов в автоматизации выглядит так:

- action: telegram_bot.send_message
  continue_on_error: true
  data:
    entity_id: notify.<получатель>
    message: >-
      Протечка на кухне!

Документация также предлагает универсальное действие notify.send_message с сущностью чата — оно работает так же и удобно, если позже захочется сменить способ доставки.

Грабля: notify молчит впустую

Самая неприятная ошибка с уведомлениями — та, которую не видно. Наша история:

  1. Бот Telegram у нас настроен через интерфейс, а старый блок notify: в configuration.yaml закомментирован.
  2. Четыре автоматизации-сторожа продолжали вызывать notify.notify — общее действие «уведомить кого-нибудь».
  3. Вызов не падал с ошибкой. Сообщение просто уходило в никуда: автоматизация честно срабатывала и показывала время последнего запуска, а в журнале было тихо — логгер Telegram у нас приглушён до уровня warning.

Сколько времени сторожа молчали — неизвестно. Вылечили переводом всех вызовов на явное telegram_bot.send_message с конкретным получателем и боевым прогоном каждой автоматизации: запустили вручную и убедились, что сообщение пришло в телефон.

Вывод: не используйте в важных автоматизациях общее notify.notify — указывайте конкретный способ доставки и получателя. А после любых изменений в уведомлениях проверяйте доставку глазами, а не по «last triggered».

Вторая грабля: уведомление перед действием

Если поставить отправку сообщения перед основным действием — например, «написать, что включаем насос» и потом «включить насос», — то при сбое отправки (нет связи с мессенджером, бот удалён) автоматизация оборвётся и насос не включится. Поэтому у нас у всех уведомлений стоит continue_on_error: true, как в примере выше: даже если сообщение не ушло, автоматизация доделает главное.

Уведомления Home Assistant в MAX

Сразу оговоримся: из нашего Home Assistant в MAX мы не шлём, раздел — по документации MAX и Home Assistant, без проверки на практике.

Готовой интеграции MAX в Home Assistant нет, но у мессенджера есть открытый API для ботов. Отправить сообщение можно через встроенную интеграцию RESTful Command, которая делает HTTP-запрос по команде из автоматизации.

По документации API MAX:

  • сообщения отправляются запросом POST https://platform-api2.max.ru/messages с параметром chat_id (группа) или user_id (личный чат);
  • токен бота передаётся в заголовке Authorization без слова Bearer — просто сам токен; передача токена в адресе больше не поддерживается;
  • текст — до 4000 символов, не чаще двух сообщений в секунду в один чат;
  • документация просит добавить сертификат Минцифры в доверенные.

Набросок для configuration.yaml по этим правилам (токен — в secrets.yaml):

rest_command:
  max_notify:
    url: "https://platform-api2.max.ru/messages?chat_id={{ chat_id }}"
    method: post
    headers:
      Authorization: !secret max_bot_token
    content_type: "application/json"
    payload: '{"text": "{{ message }}"}'

и вызов в автоматизации:

- action: rest_command.max_notify
  continue_on_error: true
  data:
    chat_id: "<ID чата>"
    message: "Протечка на кухне!"

Как узнать ID чата и как создать самого бота, описано в документации MAX. Если запрос падает с ошибкой проверки сертификата, причина, скорее всего, в том самом сертификате Минцифры: Home Assistant ему по умолчанию не доверяет. Отключать проверку параметром verify_ssl: false не советуем — так теряется защита соединения с токеном бота. Похожую историю с сертификатом мы разбирали в статье про GigaChat API.

Как проверить, что уведомления доходят

  • Боевой прогон. Запустите автоматизацию вручную из её меню и убедитесь, что сообщение пришло на телефон. Не доверяйте отметке о последнем запуске.
  • Отдельная проверка раз в неделю. Простая автоматизация, которая в воскресенье утром присылает «Сторож на связи». Не пришло — пора разбираться.
  • Журнал. Не приглушайте логгер мессенджера сильнее warning, пока не убедились, что всё работает.
  • Резервный канал. Для самого важного — протечка, пожар, отключение света — дублируйте оповещение двумя способами: в мессенджер и push в приложение.

Если Home Assistant ещё не стоит, начните со статьи установка Home Assistant, а датчики подключите по статье Zigbee2MQTT или ZHA.

Источники: Home Assistant: Telegram bot, Home Assistant: Notifications, Home Assistant: RESTful Command, документация API MAX, MAX: отправка сообщений. Кейс — наш Home Assistant 2026.9.4. Проверено 5 октября 2026 года.

6 / 1
Оцените статью
Да будет Интернет!