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

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

• Сменить пароль для аккаунта @ha:chat.2admina.ru
• Использовать !secret для хранения чувствительных данных

</note>

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

# Добавьте сюда ваши данные
matrix_homeserver: "https://chat.2admina.ru"
matrix_username: "@ha:chat.2admina.ru"
matrix_password: "********"  # ⚠️ замените на новый пароль!
matrix_room: "#ваша_комната:chat.2admina.ru"

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

# Основная интеграция Matrix
matrix:
  homeserver: !secret matrix_homeserver
  username: !secret matrix_username
  password: !secret matrix_password
  verify_ssl: true  # если у вас самоподписанный сертификат, установите false
  rooms:
    - !secret matrix_room  # комнаты для прослушивания команд
  commands:  # опционально: команды для обработки
    - word: статус
      name: ha_status
    - word: перезагрузка
      name: ha_restart
 
# Платформа уведомлений
notify:
  - name: matrix_notify
    platform: matrix
    default_room: !secret matrix_room

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

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

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

automation:
  - alias: "Уведомление в Matrix при срабатывании датчика"
    triggers:
      - trigger: state
        entity_id: binary_sensor.motion_door
        to: "on"
    actions:
      - action: notify.matrix_notify
        data:
          message: "🚪 Движение у входной двери!"
          
            format: "html"  # опционально: поддержка базового HTML

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

action: notify.matrix_notify
data:
  message: "📷 Снимок с камеры"
  
    images:
      - /config/www/camera/snapshot.jpg

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

homeassistant:
  allowlist_external_dirs:
    - /config/www/camera

</note>

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

automation:
  - alias: "Обработка команды !статус"
    triggers:
      - trigger: event
        event_type: matrix_command
        event_data:
          command: ha_status
    actions:
      - action: notify.matrix_notify
        
          message: "✅ Home Assistant работает нормально. Версия: {{ states('sensor.home_assistant_version') }}"

• Используйте отдельный аккаунт для бота, не ваш личный.
• Ограничьте права бота: не давайте права администратора в комнатах.
• Проверьте SSL: если сервер использует самоподписанный сертификат, установите verify_ssl: false (менее безопасно).
• Регулярно меняйте пароль и обновляйте secrets.yaml.

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

# После установки в /config/custom_components/
matrix_chat:
  homeserver: !secret matrix_homeserver
  user_id: !secret matrix_username
  access_token: !secret matrix_access_token  # токен вместо пароля
  verify_ssl: true

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

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

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