раздел 02
Что умеет Zoom API
Zoom API разбит на области. Каждой нужны свои scopes - добавляете их в приложении под те задачи, что реально решаете. Ниже - основные области и что в каждой.
Meetings
Создавать, обновлять, удалять встречи и получать их список. Самая ходовая область: завести встречу из кода и отдать ссылку пользователю.
Webinars
То же, что встречи, но для вебинаров: регистрация участников, панелисты, отчёты по вебинарам. Доступно на тарифах с вебинарами.
Users
Пользователи аккаунта: создать, посмотреть, изменить, деактивировать. Нужна, чтобы создавать встречи от имени конкретного пользователя.
Cloud Recordings
Облачные записи: список записей пользователя или встречи, ссылки на скачивание, удаление. Основа пайплайнов вокруг записей.
Reports
Отчёты по встречам и участникам: кто был, сколько времени, по всем встречам аккаунта. Для аналитики и учёта.
Team Chat
Корпоративный чат Zoom: каналы, сообщения, участники. Чтобы встроить уведомления и переписку в свои сценарии.
Zoom Phone
Телефония Zoom: номера, звонки, записи звонков, настройки. Для интеграции телефонии в CRM и бэкенд.
Webhooks
События Zoom (запись готова, встреча началась и т.д.). Не запрос от вас, а наоборот - Zoom зовёт ваш сервер. Подробно в разделе 04.
Как выбрать, что подключать
Не подключайте всё подряд. Возьмите минимальный набор scopes под задачу:
- Завести встречу и отдать ссылку - область Meetings (и, возможно, Users).
- Забрать запись после встречи - Cloud Recordings плюс вебхук
recording.completed. - Свести отчётность по посещаемости - Reports.
Меньше scopes - меньше прав у токена, безопаснее.