ОФИЦИАЛЬНАЯ ДОКУМЕНТАЦИЯ ZOOM APP MARKETPLACE

Руководство пользователя и интеграция ClassMind AI

Полное руководство по добавлению, использованию функций, настройке и удалению ClassMind AI из учетной записи Zoom

📌 Быстрая навигация по разделам:

1. Добавление приложения (Пошаговое руководство по установке)
2. Использование функций (Требования и сценарии использования)
3. Удаление приложения (Деавторизация и стирание данных)
4. Руководство по устранению неполадок (Troubleshooting)
5. Часто задаваемые вопросы (FAQ)

1. Добавление приложения (Пошаговое руководство по установке)

Подключение ClassMind AI выполняется через официальный протокол Zoom OAuth 2.0 с гранулярными правами доступа. Процесс не требует ввода API-ключей, настройки сложных Server-to-Server JSON файлов или установки программ на ПК.

Требования для подключения (Prerequisites)

Учетная запись Zoom (планы Pro, Business, Enterprise или Education).
Права администратора или пользователя с разрешением на подключение приложений Zoom Marketplace.
Включенная запись в облако: В настройках Zoom (Settings > Recording > Cloud Recording) убедитесь, что опция Cloud Recording включена для автоматической фиксации уроков.

Пошаговая инструкция по установке

Найдите приложение: Перейдите в Zoom App Marketplace и найдите ClassMind AI, либо откройте прямую ссылку 1-Click авторизации: https://getclassmind.com/zoom/oauth/authorize.
Нажмите Добавить (Add): Нажмите кнопку Add для запуска безопасного процесса OAuth 2.0.
Проверьте запрашиваемые разрешения: Zoom отобразит официальное окно с перечнем прав:
- recording:read:admin / recording:read:list_user_recordings:admin: Позволяет ClassMind получать уведомление о завершении урока и скачивать аудиодорожку для методического анализа.
- user:read:email:admin: Позволяет сопоставлять записи уроков с закрепленными профилями преподавателей.
Подтвердите авторизацию: Ознакомьтесь с разрешениями и нажмите Разрешить (Allow).
Подтверждение подключения: Zoom перенаправит вас на защищенную страницу успешного подключения https://getclassmind.com/zoom/oauth/success. ClassMind AI мгновенно активирует подписку на вебхуки и начнет автоматическую обработку уроков.

🔗 Возникли трудности при настройке? Воспользуйтесь нашим Руководством по устранению неполадок ниже.

2. Использование функций (Требования и сценарии использования)

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

Функция 1: Автоматический захват облачных записей Zoom

Сценарий использования: Освобождает преподавателей от ручной выгрузки видеофайлов. Завершенный урок автоматически перехватывается в облаке и направляется на распознавание речи.
Требования: Включенный Cloud Recording у организатора встречи; длительность урока более 3 минут (короткие звонки отсекаются автоматически).
Как использовать: Проводите уроки как обычно. При завершении звонка Zoom отправляет вебхук recording.completed, после чего ClassMind скачивает аудиодорожку по TLS 1.3 для транскрибации.

Функция 2: AI-анализ методики CELTA и расчет баланса говорения (Talk-Time)

Сценарий использования: Предоставляет методисту и директору школы объективные данные по качеству урока без необходимости лично просматривать 60 минут видео.
Требования: Завершенная аудиозапись с разборчивой речью.
Как использовать: Нейросеть Silero VAD v5 и модель LLM оценивают стандарты Cambridge CELTA: соотношение речи учителя и ученика (TTT% / STT%), паузы свыше 3 секунд, риски оттока (Red-Flags) и диагностический уровень языка CEFR (A1–C2).

Функция 3: Индивидуальные отчеты родителям и домашние задания (Co-Pilot)

Сценарий использования: Экономит учителю до 20 минут после каждого занятия благодаря автогенерации отчета о прогрессе, новых слов и практических заданий.
Требования: Готовый анализ транскрипта урока.
Как использовать: Через 90 секунд после урока учитель получает готовый проект отчета в Telegram или веб-панели, который можно скорректировать или отправить ученику в 1 клик.

