Скилл Яндекс Телемост в Aizor: как подключить и создавать видеовстречи
Содержание
Коротко. Скилл Яндекс Телемост позволяет агенту Aizor создавать, читать и редактировать видеовстречи через REST API. Для подключения нужен OAuth-токен: его получают, создав OAuth-приложение Яндекса с правами на Телемост. Важное ограничение из документации: API Телемоста доступен только пользователям Яндекс 360 для бизнеса с аккаунтами на домене организации. Цены на сам API в документации нет.
Что даёт скилл Яндекс Телемост в Aizor
Официальное описание скилла от команды Aizor: создание, чтение и редактирование видеовстреч Яндекс Телемоста через REST API.
Агент может по просьбе создать встречу и дать ссылку, показать данные существующей встречи или изменить её настройки. Это удобно тому, кто ежедневно назначает созвоны с клиентами и командой и не хочет каждый раз открывать сервис. Что такое Aizor, читайте на странице «Что такое Aizor».
Что понадобится
- Яндекс 360 для бизнеса и рабочий аккаунт на домене вашей организации. Личные аккаунты Яндекса под это ограничение не подходят.
- Возможность создать OAuth-приложение на oauth.yandex.ru. Кто в организации может это сделать, в статьях о Телемосте не сказано.
- Приложение Aizor для macOS или Windows и скилл Яндекс Телемост из каталога.
Нужен аккаунт Aizor? Скачивание бесплатное, промокод kalsin5 даёт −5% на каждое пополнение.
Открыть Aizor ↗Как получить ключ API: по шагам
Телемост авторизует приложения с помощью OAuth-токенов. Порядок из документации такой.
- Создайте своё OAuth-приложение по инструкции из справки OAuth Яндекс ID.
- В разделе «Доступ к данным» укажите права. Для создания встреч это
telemost-api:conferences.create, для просмотраtelemost-api:conferences.read, для измененияtelemost-api:conferences.update. Есть ещёtelemost-api:organization_settings.readи.update: они нужны для просмотра и изменения настроек по умолчанию для всех новых встреч. - На странице приложения скопируйте идентификатор из поля ClientID.
- Откройте ссылку
https://oauth.yandex.ru/authorize?response_type=token&client_id=<ClientID>, подставив свой идентификатор. - Если токен выдаётся впервые или срок предыдущего истёк, откроется экран авторизации. Войдите в сервис.
- Скопируйте токен с открывшейся страницы и сохраните его.
Найти выданный токен в личном кабинете нельзя: Яндекс OAuth не хранит токены в публичном доступе. Потеряли токен, получите новый по той же ссылке. Конкретный срок жизни токена в разделе о Телемосте не назван, он упомянут только как «срок жизни токена истёк». Затем установите скилл Яндекс Телемост из каталога Aizor и вставьте токен в его настройки.
Проверка: первые запросы агенту
- «Покажи данные моей встречи по этой ссылке» (только чтение).
- «Какие настройки комнаты ожидания у этой встречи?»
- «Создай видеовстречу и пришли ссылку».
- «Измени настройки этой встречи» (изменение: лучше под подтверждением).
Попробовать на своём кабинете. Aizor скачивается бесплатно, есть тариф со своими API-ключами. Промокод kalsin5 даёт скидку 5% на пополнение баланса.
Сценарии автоматизации
Встреча по запросу
Вы пишете агенту: «создай встречу для разговора с клиентом». Агент создаёт её через API и возвращает ссылку для участников. Ссылку вы отправляете сами или поручаете агенту вставить её в письмо.
Справка по встрече перед звонком
Перед важным созвоном вы просите агента прочитать данные встречи и коротко напомнить, какие у неё настройки и по какой ссылке заходить. Это чтение, права на изменение не нужны. Если вы ведёте календарь в Google, смотрите скилл Google Workspace.
Настройка доступа к встрече
У встречи есть уровень комнаты ожидания: выключена для всех, включена для внешних пользователей или доступ только для организаторов. Вы просите агента показать текущий уровень или изменить его для важной встречи.
Проверка расписания встреч
Агент может по запросу прочитать данные нескольких встреч, ссылки на которые вы дадите, и свести их в список. Задачу можно запускать по расписанию, например перед началом рабочего дня.
Частые ошибки
| Что видите | Причина | Что делать |
|---|---|---|
| «Не авторизован» (401) | Токен не передан, неверный или истёк. | Получите токен заново по ссылке авторизации и вставьте в настройки скилла. |
| «Трансляции недоступны на вашем тарифе» (402) | Трансляции не входят в ваш тариф. | Работайте с обычными видеовстречами или проверьте тариф Яндекс 360. |
| Ответ 403 | Не хватает прав у токена или у аккаунта. | Проверьте, что в OAuth-приложении выбраны нужные права, и получите токен заново. |
| «Слишком много запросов» (429) | Превышен лимит запросов. Цифра в документации не указана. | Подождите и повторите позже. |
| «Сессия пользователя не активна» (410) | Сессия пользователя больше не действует. | Получите новый токен по ссылке авторизации. |
Безопасность
- Выбирайте минимум прав. Если агенту нужно только смотреть встречи, дайте
conferences.readи не добавляйтеcreateиupdate. - Создайте отдельное OAuth-приложение под агента, чтобы его можно было отключить без последствий для других сервисов.
- Создание и изменение встреч лучше пускать через ручное подтверждение в Aizor.
- Не пересылайте токен в чатах и письмах. Хранить его нужно только в настройках скилла.
- Как отозвать токен, в документации Телемоста не описано. Подробности смотрите в справке Яндекс OAuth.
Инструкция написана по официальной документации Яндекс Телемоста (yandex.ru/dev/telemost), состояние на октябрь 2026 года. Интерфейс кабинета и условия могут измениться. Автор Aizorlab участвует в партнёрской программе Aizor.
