Zoom Connector

Verbinde Zoom über Tajo mit Brevo, um Meeting-Teilnehmende und Webinar-Attendees automatisch als Kontakte zu synchronisieren, Post-Meeting-Follow-up-Sequenzen auszulösen und Engagement-Metriken für deine Marketing-Automationen zu tracken.

Überblick

EigenschaftWert
PlattformZoom
KategorieVideo Conferencing (Custom)
EinrichtungsaufwandMittel
Offizielle IntegrationNein
Synchronisierte DatenTeilnehmende, Events, Webinare, Kontakte
AuthentifizierungOAuth 2.0 / Server-to-Server OAuth

Funktionen

  • Teilnehmer:innen-Synchronisation - Erstelle Brevo-Kontakte automatisch aus Meeting-Teilnehmenden
  • Webinar-Attendee-Erfassung - Synchronisiere Webinar-Registrant:innen und -Attendees
  • Meeting-Event-Trigger - Löse Automationen bei Meeting-Start, -Ende und Recording-Events aus
  • Engagement-Tracking - Tracke Teilnahmedauer und Participation-Metriken
  • Webinar-Follow-up - Löse gezielte E-Mail-Sequenzen basierend auf Webinar-Teilnahme aus
  • Recording-Benachrichtigungen - Verschicke Aufzeichnungs-Links über Brevo-E-Mail-Kampagnen

Voraussetzungen

Bevor du beginnst, stelle sicher, dass du Folgendes hast:

  1. Ein Zoom-Konto (Pro-Plan oder höher)
  2. Eine Zoom Server-to-Server OAuth App oder OAuth App über den Zoom App Marketplace
  3. Ein Brevo-Konto mit API-Zugriff
  4. Ein Tajo-Konto mit Connector-Berechtigungen

Authentifizierung

Server-to-Server OAuth (empfohlen)

Terminal window
# 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 (User-Level)

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

Konfiguration

Grundeinrichtung

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

Feld-Mapping

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-Endpoints

EndpointMethodeBeschreibung
https://api.zoom.us/v2/usersGETNutzer:innen auflisten
https://api.zoom.us/v2/users/{userId}/meetingsGETMeetings auflisten
https://api.zoom.us/v2/meetings/{meetingId}GETMeeting-Details abrufen
https://api.zoom.us/v2/past_meetings/{meetingId}/participantsGETTeilnehmende vergangener Meetings auflisten
https://api.zoom.us/v2/users/{userId}/webinarsGETWebinare auflisten
https://api.zoom.us/v2/webinars/{webinarId}/registrantsGETWebinar-Registrant:innen auflisten
https://api.zoom.us/v2/webinars/{webinarId}/participantsGETWebinar-Teilnehmende auflisten
https://api.zoom.us/v2/meetings/{meetingId}/recordingsGETMeeting-Aufzeichnungen abrufen
https://api.zoom.us/v2/webhooksPOSTWebhooks abonnieren

Code-Beispiele

Connector initialisieren

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

Meeting-Teilnehmende synchronisieren

// 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-Attendees synchronisieren

// 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-Webhooks verarbeiten

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

Rate Limits

KategorieLimitHinweise
Light-API-Aufrufe30 Anfr./Sek.GET User, Meeting-Infos
Medium-API-Aufrufe20 Anfr./Sek.Teilnehmende, Webinare auflisten
Heavy-API-Aufrufe10 Anfr./Sek.Reports, Aufzeichnungen
Tageslimit5.000+Abhängig vom Tariflevel

Rate-Limit-Header

Zoom liefert die Header X-RateLimit-Limit, X-RateLimit-Remaining und Retry-After. Implementiere Backoff-Logik basierend auf diesen Headern, um 429-Fehler zu vermeiden.

Fehlerbehebung

ProblemUrsacheLösung
401 UnauthorizedToken abgelaufenServer-to-Server OAuth-Token erneuern
Fehlende TeilnehmendeMeeting noch nicht beendetAuf vollständige Daten nach Meeting-Ende warten
Webhook-Validierung schlägt fehlFalsches SecretWebhook-Secret im Zoom Marketplace prüfen
Keine E-Mail-DatenGast-TeilnehmendeRegistrierung aktivieren, um E-Mails zu erfassen
Rate Limit 429Zu viele AnfragenExponential Backoff implementieren

Debug-Modus

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

Best Practices

  1. Server-to-Server OAuth nutzen - Einfachere Authentifizierung ohne Nutzer:innen-Interaktion
  2. Webinar-Registrierung aktivieren - Erforderlich, um E-Mail-Adressen der Attendees zu erfassen
  3. Nach Meeting-Ende verarbeiten - Teilnehmende-Daten sind erst nach Meeting-Ende vollständig
  4. Nach Event-Typ segmentieren - Weise unterschiedliche Brevo-Listen für Meetings vs. Webinare zu
  5. Engagement-Metriken tracken - Nutze Dauer und Join-Zeit fürs Lead Scoring
  6. Recording-Follow-ups senden - Automatisiere die Zustellung von Aufzeichnungs-Links über Brevo

Sicherheit

  • OAuth 2.0 - Server-to-Server- oder User-Level-OAuth-Authentifizierung
  • Webhook-Verifizierung - HMAC-SHA256-Signatur-Validierung
  • URL-Validierung - Challenge-Response-Verifizierung für Webhook-Endpoints
  • Gescopte Berechtigungen - Fordere minimal erforderliche OAuth-Scopes an
  • Token-Rotation - Server-to-Server-Tokens laufen automatisch ab (1 Stunde)
  • Verschlüsselter Transport - TLS 1.2+ für alle API-Kommunikationen

Verwandte Ressourcen

Subscribe to updates

developer-docs

Drop your email or phone number — we'll send you what matters next.

auto-detect
AI-Assistent

Hallo! Fragen Sie mich alles über die Dokumentation.