Zoom конектор

Свържи Zoom с Brevo през Tajo, за да синхронизираш автоматично участници в срещи и присъстващи на webinar-и като контакти, да задействаш последователности за follow-up след срещи и да проследяваш метрики за ангажираност за своите маркетингови автоматизации.

Преглед

Свойство	Стойност
Платформа	Zoom
Категория	Видеоконференции (персонализирана)
Сложност на настройка	Средна
Официална интеграция	Не
Синхронизирани данни	Участници, събития, webinar-и, контакти
Метод на автентикация	OAuth 2.0 / Server-to-Server OAuth

Функции

Синхронизация на участници – Автоматично създавай Brevo контакти от участниците в срещи
Улавяне на присъстващи на webinar – Синхронизирай регистрираните и присъстващите на webinar-и
Тригери за meeting събития – Задействай автоматизации при старт, край и recording събития на срещи
Проследяване на ангажираност – Проследявай продължителност на присъствие и метрики за участие
Webinar follow-up – Задействай таргетирани имейл последователности на базата на присъствие на webinar
Известия за записи – Изпращай връзки към записи чрез имейл кампании в Brevo

Предварителни условия

Преди да започнеш, увери се, че имаш:

Акаунт в Zoom (Pro план или по-горе)
Server-to-Server OAuth приложение в Zoom или OAuth приложение чрез Zoom App Marketplace
Акаунт в Brevo с API достъп
Акаунт в Tajo с разрешения за конектори

Автентикация

Server-to-Server OAuth (препоръчително)

# Create a Server-to-Server OAuth app at marketplace.zoom.us
export ZOOM_ACCOUNT_ID=your_account_id
export ZOOM_CLIENT_ID=your_client_id
export ZOOM_CLIENT_SECRET=your_client_secret

// Get access token via 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 (на ниво потребител)

// Authorization URL for user-level 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'
  });

// Exchange code for tokens
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	Списък с webinar-и
`https://api.zoom.us/v2/webinars/{webinarId}/registrants`	GET	Списък с регистрирани за webinar
`https://api.zoom.us/v2/webinars/{webinarId}/participants`	GET	Списък с участници в webinar
`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
});

Синхронизация на участници в срещи

// Retrieve past meeting participants
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]
    });
  }
}

Синхронизация на присъстващи на webinar

// Get webinar attendees and sync to 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) => {
  // Handle Zoom URL validation challenge
  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
    });
  }

  // Verify webhook signature
  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 user, meeting info
Средни API извиквания	20 заявки/сек	Списък с участници, webinar-и
Тежки API извиквания	10 заявки/сек	Отчети, записи
Дневен лимит	5 000+	Зависи от нивото на плана

Хедъри за rate limit

Zoom връща хедърите X-RateLimit-Limit, X-RateLimit-Remaining и Retry-After. Внедри backoff логика на базата на тези хедъри, за да избегнеш 429 грешки.

Отстраняване на проблеми

Проблем	Причина	Решение
401 Unauthorized	Token изтекъл	Refresh-ни Server-to-Server OAuth token
Липсващи участници	Срещата не е приключила	Изчакай срещата да приключи за пълни данни
Валидацията на уебхук се проваля	Грешна тайна	Провери webhook secret в Zoom Marketplace
Няма имейл данни	Гост участници	Активирай регистрация, за да улавяш имейли
Rate limit 429	Твърде много заявки	Внедри exponential backoff

Режим за дебъг

connectors:
  zoom:
    debug: true
    log_level: verbose
    log_webhooks: true

Добри практики

Използвай Server-to-Server OAuth – По-опростена автентикация без потребителско взаимодействие
Активирай webinar регистрация – Изисква се, за да улавяш имейл адресите на присъстващите
Обработвай след края на срещата – Данните за участниците са пълни едва след края на срещата
Сегментирай по тип събитие – Присвоявай различни списъци в Brevo за срещи vs. webinar-и
Проследявай метрики за ангажираност – Използвай продължителност и време на присъединяване за lead scoring
Изпращай follow-up за записи – Автоматизирай доставката на връзки към записи чрез Brevo

Сигурност

OAuth 2.0 – Server-to-Server или user-level OAuth автентикация
Верификация на уебхуци – HMAC-SHA256 валидация на подпис
Валидация на URL – Challenge-response верификация за уебхук крайни точки
Scoped разрешения – Заявявай минимално необходимите OAuth обхвати
Ротация на token-и – Server-to-Server token-ите изтичат автоматично (1 час)
Криптиран транспорт – TLS 1.2+ за всички API комуникации

Zoom конектор

Преглед

Функции

Предварителни условия

Автентикация

Server-to-Server OAuth (препоръчително)

OAuth 2.0 (на ниво потребител)

Конфигурация

Основна настройка

Мапване на полета

API крайни точки

Примери с код

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

Синхронизация на участници в срещи

Синхронизация на присъстващи на webinar

Обработка на Zoom уебхуци

Ограничения на заявките

Отстраняване на проблеми

Режим за дебъг

Добри практики

Сигурност

Свързани ресурси

Thanks — you're subscribed.

Zoom конектор

Преглед

Функции

Предварителни условия

Автентикация

Server-to-Server OAuth (препоръчително)

OAuth 2.0 (на ниво потребител)

Конфигурация

Основна настройка

Мапване на полета

API крайни точки

Примери с код

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

Синхронизация на участници в срещи

Синхронизация на присъстващи на webinar

Обработка на Zoom уебхуци

Ограничения на заявките

Отстраняване на проблеми

Режим за дебъг

Добри практики

Сигурност

Свързани ресурси

Subscribe to updates

Thanks — you're subscribed.