ОФІЦІЙНА ДОКУМЕНТАЦІЯ ZOOM APP MARKETPLACE

Керівництво користувача та інтеграція ClassMind AI

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

📌 Швидка навігація розділами:

1. Додавання додатку (Покрокова інструкція зі встановлення)
2. Використання функціоналу (Вимоги та сценарії використання)
3. Видалення додатку (Деавторизація та стирання даних)
4. Посібник з усунення несправностей (Troubleshooting)
5. Часті запитання (FAQ)

1. Додавання додатку (Покрокова інструкція зі встановлення)

Підключення ClassMind AI до вашого облікового запису Zoom здійснюється через офіційний протокол Zoom OAuth 2.0 із гранулярними дозволами. Процес не вимагає ручного введення API-ключів, налаштування 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

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

Функція 2: AI-аналіз методики за стандартами CELTA та розрахунок Talk-Time

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

Функція 3: Індивідуальні звіти батькам та домашні завдання (Co-Pilot)

Сценарій використання: Заощаджує вчителю до 20 хвилин після кожного заняття завдяки автоматичній генерації персоналізованого звіту, нових слів та вправ.
Передумови: Завершений розбір транскрипту уроку.
Як користуватися: Протягом 90 секунд після закінчення заняття викладач отримує готовий чернетковий звіт у Telegram або веб-кабінеті, який можна відредагувати або надіслати учневі/батькам в один клік.

Функція 4: Щоденний ранковий коучинг викладачів

Сценарій використання: Безперервне підвищення кваліфікації вчителів у форматі 2-хвилинних мікро-порад, адаптованих під індивідуальні помилки.
Передумови: Закріплений профіль викладача в кабінеті школи.
Як користуватися: Щоранку о 09:00 за київським часом вчителі отримують практичну методичну пораду з таксономії CELTA (наприклад, техніки Concept Checking Questions, скорочення повторів або усунення пауз).

Функція 5: Щотижневий дайджест директора та Радар відтоку учнів

Сценарій використання: Забезпечує керівництво школи прозорою зведеною аналітикою успішності та сигналізує про учнів під загрозою втрати мотивації.
Передумови: Роль власника або директора школи.
Як користуватися: Щоп'ятниці о 18:00 керівник отримує структурований звіт про кількість проведених занять, середній бал викладачів та виявлені ризики відтоку.

3. Видалення додатку (Деавторизація та стирання даних)

Ви можете відключити та видалити ClassMind AI зі свого облікового запису Zoom у будь-який момент.

Покрокова інструкція з видалення додатку

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

Наслідки видалення додатку

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

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

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

Миттєве анулювання токенів (<10мс): Отримавши вебхук app_deauthorized від Zoom, наша система синхронно видаляє токени доступу з бази даних, переводячи статус підключення в 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). Локальні записи на комп'ютер вчителя не передаються через Zoom Cloud webhooks.
Перевірте тривалість заняття: тестові дзвінки тривалістю менше 3 хвилин відсікаються автоматично.
Зачекайте 3–5 хвилин: серверам Zoom потрібен час на рендеринг запису перед відправкою сповіщення.

Проблема 2: Помилка "Invalid redirect URI" під час підключення.

Переконайтеся, що ви ініціюєте авторизацію через офіційну сторінку https://getclassmind.com/zoom/oauth/authorize або Zoom App Marketplace.

Проблема 3: Потрібен дозвіл адміністратора на встановлення.

Якщо у вашій організації діють обмеження безпеки, зверніться до головного адміністратора Zoom з проханням попередньо схвалити додаток ClassMind AI у розділі Zoom Marketplace > Manage > App Requests.

5. Часті запитання (FAQ)

Чи зберігаються відеозаписи учнів або вчителів?

Ні. ClassMind працює за суворим протоколом Zero Video Retention. Відеоряд відкидається відразу, а виділена аудіодоріжка видаляється з пам'яті негайно після розпізнавання тексту.

Чи використовуються записи школи для навчання загальних моделей ШІ?

Ніколи. Обробка виконується виключно через корпоративні API із нульовим збереженням даних клієнта.

Як зв'язатися з технічною підтримкою?

Наша служба підтримки працює 24/7/365: support@getclassmind.com або в Telegram: @the_classmind_bot.