Коннектор Zoom
Подключите Zoom к Brevo через Tajo для автоматической синхронизации участников встреч и посетителей вебинаров как контактов, запуска последовательностей follow-up после встреч и отслеживания метрик вовлечённости для маркетинговых автоматизаций.
Обзор
| Свойство | Значение |
|---|---|
| Платформа | Zoom |
| Категория | Video Conferencing (Custom) |
| Сложность настройки | Средняя |
| Официальная интеграция | Нет |
| Синхронизируемые данные | Участники, события, вебинары, контакты |
| Метод аутентификации | OAuth 2.0 / Server-to-Server OAuth |
Возможности
- Синхронизация участников, автоматическое создание контактов Brevo из участников встреч
- Захват посетителей вебинаров, синхронизация участников и зарегистрированных на вебинар
- Триггеры событий встреч, запуск автоматизаций при начале, завершении встреч и событиях записи
- Отслеживание вовлечённости, трекинг продолжительности присутствия и показателей участия
- Follow-up после вебинара, запуск целевых email-последовательностей на основе посещаемости вебинара
- Уведомления о записях, отправка ссылок на записи через email-кампании Brevo
Предварительные требования
Прежде чем начать, убедитесь, что у вас есть:
- Аккаунт Zoom (тариф Pro и выше)
- Приложение Zoom Server-to-Server OAuth или OAuth через Zoom App Marketplace
- Аккаунт Brevo с доступом к API
- Аккаунт Tajo с правами на управление коннекторами
Аутентификация
Server-to-Server OAuth (рекомендуется)
# Создайте приложение Server-to-Server OAuth на marketplace.zoom.usexport ZOOM_ACCOUNT_ID=your_account_idexport ZOOM_CLIENT_ID=your_client_idexport ZOOM_CLIENT_SECRET=your_client_secret// Получение токена доступа через Server-to-Server OAuthconst tokenResponse = await fetch('https://zoom.us/oauth/token', { method: 'POST', headers: { 'Authorization': `Basic ${Buffer.from( `${process.env.ZOOM_CLIENT_ID}:${process.env.ZOOM_CLIENT_SECRET}` ).toString('base64')}`, 'Content-Type': 'application/x-www-form-urlencoded' }, body: new URLSearchParams({ grant_type: 'account_credentials', account_id: process.env.ZOOM_ACCOUNT_ID })});
const { access_token } = await tokenResponse.json();OAuth 2.0 (пользовательский уровень)
// URL авторизации для пользовательского OAuthconst authUrl = 'https://zoom.us/oauth/authorize?' + new URLSearchParams({ client_id: process.env.ZOOM_CLIENT_ID, redirect_uri: 'https://your-app.com/callback', response_type: 'code' });
// Обмен кода на токеныconst tokenResponse = await fetch('https://zoom.us/oauth/token', { method: 'POST', headers: { 'Authorization': `Basic ${Buffer.from( `${process.env.ZOOM_CLIENT_ID}:${process.env.ZOOM_CLIENT_SECRET}` ).toString('base64')}`, 'Content-Type': 'application/x-www-form-urlencoded' }, body: new URLSearchParams({ grant_type: 'authorization_code', code: authorizationCode, redirect_uri: 'https://your-app.com/callback' })});Конфигурация
Базовая настройка
connectors: zoom: enabled: true account_id: "${ZOOM_ACCOUNT_ID}" client_id: "${ZOOM_CLIENT_ID}" client_secret: "${ZOOM_CLIENT_SECRET}"
sync: participants: true webinars: true recordings: true
webhook: secret_token: "${ZOOM_WEBHOOK_SECRET}" verification_token: "${ZOOM_VERIFICATION_TOKEN}"
lists: meeting_participants: 15 webinar_attendees: 16 webinar_registrants: 17Сопоставление полей
field_mapping: email: email name: FIRSTNAME join_time: MEETING_JOIN_DATE duration: MEETING_DURATION webinar_title: WEBINAR_NAME attendance_status: ATTENDANCE_STATUS registration_source: UTM_SOURCEЭндпоинты API
| Эндпоинт | Метод | Описание |
|---|---|---|
https://api.zoom.us/v2/users | GET | Список пользователей |
https://api.zoom.us/v2/users/{userId}/meetings | GET | Список встреч |
https://api.zoom.us/v2/meetings/{meetingId} | GET | Детали встречи |
https://api.zoom.us/v2/past_meetings/{meetingId}/participants | GET | Участники прошедшей встречи |
https://api.zoom.us/v2/users/{userId}/webinars | GET | Список вебинаров |
https://api.zoom.us/v2/webinars/{webinarId}/registrants | GET | Зарегистрированные на вебинар |
https://api.zoom.us/v2/webinars/{webinarId}/participants | GET | Участники вебинара |
https://api.zoom.us/v2/meetings/{meetingId}/recordings | GET | Записи встречи |
https://api.zoom.us/v2/webhooks | POST | Подписка на вебхуки |
Примеры кода
Инициализация коннектора
import { TajoClient } from '@tajo/sdk';
const tajo = new TajoClient({ apiKey: process.env.TAJO_API_KEY, brevoApiKey: process.env.BREVO_API_KEY});
await tajo.connectors.connect('zoom', { accountId: process.env.ZOOM_ACCOUNT_ID, clientId: process.env.ZOOM_CLIENT_ID, clientSecret: process.env.ZOOM_CLIENT_SECRET});Синхронизация участников встречи
// Получение участников прошедшей встречиconst response = await fetch( `https://api.zoom.us/v2/past_meetings/${meetingId}/participants`, { headers: { 'Authorization': `Bearer ${accessToken}`, 'Content-Type': 'application/json' } });
const { participants } = await response.json();
for (const participant of participants) { if (participant.user_email) { await tajo.contacts.sync({ email: participant.user_email, attributes: { FIRSTNAME: participant.name, MEETING_DURATION: participant.duration, MEETING_JOIN_DATE: participant.join_time, ATTENDANCE_STATUS: 'attended' }, listIds: [15] }); }}Синхронизация посетителей вебинара
// Получение участников вебинара и синхронизация с Brevoconst attendeesResponse = await fetch( `https://api.zoom.us/v2/past_webinars/${webinarId}/participants`, { headers: { 'Authorization': `Bearer ${accessToken}` } });
const { participants: attendees } = await attendeesResponse.json();
for (const attendee of attendees) { await tajo.contacts.sync({ email: attendee.user_email, attributes: { FIRSTNAME: attendee.name, WEBINAR_NAME: webinarTitle, ATTENDANCE_STATUS: 'attended', MEETING_DURATION: attendee.duration }, listIds: [16] });}Обработка вебхуков Zoom
app.post('/webhooks/zoom', async (req, res) => { // Обработка challenge для валидации URL Zoom if (req.body.event === 'endpoint.url_validation') { const hashForValidation = crypto .createHmac('sha256', process.env.ZOOM_WEBHOOK_SECRET) .update(req.body.payload.plainToken) .digest('hex');
return res.json({ plainToken: req.body.payload.plainToken, encryptedToken: hashForValidation }); }
// Проверка подписи вебхука const message = `v0:${req.headers['x-zm-request-timestamp']}:${JSON.stringify(req.body)}`; const hash = crypto .createHmac('sha256', process.env.ZOOM_WEBHOOK_SECRET) .update(message) .digest('hex'); const signature = `v0=${hash}`;
if (req.headers['x-zm-signature'] !== signature) { return res.status(401).send('Unauthorized'); }
const { event, payload } = req.body;
await tajo.connectors.handleWebhook('zoom', { topic: event, payload: payload });
res.status(200).send('OK');});Ограничения скорости
| Категория | Лимит | Примечания |
|---|---|---|
| Лёгкие API-вызовы | 30 запросов/сек | GET информация о пользователях и встречах |
| Средние API-вызовы | 20 запросов/сек | Список участников, вебинаров |
| Тяжёлые API-вызовы | 10 запросов/сек | Отчёты, записи |
| Дневной лимит | 5 000+ | Зависит от тарифного плана |
Заголовки ограничений скорости
Zoom возвращает заголовки X-RateLimit-Limit, X-RateLimit-Remaining и Retry-After. Реализуйте логику задержки на основе этих заголовков, чтобы избежать ошибок 429.
Устранение неполадок
| Проблема | Причина | Решение |
|---|---|---|
| 401 Unauthorized | Токен истёк | Обновите токен Server-to-Server OAuth |
| Отсутствующие участники | Встреча не завершена | Дождитесь окончания встречи для получения полных данных |
| Валидация вебхука не проходит | Неверный секрет | Проверьте секрет вебхука в Zoom Marketplace |
| Нет данных email | Гостевые участники | Включите регистрацию для захвата email-адресов |
| Лимит 429 | Слишком много запросов | Реализуйте экспоненциальную задержку |
Режим отладки
connectors: zoom: debug: true log_level: verbose log_webhooks: trueЛучшие практики
- Используйте Server-to-Server OAuth, упрощённая аутентификация без взаимодействия с пользователем
- Включите регистрацию на вебинар, обязательно для захвата email-адресов посетителей
- Обрабатывайте после завершения встречи, данные об участниках полны только после окончания встреч
- Сегментируйте по типу события, назначайте разные листы Brevo для встреч и вебинаров
- Отслеживайте метрики вовлечённости, используйте продолжительность и время подключения для скоринга лидов
- Автоматизируйте отправку записей, автоматически доставляйте ссылки на записи через Brevo
Безопасность
- OAuth 2.0, Server-to-Server или пользовательская OAuth-аутентификация
- Верификация вебхуков, валидация подписи HMAC-SHA256
- URL-валидация, challenge-response верификация для вебхук-эндпоинтов
- Ограниченные права, запрашивайте минимально необходимые OAuth scope
- Ротация токенов, Server-to-Server токены автоматически истекают (1 час)
- Зашифрованная передача, TLS 1.2+ для всех API-коммуникаций