Zoom Konektor

Povežite Zoom s Brevom putem Taja kako biste automatski sinkronizirali sudionike sastanaka i polaznike webinara kao kontakte, pokrenuli sekvence praćenja nakon sastanka i pratili metrike angažmana za vaše marketinške automatizacije.

Pregled

Svojstvo	Vrijednost
Platforma	Zoom
Kategorija	Video konferencije (Prilagođeno)
Složenost postavljanja	Srednje
Službena integracija	Ne
Sinkronizirani podaci	Sudionici, Događaji, Webinari, Kontakti
Metoda autentifikacije	OAuth 2.0 / Server-to-Server OAuth

Značajke

Sinkronizacija sudionika - Automatsko kreiranje Brevo kontakata iz sudionika sastanka
Hvatanje polaznika webinara - Sinkronizacija registriranih i polaznika webinara
Okidači događaja sastanka - Pokretanje automatizacija pri pokretanju, završetku i događajima snimanja
Praćenje angažmana - Praćenje trajanja prisustvovanja i metrika sudjelovanja
Praćenje webinara - Pokretanje ciljanih emailskih sekvenci na temelju prisustvovanja webinaru
Obavijesti o snimkama - Slanje linkova snimki putem Brevo emailskih kampanja

Preduvjeti

Prije nego što počnete, osigurajte da imate:

Zoom račun (Pro plan ili viši)
Zoom Server-to-Server OAuth aplikaciju ili OAuth aplikaciju putem Zoom App Marketplace
Brevo račun s API pristupom
Tajo račun s dozvolama konektora

Autentifikacija

Server-to-Server OAuth (Preporučeno)

# Kreirajte Server-to-Server OAuth aplikaciju na marketplace.zoom.us
export ZOOM_ACCOUNT_ID=your_account_id
export ZOOM_CLIENT_ID=your_client_id
export ZOOM_CLIENT_SECRET=your_client_secret

// Dohvatite pristupni token putem 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 (Na razini korisnika)

// URL autorizacije za OAuth na razini korisnika
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'
  });

// Zamijenite kod za tokene
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'
  })
});

Konfiguracija

Osnovna konfiguracija

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

Mapiranje polja

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 krajnje točke

Krajnja točka	Metoda	Opis
`https://api.zoom.us/v2/users`	GET	Popis korisnika
`https://api.zoom.us/v2/users/{userId}/meetings`	GET	Popis sastanaka
`https://api.zoom.us/v2/meetings/{meetingId}`	GET	Detalji sastanka
`https://api.zoom.us/v2/past_meetings/{meetingId}/participants`	GET	Popis prošlih sudionika
`https://api.zoom.us/v2/users/{userId}/webinars`	GET	Popis webinara
`https://api.zoom.us/v2/webinars/{webinarId}/registrants`	GET	Popis registriranih webinara
`https://api.zoom.us/v2/webinars/{webinarId}/participants`	GET	Popis sudionika webinara
`https://api.zoom.us/v2/meetings/{meetingId}/recordings`	GET	Dohvati snimke sastanka
`https://api.zoom.us/v2/webhooks`	POST	Pretplatite se na webhookove

Primjeri koda

Inicijalizacija konektora

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

Sinkronizacija sudionika sastanka

// Dohvatite prošle sudionike sastanka
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]
    });
  }
}

Sinkronizacija polaznika webinara

// Dohvatite polaznike webinara i sinkronizirajte u 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]
  });
}

Rukovanje Zoom webhookovima

app.post('/webhooks/zoom', async (req, res) => {
  // Upravljajte Zoom URL validacijskim izazovom
  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
    });
  }

  // Verificirajte potpis webhookova
  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');
});

Ograničenja brzine

Kategorija	Ograničenje	Napomene
Lagani API pozivi	30 zah./s	GET korisnik, informacije o sastanku
Srednji API pozivi	20 zah./s	Popis sudionika, webinara
Teški API pozivi	10 zah./s	Izvještaji, snimke
Dnevno ograničenje	5.000+	Ovisi o razini plana

Zaglavlja ograničenja brzine

Zoom vraća zaglavlja X-RateLimit-Limit, X-RateLimit-Remaining i Retry-After. Implementirajte logiku povratka temeljenu na ovim zaglavljima kako biste izbjegli greške 429.

Rješavanje problema

Problem	Uzrok	Rješenje
401 Unauthorized	Token istekao	Osvježite Server-to-Server OAuth token
Nedostaju sudionici	Sastanak nije završen	Pričekajte dok ne završi sastanak za potpune podatke
Validacija webhookova neuspješna	Pogrešna tajna	Verificirajte tajnu webhookova u Zoom Marketplace
Nema podataka o e-mailu	Gostujući sudionici	Omogućite registraciju za hvatanje e-mailova
Ograničenje brzine 429	Previše zahtjeva	Implementirajte eksponencijalni povratak

Način otklanjanja grešaka

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

Preporučene prakse

Koristite Server-to-Server OAuth - Jednostavnija autentifikacija bez korisničke interakcije
Omogućite registraciju webinara - Potrebno za hvatanje e-mail adresa polaznika
Obrađujte nakon završetka sastanka - Podaci o sudionicima potpuni su tek nakon završetka sastanaka
Segmentirajte prema vrsti događaja - Dodijelite različite Brevo popise za sastanke i webinare
Pratite metrike angažmena - Koristite trajanje i vrijeme pridruživanja za ocjenjivanje potencijalnih klijenata
Šaljite praćenja snimki - Automatizirajte isporuku linkova snimki putem Breva

Sigurnost

OAuth 2.0 - Server-to-Server ili OAuth autentifikacija na razini korisnika
Verifikacija webhookova - HMAC-SHA256 validacija potpisa
Validacija URL-a - Verifikacija izazov-odgovor za krajnje točke webhookova
Opsežene dozvole - Zatražite minimalno potrebne OAuth opsege
Rotacija tokena - Server-to-Server tokeni automatski istječu (1 sat)
Šifrirani transport - TLS 1.2+ za svu API komunikaciju

Zoom Konektor

Pregled

Značajke

Preduvjeti

Autentifikacija

Server-to-Server OAuth (Preporučeno)

OAuth 2.0 (Na razini korisnika)

Konfiguracija

Osnovna konfiguracija

Mapiranje polja

API krajnje točke

Primjeri koda

Inicijalizacija konektora

Sinkronizacija sudionika sastanka

Sinkronizacija polaznika webinara

Rukovanje Zoom webhookovima

Ograničenja brzine

Rješavanje problema

Način otklanjanja grešaka

Preporučene prakse

Sigurnost

Povezani resursi

Thanks — you're subscribed.

Zoom Konektor

Pregled

Značajke

Preduvjeti

Autentifikacija

Server-to-Server OAuth (Preporučeno)

OAuth 2.0 (Na razini korisnika)

Konfiguracija

Osnovna konfiguracija

Mapiranje polja

API krajnje točke

Primjeri koda

Inicijalizacija konektora

Sinkronizacija sudionika sastanka

Sinkronizacija polaznika webinara

Rukovanje Zoom webhookovima

Ograničenja brzine

Rješavanje problema

Način otklanjanja grešaka

Preporučene prakse

Sigurnost

Povezani resursi

Subscribe to updates

Thanks — you're subscribed.