Conector de Zoom
Conecta Zoom con Brevo a través de Tajo para sincronizar automáticamente a los participantes de reuniones y asistentes a webinars como contactos, disparar secuencias de seguimiento post-reunión y rastrear métricas de engagement para tus automatizaciones de marketing.
Resumen
| Propiedad | Valor |
|---|---|
| Plataforma | Zoom |
| Categoría | Videoconferencia (Personalizada) |
| Complejidad de configuración | Media |
| Integración oficial | No |
| Datos sincronizados | Participantes, Eventos, Webinars, Contactos |
| Método de autenticación | OAuth 2.0 / Server-to-Server OAuth |
Funcionalidades
- Sincronización de participantes - Crea automáticamente contactos de Brevo a partir de los participantes en reuniones
- Captura de asistentes a webinars - Sincroniza los registrantes y asistentes a webinars
- Triggers por evento de reunión - Dispara automatizaciones al iniciar, finalizar o grabar una reunión
- Seguimiento de engagement - Rastrea la duración de asistencia y métricas de participación
- Seguimiento post-webinar - Dispara secuencias de email dirigidas según la asistencia al webinar
- Notificaciones de grabaciones - Envía enlaces de grabaciones a través de campañas de email de Brevo
Requisitos previos
Antes de empezar, asegúrate de tener:
- Una cuenta de Zoom (plan Pro o superior)
- Una app Server-to-Server OAuth de Zoom o una app OAuth en el Zoom App Marketplace
- Una cuenta de Brevo con acceso a la API
- Una cuenta de Tajo con permisos de conector
Autenticación
Server-to-Server OAuth (recomendado)
# 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 (a nivel de usuario)
// 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' })});Configuración
Configuración básica
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: 17Asignación de campos
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_SOURCEEndpoints de la API
| Endpoint | Método | Descripción |
|---|---|---|
https://api.zoom.us/v2/users | GET | Listar usuarios |
https://api.zoom.us/v2/users/{userId}/meetings | GET | Listar reuniones |
https://api.zoom.us/v2/meetings/{meetingId} | GET | Obtener detalles de la reunión |
https://api.zoom.us/v2/past_meetings/{meetingId}/participants | GET | Listar participantes de una reunión pasada |
https://api.zoom.us/v2/users/{userId}/webinars | GET | Listar webinars |
https://api.zoom.us/v2/webinars/{webinarId}/registrants | GET | Listar registrantes del webinar |
https://api.zoom.us/v2/webinars/{webinarId}/participants | GET | Listar participantes del webinar |
https://api.zoom.us/v2/meetings/{meetingId}/recordings | GET | Obtener grabaciones de la reunión |
https://api.zoom.us/v2/webhooks | POST | Suscribirse a webhooks |
Ejemplos de código
Inicializar el conector
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});Sincronizar participantes de reuniones
// 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] }); }}Sincronizar asistentes a webinars
// 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] });}Gestionar webhooks de Zoom
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');});Límites de velocidad
| Categoría | Límite | Notas |
|---|---|---|
| Llamadas API ligeras | 30 req/s | GET de usuario, info de reunión |
| Llamadas API medias | 20 req/s | Listar participantes, webinars |
| Llamadas API pesadas | 10 req/s | Informes, grabaciones |
| Límite diario | 5.000+ | Depende del nivel del plan |
Cabeceras de límite de velocidad
Zoom devuelve las cabeceras X-RateLimit-Limit, X-RateLimit-Remaining y Retry-After. Implementa la lógica de backoff basándote en estas cabeceras para evitar errores 429.
Resolución de problemas
| Problema | Causa | Solución |
|---|---|---|
| 401 Unauthorized | Token expirado | Refresca el token Server-to-Server OAuth |
| Participantes que faltan | La reunión no ha terminado | Espera a que finalice la reunión para obtener los datos completos |
| Fallo en la validación del webhook | Secret incorrecto | Verifica el webhook secret en el Zoom Marketplace |
| Sin datos de email | Participantes invitados | Activa el registro para capturar emails |
| Rate limit 429 | Demasiadas peticiones | Aplica exponential backoff |
Modo depuración
connectors: zoom: debug: true log_level: verbose log_webhooks: trueBuenas prácticas
- Usa Server-to-Server OAuth - Autenticación más sencilla sin interacción del usuario
- Activa el registro en los webinars - Necesario para capturar direcciones de email de los asistentes
- Procesa tras el final de la reunión - Los datos de participantes solo están completos al finalizar la reunión
- Segmenta por tipo de evento - Asigna distintas listas de Brevo para reuniones y webinars
- Rastrea métricas de engagement - Usa la duración y el momento de conexión para puntuar leads
- Envía seguimientos con la grabación - Automatiza el envío del enlace de grabación vía Brevo
Seguridad
- OAuth 2.0 - Autenticación Server-to-Server o OAuth a nivel de usuario
- Verificación de webhooks - Validación de firma HMAC-SHA256
- Validación de URL - Verificación challenge-response para endpoints de webhook
- Permisos limitados - Solicita los scopes de OAuth mínimos necesarios
- Rotación de tokens - Los tokens Server-to-Server caducan automáticamente (1 hora)
- Transporte cifrado - TLS 1.2+ para todas las comunicaciones con la API