Files
buryan-infra/ops/yandex/ALICE-VOICE-CONTROL.md
buryan-agent 3e6ac0945d Zigbee-выключатель подключён, голосовое управление Яндексом
Первое Zigbee-устройство: Yandex YNDX_00532 (0xacbac0fffebde397) —
двухклавишный выключатель. В HA появились switch 1/2, подсветка, режимы,
переименованы по-человечески.

Ловушка: permit_join нельзя открыть дольше 254 секунд — запросы на 900/1800
молча отклоняются, из-за этого первая попытка не сработала. Написан keepjoin.py,
который держит окно открытым 15 минут.

Яндекс: переавторизация по QR обновляет cookie, но права iot не появляются;
прямые запросы к api.iot и iot.quasar дают 403/401. Сделан голосовой обход:
команда бота !алиса <фраза> отправляет «Алиса, ...» на колонку, и она
выполняет действие. Работает для всех устройств аккаунта.
2026-10-20 21:56:42 +03:00

47 lines
2.3 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Управление Яндекс.Умным домом голосом
## Проблема
Прямое управление через API не работает:
| Запрос | Результат |
|---|---|
| `api.iot.yandex.net` + `OAuth <music_token>` | **403** (токен без scope `iot`) |
| `api.iot.yandex.net` + `x-token` | 403 |
| `iot.quasar.yandex.ru` + Cookie | 401 |
| `iot.quasar.yandex.ru` + Cookie + x-token | 401 |
| `iot.quasar.yandex.ru` + Cookie + x-csrf-token | 401 |
Переавторизация через QR (YandexStation) обновляет cookie, но `x_token`
остаётся прежним и прав на запись не даёт. Поток повторной авторизации
завершается `abort` — HA не разрешает второй экземпляр интеграции.
## Рабочий обход — голос
Колонки управляются через `yandex_station.send_command` (`sendText`), а они
уже связаны с умным домом Яндекса. Значит, команду можно **сказать**:
```
!алиса включи свет в тамбуре
!алиса выключи телевизор в детской
!алиса какая погода
```
Бот отправит на колонку: «Алиса, включи свет в тамбуре» — и она выполнит.
Префикс «Алиса,» добавляется автоматически, если его нет.
## Почему это нормально работает
- не нужен iot-токен;
- Алиса сама знает все устройства и сценарии;
- работает для любого устройства в её аккаунте, а не только для тех 18, что
попали в мост;
- голосовые сценарии («я ухожу») тоже запускаются.
## Что осталось быстрым путём
Если очень нужен прямой API — взять OAuth-токен с scope `iot` через
официальное приложение «Дом с Алисой» (Яндекс.Ключ → интеграции) и подставить
в `/root/.ya_music_token`. Мост `yandex_iot_bridge` уже умеет отправлять
`on_off`, `brightness`, `rgb`.