Подключение Zoom¶
Результат¶
Threadory получит выбранные cloud-записи Zoom, транскрипты и summary AI Companion как сущности встреч.
Перед началом¶
- роль администратора или владельца проекта Threadory;
- приложение Server-to-Server OAuth в Zoom Marketplace с правами на cloud recording и meeting summary;
- включённые Cloud Recording и audio transcript у нужных host;
- заранее продуманный фильтр встреч, если один Zoom-аккаунт обслуживает несколько проектов.
Профиль подключения¶
| Пункт | Минимум или ожидаемое поведение |
|---|---|
| Учётные данные | Server-to-Server OAuth: Account ID, Client ID, Client Secret |
| Доступ | Admin scopes: пользователи, записи, скачивание VTT, AI Companion summary |
| Идентичность | Общий S2S app; участники по email host/participants |
| Направление | Только inbound: user, meeting, transcript_segment, meeting_summary |
| Доставка | Polling каждые 30 минут; webhooks ускоряют, если задан secret |
Шаги¶
- Создайте S2S OAuth app в Zoom Marketplace и выдайте scopes записи/summary.
- Активируйте app и скопируйте Account ID, Client ID, Client Secret.
- В Threadory: Connectors → Add connector → Zoom.
- Шаг 1 — Connect Zoom app: вставьте credentials и нажмите Test connection. Платформа проверяет токен, список host и недавние записи (ничего не сохраняется до Install).
- Шаг 2 — Scope: сводка + фильтр по host / домену / теме с live preview по sample-встречам.
- Опционально (Advanced): transcript storage и Secret Token webhooks.
- Install Zoom, затем Sync now.
Проверка¶
- синхронизация успешна в Activity;
- встреча видна в Knowledge с preview/summary;
- action items появляются после
meeting_notes.
Частые проблемы¶
| Симптом | Причина | Что делать |
|---|---|---|
| Unhealthy | Неверные credentials | Пересоздать/перекопировать S2S credentials |
| Hollow meeting | Нет recording/transcript | Включить cloud recording + transcript |
| Нет summary | Нет AI Companion / scopes | Включить summary и scopes |
| Чужие встречи | Слишком широкий фильтр | Сузить hosts/domains/title |
| Долгий sync | Много users | Host filter + Max hosts per sync |
Безопасное отключение¶
Отключение останавливает импорт, но не удаляет уже загруженные встречи. Экспортируйте нужные данные, отключите коннектор, при необходимости ротируйте S2S credentials и примените retention.