Zoom konnektor
Csatlakoztasd a Zoomot a Brevóhoz a Tajo segítségével, hogy automatikusan szinkronizáld az értekezlet-résztvevőket és webinar-látogatókat kapcsolatokként, értekezlet utáni utánkövetési sorozatokat indíts, és elköteleződési mutatókat kövess a marketingautomatizálásaidhoz.
Áttekintés
| Tulajdonság | Érték |
|---|---|
| Platform | Zoom |
| Kategória | Videókonferencia (Egyéni) |
| Telepítés bonyolultsága | Közepes |
| Hivatalos integráció | Nem |
| Szinkronizált adatok | Résztvevők, Események, Webinarok, Kapcsolatok |
| Hitelesítési módszer | OAuth 2.0 / Szerver-szerver OAuth |
Funkciók
- Résztvevő-szinkronizáció – Automatikusan hozz létre Brevo kapcsolatokat az értekezlet-résztvevőkből
- Webinar látogató-rögzítés – Webinar regisztrálók és látogatók szinkronizálása
- Értekezlet-esemény kiváltók – Automatizálások indítása értekezlet kezdetén, végén és felvételi eseményeknél
- Elköteleződés-követés – Részvételi időtartam és részvételi mutatók követése
- Webinar utánkövetés – Célzott e-mail sorozatok indítása webinar látogatottság alapján
- Felvétel értesítések – Felvételi linkek küldése Brevo e-mail kampányokon keresztül
Előfeltételek
Mielőtt elkezdenéd, győződj meg róla, hogy rendelkezel:
- Egy Zoom fiókkal (Pro csomag vagy magasabb)
- Egy Zoom szerver-szerver OAuth alkalmazással vagy OAuth alkalmazással a Zoom App Marketplace oldalon keresztül
- Egy Brevo fiókkal API-hozzáféréssel
- Egy Tajo fiókkal konnektor engedélyekkel
Hitelesítés
Szerver-szerver OAuth (Ajánlott)
# Create a Server-to-Server OAuth app at marketplace.zoom.usexport ZOOM_ACCOUNT_ID=your_account_idexport ZOOM_CLIENT_ID=your_client_idexport ZOOM_CLIENT_SECRET=your_client_secret// Get access token via 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 (Felhasználói szint)
// Authorization URL for user-level 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' });
// Exchange code for tokensconst 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' })});Konfiguráció
Alapbeállítás
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: 17Mezőleképezés
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_SOURCEAPI végpontok
| Végpont | Módszer | Leírás |
|---|---|---|
https://api.zoom.us/v2/users | GET | Felhasználók listázása |
https://api.zoom.us/v2/users/{userId}/meetings | GET | Értekezletek listázása |
https://api.zoom.us/v2/meetings/{meetingId} | GET | Értekezlet részleteinek lekérése |
https://api.zoom.us/v2/past_meetings/{meetingId}/participants | GET | Múltbeli értekezlet résztvevőinek listázása |
https://api.zoom.us/v2/users/{userId}/webinars | GET | Webinarok listázása |
https://api.zoom.us/v2/webinars/{webinarId}/registrants | GET | Webinar regisztrálók listázása |
https://api.zoom.us/v2/webinars/{webinarId}/participants | GET | Webinar résztvevők listázása |
https://api.zoom.us/v2/meetings/{meetingId}/recordings | GET | Értekezlet felvételek lekérése |
https://api.zoom.us/v2/webhooks | POST | Feliratkozás webhookokra |
Kódpéldák
A konnektor inicializálása
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});Értekezlet-résztvevők szinkronizálása
// Retrieve past meeting participantsconst 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 látogatók szinkronizálása
// Get webinar attendees and sync to 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 webhookok kezelése
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');});Ráta-korlátok
| Kategória | Korlát | Megjegyzések |
|---|---|---|
| Könnyű API hívások | 30 kérés/mp | GET felhasználó, értekezlet-infó |
| Közepes API hívások | 20 kérés/mp | Résztvevők, webinarok listázása |
| Nehéz API hívások | 10 kérés/mp | Riportok, felvételek |
| Napi korlát | 5 000+ | Csomag szintjétől függ |
Ráta-korlát fejlécek
A Zoom X-RateLimit-Limit, X-RateLimit-Remaining és Retry-After fejléceket ad vissza. Implementálj visszalépési logikát ezek alapján a 429 hibák elkerüléséhez.
Hibaelhárítás
| Probléma | Ok | Megoldás |
|---|---|---|
| 401 Unauthorized | Token lejárt | Frissítsd a szerver-szerver OAuth tokent |
| Hiányzó résztvevők | Értekezlet még nem ért véget | Várj, amíg az értekezlet véget ér a teljes adatokhoz |
| Webhook-ellenőrzés sikertelen | Rossz titok | Ellenőrizd a webhook titkot a Zoom Marketplace-en |
| Nincs e-mail adat | Vendég résztvevők | Engedélyezd a regisztrációt az e-mailek rögzítéséhez |
| Ráta-korlát 429 | Túl sok kérés | Implementálj exponenciális visszalépést |
Hibakeresési mód
connectors: zoom: debug: true log_level: verbose log_webhooks: trueLegjobb gyakorlatok
- Használj szerver-szerver OAuth-ot – Egyszerűbb hitelesítés felhasználói interakció nélkül
- Engedélyezd a webinar regisztrációt – Szükséges a látogató e-mail-címek rögzítéséhez
- Dolgozz fel az értekezlet vége után – A résztvevői adatok csak az értekezletek befejezése után teljesek
- Szegmentálj eseménytípus szerint – Különböző Brevo listákat rendelj értekezletekhez és webinarokhoz
- Kövesd az elköteleződési mutatókat – Használj időtartamot és csatlakozási időt az érdeklődő-pontozáshoz
- Küldj felvétel-utánkövetéseket – Automatizáld a felvételi link kézbesítését Brevón keresztül
Biztonság
- OAuth 2.0 – Szerver-szerver vagy felhasználói szintű OAuth hitelesítés
- Webhook-ellenőrzés – HMAC-SHA256 aláírás-ellenőrzés
- URL-ellenőrzés – Kihívás-válasz ellenőrzés webhook végpontokhoz
- Hatókörhöz korlátozott jogosultságok – Kérj minimálisan szükséges OAuth hatóköröket
- Token rotáció – A szerver-szerver tokenek automatikusan lejárnak (1 óra)
- Titkosított átvitel – TLS 1.2+ minden API kommunikációhoz