Как прокинуть датчики и реле из Home Assistant в Алису бесплатно

Сервер Home Assistant (HA) — это признанный отраслевой стандарт для создания гибкого, сложного и полностью локального умного дома. Однако когда дело доходит до голосового управления на русском языке, Яндекс Станция с Алисой остается безоговорочным лидером.

Идеальная гибридная схема — использовать локальный сервер Home Assistant в качестве главного вычислительного ядра умного дома, а колонки с Алисой — как интерфейс для голосового ввода и оповещений. Связать эти две платформы можно абсолютно бесплатно с помощью популярного кастомного компонента Yandex Smart Home.

Если у вас нет выделенного сервера Home Assistant, но вы хотите управлять устройствами Яндекса через технику Apple (приложение «Дом» и Siri), то более простым решением будет настройка проброса устройств Яндекса в Apple HomeKit через Homebridge.

Шаг 1. Организация защищенного внешнего HTTPS-доступа

Поскольку Яндекс общается с вашим сервером через Webhook-запросы, Home Assistant должен быть доступен из интернета по защищенному протоколу HTTPS. Существует два популярных метода:

1. Cloudflare Tunnel (Рекомендуется). Полностью бесплатный способ, не требующий наличия «белого» IP-адреса от провайдера и открытия портов на роутере. Вам потребуется лишь собственный домен (можно зарегистрировать за копейки). Вся конфигурация настраивается через официальный аддон Cloudflare в магазине HA.
2. DuckDNS + Let’s Encrypt. Способ для тех, у кого есть белый IP-адрес. Требует проброса внешнего порта 443 (или 8123) на роутере на локальный IP-адрес сервера HA.

Шаг 2. Установка и базовая конфигурация компонента

Интеграция устанавливается через HACS (Home Assistant Community Store):

1. Откройте Home Assistant ➡️ перейдите в раздел HACS ➡️ Интеграции.
2. В строке поиска введите Yandex Smart Home.
3. Нажмите кнопку «Скачать» в правом нижнем углу. После завершения скачивания перейдите в Панель управления ➡️ Настройки ➡️ Система и перезапустите Home Assistant.
4. Откройте ваш файл конфигурации configuration.yaml (например, через File Editor или VS Code аддон) и добавьте параметры маппинга устройств:

yandex_smart_home:
  notifier:
    - oauth_token: "AgAAAAAyour_oauth_token_here"
  filter:
    include_entities:
      - switch.bedroom_light
      - sensor.bedroom_temperature
      - sensor.kitchen_leak
  entity_config:
    sensor.bedroom_temperature:
      name: "Температура в спальне"
      room: "Спальня"
    sensor.kitchen_leak:
      name: "Протечка под мойкой"
      room: "Кухня"
      device_class: leak

[!IMPORTANT] Для правильного определения типа датчика в Алисе (например, чтобы датчик протечки отображался именно как протечка, а не как бинарный сенсор общего назначения), обязательно укажите корректный device_class в Home Assistant или в блоке entity_config конфигурационного файла.

Как получить OAuth-токен для мгновенного обновления статусов?

Чтобы датчики в Алисе обновляли свои показания мгновенно (без задержек в несколько минут), Home Assistant должен сам отправлять события в Яндекс. Для этого сгенерируйте токен на специальной странице Яндекса: https://yandex.ru/iot/link под вашим основным аккаунтом Яндекса и вставьте его в поле oauth_token в файле конфигурации.

Шаг 3. Подключение интеграции в приложении «Дом с Алисой»

1. Откройте приложение «Дом с Алисой» на вашем смартфоне.
2. Нажмите на значок «+» в верхнем правом углу экрана ➡️ выберите пункт «Устройство другого производителя».
3. В строке поиска введите «Home Assistant» (или выберите одноименную интеграцию из списка).
4. Нажмите кнопку «Привязать к Яндексу».
5. На открывшейся странице авторизации введите внешний HTTPS-адрес вашего сервера Home Assistant (например, https://myhouse.duckdns.org:8123) и войдите под своей учетной записью HA. Обязательно разрешите доступ к сущностям.
6. После успешной авторизации нажмите кнопку «Обновить список устройств». Все сущности, указанные в файле конфигурации, отобразятся в приложении Яндекса.

Оптимизация радиоканалов при гибридной схеме

При одновременной работе мощного сервера Home Assistant с USB-координатором Zigbee и нескольких Яндекс Станций с Zigbee в одном помещении критически важно разнести их радиочастоты, чтобы избежать зависаний датчиков. Подробные инструкции по выбору частотных сеток вы найдете в нашей статье по выбору каналов Zigbee и Wi-Fi. Показания датчиков, проброшенных из HA, можно использовать в любых сложных сценариях, таких как климатический контроль теплых полов.