Коннектор Zoom

Подключите Zoom к Brevo через Tajo для автоматической синхронизации участников встреч и посетителей вебинаров как контактов, запуска последовательностей follow-up после встреч и отслеживания метрик вовлечённости для маркетинговых автоматизаций.

Обзор

СвойствоЗначение
ПлатформаZoom
КатегорияVideo Conferencing (Custom)
Сложность настройкиСредняя
Официальная интеграцияНет
Синхронизируемые данныеУчастники, события, вебинары, контакты
Метод аутентификацииOAuth 2.0 / Server-to-Server OAuth

Возможности

  • Синхронизация участников, автоматическое создание контактов Brevo из участников встреч
  • Захват посетителей вебинаров, синхронизация участников и зарегистрированных на вебинар
  • Триггеры событий встреч, запуск автоматизаций при начале, завершении встреч и событиях записи
  • Отслеживание вовлечённости, трекинг продолжительности присутствия и показателей участия
  • Follow-up после вебинара, запуск целевых email-последовательностей на основе посещаемости вебинара
  • Уведомления о записях, отправка ссылок на записи через email-кампании Brevo

Предварительные требования

Прежде чем начать, убедитесь, что у вас есть:

  1. Аккаунт Zoom (тариф Pro и выше)
  2. Приложение Zoom Server-to-Server OAuth или OAuth через Zoom App Marketplace
  3. Аккаунт Brevo с доступом к API
  4. Аккаунт Tajo с правами на управление коннекторами

Аутентификация

Server-to-Server OAuth (рекомендуется)

Terminal window
# Создайте приложение Server-to-Server OAuth на marketplace.zoom.us
export ZOOM_ACCOUNT_ID=your_account_id
export ZOOM_CLIENT_ID=your_client_id
export ZOOM_CLIENT_SECRET=your_client_secret
// Получение токена доступа через Server-to-Server OAuth
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: 'account_credentials',
account_id: process.env.ZOOM_ACCOUNT_ID
})
});
const { access_token } = await tokenResponse.json();

OAuth 2.0 (пользовательский уровень)

// URL авторизации для пользовательского OAuth
const 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/usersGETСписок пользователей
https://api.zoom.us/v2/users/{userId}/meetingsGETСписок встреч
https://api.zoom.us/v2/meetings/{meetingId}GETДетали встречи
https://api.zoom.us/v2/past_meetings/{meetingId}/participantsGETУчастники прошедшей встречи
https://api.zoom.us/v2/users/{userId}/webinarsGETСписок вебинаров
https://api.zoom.us/v2/webinars/{webinarId}/registrantsGETЗарегистрированные на вебинар
https://api.zoom.us/v2/webinars/{webinarId}/participantsGETУчастники вебинара
https://api.zoom.us/v2/meetings/{meetingId}/recordingsGETЗаписи встречи
https://api.zoom.us/v2/webhooksPOSTПодписка на вебхуки

Примеры кода

Инициализация коннектора

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]
});
}
}

Синхронизация посетителей вебинара

// Получение участников вебинара и синхронизация с Brevo
const 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

Лучшие практики

  1. Используйте Server-to-Server OAuth, упрощённая аутентификация без взаимодействия с пользователем
  2. Включите регистрацию на вебинар, обязательно для захвата email-адресов посетителей
  3. Обрабатывайте после завершения встречи, данные об участниках полны только после окончания встреч
  4. Сегментируйте по типу события, назначайте разные листы Brevo для встреч и вебинаров
  5. Отслеживайте метрики вовлечённости, используйте продолжительность и время подключения для скоринга лидов
  6. Автоматизируйте отправку записей, автоматически доставляйте ссылки на записи через Brevo

Безопасность

  • OAuth 2.0, Server-to-Server или пользовательская OAuth-аутентификация
  • Верификация вебхуков, валидация подписи HMAC-SHA256
  • URL-валидация, challenge-response верификация для вебхук-эндпоинтов
  • Ограниченные права, запрашивайте минимально необходимые OAuth scope
  • Ротация токенов, Server-to-Server токены автоматически истекают (1 час)
  • Зашифрованная передача, TLS 1.2+ для всех API-коммуникаций

Связанные ресурсы

Subscribe to updates

developer-docs

Drop your email or phone number — we'll send you what matters next.

auto-detect
AI-ассистент

Привет! Спрашивайте меня о документации.