Zoom konektor

Poveži Zoom sa Brevo putem Tajo da automatski sinhronizuješ učesnike sastanaka i posetioce webinara kao kontakte, pokrećeš sekvence praćenja nakon sastanka i pratiš metrike angažovanja za tvoje marketing automatizacije.

Pregled

Svojstvo	Vrednost
Platforma	Zoom
Kategorija	Video konferencije (Prilagođeno)
Složenost podešavanja	Srednje
Zvanična integracija	Ne
Sinhronizovani podaci	Učesnici, Događaji, Webinari, Kontakti
Metod autentifikacije	OAuth 2.0 / Server-to-Server OAuth

Karakteristike

Sinhronizacija učesnika - Automatsko kreiranje Brevo kontakata iz učesnika sastanka
Hvatanje posetilaca webinara - Sinhronizacija registranata i posetilaca webinara
Okidači događaja sastanka - Pokretanje automatizacija pri početku, završetku i događajima snimanja sastanka
Praćenje angažovanja - Praćenje trajanja prisustva i metrika učešća
Praćenje webinara - Pokretanje ciljanih email sekvenci prema prisustvu webinaru
Obaveštenja o snimcima - Slanje linkova za snimke putem Brevo email kampanja

Preduslovi

Pre nego što započneš, proveri da imaš:

Zoom nalog (Pro plan ili viši)
Zoom Server-to-Server OAuth aplikaciju ili OAuth aplikaciju putem Zoom App Marketplace
Brevo nalog sa API pristupom
Tajo nalog sa dozvolama konektora

Autentifikacija

Server-to-Server OAuth (preporučeno)

# 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 (na nivou korisnika)

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

Konfiguracija

Osnovno podešavanje

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 endpointi

Endpoint	Metoda	Opis
`https://api.zoom.us/v2/users`	GET	Listanje korisnika
`https://api.zoom.us/v2/users/{userId}/meetings`	GET	Listanje sastanaka
`https://api.zoom.us/v2/meetings/{meetingId}`	GET	Dohvatanje detalja sastanka
`https://api.zoom.us/v2/past_meetings/{meetingId}/participants`	GET	Listanje učesnika prošlih sastanaka
`https://api.zoom.us/v2/users/{userId}/webinars`	GET	Listanje webinara
`https://api.zoom.us/v2/webinars/{webinarId}/registrants`	GET	Listanje registranata webinara
`https://api.zoom.us/v2/webinars/{webinarId}/participants`	GET	Listanje učesnika webinara
`https://api.zoom.us/v2/meetings/{meetingId}/recordings`	GET	Dohvatanje snimaka sastanka
`https://api.zoom.us/v2/webhooks`	POST	Pretplata na webhook-ove

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

Sinhronizacija učesnika sastanka

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

Sinhronizacija posetilaca webinara

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

Obrada Zoom webhook-ova

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

Ograničenja brzine

Kategorija	Limit	Napomene
Laki API pozivi	30 zahteva/sek	GET informacije o korisniku i sastanku
Srednji API pozivi	20 zahteva/sek	Listanje učesnika, webinara
Teški API pozivi	10 zahteva/sek	Izveštaji, snimci
Dnevni limit	5.000+	Zavisi od nivoa plana

Headeri ograničenja brzine

Zoom vraća headere X-RateLimit-Limit, X-RateLimit-Remaining i Retry-After. Implementiraj logiku usporavanja zasnovanu na ovim headerima da izbjegneš 429 greške.

Rešavanje problema

Problem	Uzrok	Rešenje
401 Unauthorized	Token istekao	Osvježi Server-to-Server OAuth token
Nedostaju učesnici	Sastanak nije završen	Sačekaj da se sastanak završi za kompletne podatke
Validacija webhook-a neuspešna	Pogrešna tajna	Verifikuj webhook tajnu u Zoom Marketplace-u
Nema podataka o email-u	Gostujući učesnici	Omogući registraciju za hvatanje email adresa
Ograničenje brzine 429	Previše zahteva	Implementiraj eksponencijalno usporavanje

Debug režim

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

Najbolje prakse

Koristi Server-to-Server OAuth - Jednostavnija autentifikacija bez interakcije korisnika
Omogući registraciju webinara - Neophodno za hvatanje email adresa posetilaca
Obradi nakon završetka sastanka - Podaci o učesnicima su kompletni tek kada se sastanak završi
Segmentiraj prema tipu događaja - Dodeli različite Brevo liste za sastanke i webinare
Prati metrike angažovanja - Koristi trajanje i vreme ulaska za ocenjivanje potencijalnih kupaca
Šalji nastavak sa snimcima - Automatizuj isporuku linkova za snimke putem Brevo

Bezbednost

OAuth 2.0 - Server-to-Server ili OAuth autentifikacija na nivou korisnika
Verifikacija webhook-ova - HMAC-SHA256 validacija potpisa
Validacija URL-a - Verifikacija izazov-odgovor za webhook endpointe
Skopovane dozvole - Zahtevaj minimalne potrebne OAuth skopove
Rotacija tokena - Server-to-Server tokeni automatski ističu (1 sat)
Enkriptovani transport - TLS 1.2+ za svu API komunikaciju

Zoom konektor

Pregled

Karakteristike

Preduslovi

Autentifikacija

Server-to-Server OAuth (preporučeno)

OAuth 2.0 (na nivou korisnika)

Konfiguracija

Osnovno podešavanje

Mapiranje polja

API endpointi

Primeri koda

Inicijalizacija konektora

Sinhronizacija učesnika sastanka

Sinhronizacija posetilaca webinara

Obrada Zoom webhook-ova

Ograničenja brzine

Rešavanje problema

Debug režim

Najbolje prakse

Bezbednost

Povezani resursi

Thanks — you're subscribed.

Zoom konektor

Pregled

Karakteristike

Preduslovi

Autentifikacija

Server-to-Server OAuth (preporučeno)

OAuth 2.0 (na nivou korisnika)

Konfiguracija

Osnovno podešavanje

Mapiranje polja

API endpointi

Primeri koda

Inicijalizacija konektora

Sinhronizacija učesnika sastanka

Sinhronizacija posetilaca webinara

Obrada Zoom webhook-ova

Ograničenja brzine

Rešavanje problema

Debug režim

Najbolje prakse

Bezbednost

Povezani resursi

Subscribe to updates

Thanks — you're subscribed.