Настройка интеграции Matrix в Home Assistant

<note warning> Важное предупреждение: Вы указали пароль в открытом виде. Никогда не делитесь паролями в чатах! Рекомендуется:

Сменить пароль для аккаунта @ha:chat.2admina.ru

Использовать !secret для хранения чувствительных данных

</note>

📋 Шаг 1: Подготовка secrets.yaml

Создайте или отредактируйте файл /config/secrets.yaml:

# Добавьте сюда ваши данные matrix_user: "@ha:chat.2admina.ru" matrix_password: "ваш_пароль"

⚙️ Шаг 2: Настройка configuration.yaml

Добавьте в /config/configuration.yaml:

matrix: homeserver: https://chat.2admina.ru username: !secret matrix_user password: !secret matrix_password rooms: - "!your_room_id:chat.2admina.ru"

🔄 Шаг 3: Перезагрузка Home Assistant

Перейдите в Настройки → Система → Перезагрузка

Нажмите Перезагрузить конфигурацию (или перезапустите весь сервер)

После перезагрузки интеграция появится в Настройки → Устройства и службы.

📬 Использование уведомлений

В автоматизациях:

service: notify.matrix data: message: "Привет из Home Assistant!" target: "!your_room_id:chat.2admina.ru"

Отправка изображения:

service: notify.matrix data: message: "Движение обнаружено!" data: file: "/config/www/snapshot.jpg"

<note> ⚠️ Для отправки файлов из внешних папок добавьте в configuration.yaml:

homeassistant: allowlist_external_dirs: - "/config/www"

</note>

🎯 Обработка команд из Matrix

Создайте автоматизацию для реакции на команды:

trigger: - platform: event event_type: matrix_command event_data: command: "статус" action: - service: notify.matrix data: message: "Система работает в штатном режиме."

🔐 Рекомендации по безопасности

Используйте отдельный аккаунт для бота, не ваш личный.

Ограничьте права бота: не давайте права администратора в комнатах.

Проверьте SSL: если сервер использует самоподписанный сертификат, установите verify_ssl: false (менее безопасно).

Регулярно меняйте пароль и обновляйте secrets.yaml.

🛠️ Альтернатива: кастомная интеграция

Если официальная интеграция не поддерживает все нужные функции (E2EE, медиа), можно рассмотреть Matrix Chat custom component:

matrix_custom: homeserver: https://chat.2admina.ru access_token: "ваш_токен"

Токен доступа можно получить в клиенте Element: Настройки → Помощь и информация → Токен доступа.

❓ Устранение неполадок

Проблема	Решение
Не подключается к серверу	Проверьте verify_ssl, URL homeserver
Не видит команды	Убедитесь, что бот добавлен в комнату и комнаты указаны в конфиге
Ошибка аутентификации	Проверьте логин/пароль, возможно сервер требует токен
Не отправляет уведомления	Проверьте, что default_room существует и бот в нём состоит

Логи интеграции: Настройки → Система → Журналы → Фильтр: homeassistant.components.matrix

Нужна помощь с конкретной ошибкой? Пришлите лог — помогу разобраться! 🤖✨