Zoom konektor
Prepoj Zoom s Brevo cez Tajo na automatickú synchronizáciu účastníkov schôdzí a webinárových návštevníkov ako kontaktov, spúšťanie následných sekvencií po schôdzke a sledovanie metrík zapojenia pre marketingové automatizácie.
Prehľad
| Vlastnosť | Hodnota |
|---|---|
| Platforma | Zoom |
| Kategória | Videokonferencie (Vlastná) |
| Zložitosť nastavenia | Stredná |
| Oficiálna integrácia | Nie |
| Synchronizované dáta | Účastníci, Udalosti, Webináre, Kontakty |
| Metóda autentifikácie | OAuth 2.0 / Server-to-Server OAuth |
Funkcie
- Synchronizácia účastníkov - Automaticky vytváraj kontakty Brevo z účastníkov schôdzí
- Zachytávanie webinárových návštevníkov - Synchronizuj registrovaných a prítomných na webinároch
- Triggery udalostí schôdzí - Spúšťaj automatizácie pri začatí, ukončení a nahrávacích udalostiach schôdzí
- Sledovanie zapojenia - Sleduj dĺžku účasti a metriky participácie
- Následné správy po webinári - Spúšťaj cielené e-mailové sekvencie na základe účasti na webinári
- Notifikácie nahrávok - Posielajaj odkazy na nahrávky cez e-mailové kampane Brevo
Predpoklady
Predtým, než začneš, uisti sa, že máš:
- Zoom účet (plán Pro alebo vyšší)
- Zoom Server-to-Server OAuth aplikáciu alebo OAuth aplikáciu cez Zoom App Marketplace
- Brevo účet s API prístupom
- Tajo účet s oprávneniami pre konektory
Autentifikácia
Server-to-Server OAuth (odporúčané)
# 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 (na úrovni používateľa)
// 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ácia
Základné nastavenie
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: 17Mapovanie polí
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 endpointy
| Endpoint | Metóda | Popis |
|---|---|---|
https://api.zoom.us/v2/users | GET | Zoznam používateľov |
https://api.zoom.us/v2/users/{userId}/meetings | GET | Zoznam schôdzí |
https://api.zoom.us/v2/meetings/{meetingId} | GET | Detaily schôdze |
https://api.zoom.us/v2/past_meetings/{meetingId}/participants | GET | Zoznam účastníkov minulej schôdze |
https://api.zoom.us/v2/users/{userId}/webinars | GET | Zoznam webinárov |
https://api.zoom.us/v2/webinars/{webinarId}/registrants | GET | Zoznam registrovaných na webinár |
https://api.zoom.us/v2/webinars/{webinarId}/participants | GET | Zoznam účastníkov webinára |
https://api.zoom.us/v2/meetings/{meetingId}/recordings | GET | Záznamy schôdze |
https://api.zoom.us/v2/webhooks | POST | Prihlásenie na odber webhookov |
Ukážky kódu
Inicializácia 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});Synchronizácia účastníkov schôdze
// 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] }); }}Synchronizácia návštevníkov webinára
// 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] });}Spracovanie Zoom webhookov
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');});Obmedzenia rýchlosti
| Kategória | Limit | Poznámky |
|---|---|---|
| Ľahké API volania | 30 požiadaviek/sek | GET používateľ, informácie o schôdzi |
| Stredné API volania | 20 požiadaviek/sek | Zoznam účastníkov, webinárov |
| Ťažké API volania | 10 požiadaviek/sek | Reporty, nahrávky |
| Denný limit | 5 000+ | Závisí od úrovne plánu |
Hlavičky limitov rýchlosti
Zoom vracia hlavičky X-RateLimit-Limit, X-RateLimit-Remaining a Retry-After. Implementuj logiku backoff na základe týchto hlavičiek na vyhnutie sa chybám 429.
Riešenie problémov
| Problém | Príčina | Riešenie |
|---|---|---|
| 401 Unauthorized | Vypršaný token | Obnov Server-to-Server OAuth token |
| Chýbajúci účastníci | Schôdza neskončila | Počkaj, kým schôdza neskončí pre úplné dáta |
| Validácia webhooku zlyhá | Nesprávny secret | Overte secret webhooku v Zoom Marketplace |
| Žiadne dáta e-mailu | Hostia bez registrácie | Povol registráciu na zachytávanie e-mailov |
| Limit rýchlosti 429 | Príliš veľa požiadaviek | Implementuj exponenciálny backoff |
Debug režim
connectors: zoom: debug: true log_level: verbose log_webhooks: trueOdporúčané postupy
- Použi Server-to-Server OAuth - Jednoduchšia autentifikácia bez interakcie používateľa
- Povol registráciu na webinár - Potrebné na zachytávanie e-mailových adries návštevníkov
- Spracovávaj po skončení schôdze - Dáta účastníkov sú kompletné až po skončení schôdzí
- Segmentuj podľa typu udalosti - Priraďuj rôzne zoznamy Brevo pre schôdze vs. webináre
- Sleduj metriky zapojenia - Použi dĺžku trvania a čas pripojenia pre skórovanie leadov
- Posielajaj následné správy s nahrávkami - Automatizuj doručenie odkazov na nahrávky cez Brevo
Bezpečnosť
- OAuth 2.0 - Server-to-Server alebo OAuth autentifikácia na úrovni používateľa
- Overenie webhookov - Validácia podpisu HMAC-SHA256
- Validácia URL - Overenie challenge-response pre webhookové endpointy
- Scoped oprávnenia - Požaduj minimálne potrebné OAuth scopy
- Rotácia tokenov - Server-to-Server tokeny automaticky vypršiavajú (1 hodina)
- Šifrovaný transport - TLS 1.2+ pre všetku API komunikáciu