Виртуальные занятия

Проводите онлайн-занятия в прямом эфире через Zoom, Google Meet или Microsoft Teams. Когда вы отмечаете занятие как виртуальное, BailaYa автоматически создаёт встречу на подключённой платформе и делится ссылкой с записанными учениками.

Предварительные требования

Перед созданием виртуальных занятий подключите хотя бы одну видеоплатформу в разделе Настройки → Интеграции:

• Zoom — Требуется токен доступа к API Zoom
• Google Meet — Требуется токен доступа к API Google Calendar (встречи создаются как события Calendar со ссылками на Meet)
• Microsoft Teams — Требуется токен доступа к API Microsoft Graph

подсказка

Вам нужно настроить только те платформы, которые вы планируете использовать. Опция виртуального занятия появляется в форме создания занятия только тогда, когда подключена хотя бы одна платформа.

Подключение платформы

1. Перейдите в Настройки → Интеграции.
2. Прокрутите до раздела Платформы для Виртуальных Занятий.
3. Для выбранной платформы:
   • Переключите тумблер в положение Включено.
   • Вставьте ваш Токен Доступа (см. документацию по конкретным платформам ниже).
   • Для Google Meet при необходимости укажите ID Календаря (по умолчанию используется ваш основной календарь).
   • Нажмите Сохранить.

Получение токенов доступа

Платформа	Где получить токен
Zoom	Zoom Marketplace — Создайте серверное OAuth-приложение или используйте персональный токен доступа
Google Meet	Google Cloud Console — Включите Calendar API и сгенерируйте учётные данные OAuth2
Microsoft Teams	Azure Portal — Зарегистрируйте приложение и предоставьте разрешение OnlineMeetings.ReadWrite

Создание виртуального занятия

1. Откройте Расписание и нажмите Создать Занятие (или отредактируйте существующее занятие).
2. Заполните данные занятия как обычно (название, время, инструктор и т.д.).
3. Внизу формы вы увидите переключатель Виртуальное Занятие (отображается только если платформа подключена).
4. Включите Виртуальное Занятие.
5. Выберите Платформу из выпадающего списка (отображаются только настроенные платформы).
6. Нажмите Сохранить.

BailaYa выполнит следующее:

• Создаст встречу на выбранной платформе с названием занятия и запланированным временем.
• Сохранит URL встречи в записи занятия.
• Сделает ссылку на встречу доступной для записанных учеников.

Если платформа временно недоступна, занятие всё равно будет создано — ссылку на встречу можно добавить позже, отредактировав занятие.

Что видят ученики

• На странице деталей занятия записанные ученики видят кнопку Присоединиться к Виртуальному Занятию со ссылкой на встречу.
• Ссылка на встречу также включается в письма с подтверждением бронирования.
• Ссылка видна только ученикам, записанным на занятие — она не отображается публично.

Повторяющиеся виртуальные занятия

Когда вы создаёте серию повторяющихся занятий с включённой виртуальной опцией, каждое отдельное занятие в серии получает свою уникальную ссылку на встречу. Это гарантирует, что ученики всегда присоединяются к правильной сессии.

Редактирование виртуального занятия

Вы можете переключать виртуальный режим при редактировании занятия:

• Включение виртуального режима для существующего очного занятия создаёт новую встречу.
• Отключение виртуального режима для виртуального занятия удаляет ссылку на встречу (внешняя встреча удаляется с платформы).
• Смена платформы создаёт новую встречу на новой платформе и удаляет старую.

Гибридные занятия

Занятие может быть одновременно очным и виртуальным:

• Назначьте Зал для очных участников.
• Включите Виртуальное Занятие для удалённых участников.
• Обе группы видят одно и то же занятие в расписании, но удалённые ученики получают ссылку на встречу.

Примечания по платформам

Zoom

• Встречи создаются как запланированные встречи (Type 2).
• join_before_host включён, чтобы ученики могли присоединиться до инструктора.
• mute_upon_entry включён по умолчанию.
• Запись отключена по умолчанию.

Google Meet

• Встречи создаются как события Google Calendar с прикреплённой конференцией Google Meet.
• Если вы указываете ID Календаря, событие создаётся в этом календаре; в противном случае используется основной календарь.
• Ссылка на Meet извлекается из данных конференции события календаря.

Microsoft Teams

• Встречи создаются через Microsoft Graph Online Meetings API.
• Обход лобби установлен на «все», чтобы ученики могли присоединяться напрямую.
• Объявления о входе/выходе отключены по умолчанию.

Справочник API

Поля виртуального занятия включены в стандартный API расписания:

Поле	Тип	Описание
isVirtual	boolean	Является ли это виртуальным занятием
virtualPlatform	string	ZOOM, GOOGLE_MEET или TEAMS
virtualMeetingUrl	string	URL для присоединения к встрече (только чтение, генерируется автоматически)
virtualMeetingId	string	Внешний идентификатор встречи на платформе (только чтение)

Эти поля включены в POST /api/schedule (создание) и PATCH /api/schedule/:id (обновление).