Функция 4: Ежедневный утренний коучинг учителей

Сценарий использования: Непрерывное микро-обучение преподавателей в формате 2-минутных практических рекомендаций.
Требования: Зарегистрированный профиль преподавателя в кабинете школы.
Как использовать: Каждое утро в 09:00 по киевскому времени учителя получают персонализированный совет по методике CELTA, направленный на устранение замеченных ранее недочетов.

Функция 5: Еженедельный дайджест руководителя и Радар оттока

Сценарий использования: Обеспечивает владельца школы сводными данными об академических результатах и учениках в зоне риска.
Требования: Роль администратора или владельца школы.
Как использовать: Каждую пятницу в 18:00 руководство получает итоговый дайджест с объемом занятий, рейтингом учителей и сигналами об удержании клиентов.

3. Удаление приложения (Деавторизация и стирание данных)

Вы можете отключить и удалить ClassMind AI из аккаунта Zoom в любой момент.

Пошаговая инструкция по удалению приложения

Войдите в свою учетную запись на Zoom App Marketplace.
Перейдите в меню: Manage >> Added Apps (или введите ClassMind AI в строке поиска).
Выберите ClassMind AI в списке подключенных приложений.
Нажмите Remove (или Uninstall).
Подтвердите удаление.

Последствия удаления приложения

ClassMind AI моментально прекращает получение вебхуков Zoom (recording.completed).
Автоматическая транскрибация уроков, расчет баллов CELTA и генерация отчетов Co-Pilot полностью останавливаются.
Все действующие OAuth 2.0 access и refresh токены аннулируются без возможности восстановления.

Порядок удаления данных после отключения (Data Compliance)

🔒 Стандарты Zoom Data Compliance и регламент GDPR/CCPA:

Мгновенное аннулирование ключей (<10мс): При получении события app_deauthorized сервис синхронно удаляет сохраненные токены из базы данных, присваивая статус deauthorized.
Подтверждение в Zoom Compliance API: В течение секунд ClassMind отправляет подтверждение на комплаенс-эндпоинт Zoom (POST https://api.zoom.us/oauth/data/compliance) с точной отметкой времени.
Полная очистка данных (в течение 24–48 часов): Все транскрипты, временные файлы и связанные записи школы безвозвратно удаляются с серверов в автоматическом пакетном режиме.
Срочное удаление по запросу: Для получения официального подтверждения удаления данных напишите на: privacy@getclassmind.com.

4. Руководство по устранению неполадок (Troubleshooting)

Проблема 1: Записи уроков не появляются в системе.

Проверьте включение записи в облако в настройках Zoom (Settings > Recording > Cloud Recording). Записи на локальный компьютер через облачные вебхуки недоступны.
Проверьте длительность звонка: уроки короче 3 минут автоматически игнорируются для защиты от случайных звонков.
Подождите 3–5 минут: Zoom требуется время для завершения обработки видео перед отправкой вебхука.

Проблема 2: Ошибка "Invalid redirect URI" при авторизации.

Убедитесь, что вход выполняется со страницы https://getclassmind.com/zoom/oauth/authorize или из каталога Zoom Marketplace.

Проблема 3: Требуется одобрение администратора.

Если в вашей компании действуют политики безопасности, попросите администратора Zoom предварительно одобрить ClassMind AI в разделе Zoom Marketplace > Manage > App Requests.

5. Часто задаваемые вопросы (FAQ)

Сохраняются ли видеофайлы учеников или учителей?

Нет. ClassMind работает по стандарту Zero Video Retention. Видеоряд сразу отбрасывается, а аудиофайл стирается из памяти немедленно после транскрибации.

Используются ли данные уроков для обучения публичных моделей ИИ?

Никогда. Обработка данных выполняется строго через изолированные enterprise-эндпоинты с нулевым сохранением обучающих выборок.

Как связаться со службой поддержки?

Наша техническая поддержка доступна 24/7/365: support@getclassmind.com или в Telegram: @the_classmind_bot.