Conector Zoom

Conecte o Zoom ao Brevo através do Tajo para sincronizar automaticamente participantes de reuniões e participantes de webinars como contatos, disparar sequências de follow-up pós-reunião e rastrear métricas de engajamento para suas automações de marketing.

Visão geral

PropriedadeValor
PlataformaZoom
CategoriaVideoconferência (Personalizado)
Complexidade de configuraçãoMédia
Integração oficialNão
Dados sincronizadosParticipantes, Eventos, Webinars, Contatos
Método de autenticaçãoOAuth 2.0 / Server-to-Server OAuth

Recursos

  • Sincronização de participantes - Crie contatos do Brevo automaticamente a partir de participantes de reuniões
  • Captura de participantes de webinar - Sincronize registrantes e participantes de webinar
  • Gatilhos de eventos de reunião - Dispare automações em eventos de início, término e gravação de reuniões
  • Rastreamento de engajamento - Rastreie duração de participação e métricas de envolvimento
  • Follow-up de webinar - Dispare sequências de e-mail direcionadas com base na participação em webinar
  • Notificações de gravação - Envie links de gravação via campanhas de e-mail do Brevo

Pré-requisitos

Antes de começar, certifique-se de ter:

  1. Uma conta Zoom (plano Pro ou superior)
  2. Um app Zoom Server-to-Server OAuth ou app OAuth no Zoom App Marketplace
  3. Uma conta Brevo com acesso à API
  4. Uma conta Tajo com permissões de conector

Autenticação

Server-to-Server OAuth (Recomendado)

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 (Nível de usuário)

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

Configuração

Configuração 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: 17

Mapeamento 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_SOURCE

Endpoints da API

EndpointMétodoDescrição
https://api.zoom.us/v2/usersGETListar usuários
https://api.zoom.us/v2/users/{userId}/meetingsGETListar reuniões
https://api.zoom.us/v2/meetings/{meetingId}GETObter detalhes da reunião
https://api.zoom.us/v2/past_meetings/{meetingId}/participantsGETListar participantes de reuniões passadas
https://api.zoom.us/v2/users/{userId}/webinarsGETListar webinars
https://api.zoom.us/v2/webinars/{webinarId}/registrantsGETListar registrantes de webinar
https://api.zoom.us/v2/webinars/{webinarId}/participantsGETListar participantes de webinar
https://api.zoom.us/v2/meetings/{meetingId}/recordingsGETObter gravações de reunião
https://api.zoom.us/v2/webhooksPOSTAssinar webhooks

Exemplos de código

Inicializar o 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 reunião

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

Sincronizar participantes de webinar

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

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

Limites de taxa

CategoriaLimiteObservações
Chamadas leves à API30 req/segGET de usuário, informações de reunião
Chamadas médias à API20 req/segListar participantes, webinars
Chamadas pesadas à API10 req/segRelatórios, gravações
Limite diário5.000+Depende do nível do plano

Cabeçalhos de limite de taxa

O Zoom retorna os cabeçalhos X-RateLimit-Limit, X-RateLimit-Remaining e Retry-After. Implemente lógica de backoff com base nesses cabeçalhos para evitar erros 429.

Solução de problemas

ProblemaCausaSolução
401 UnauthorizedToken expiradoAtualize o token Server-to-Server OAuth
Participantes ausentesReunião não encerradaAguarde o término da reunião para dados completos
Validação de webhook falhaSecret erradoVerifique o secret do webhook no Zoom Marketplace
Sem dados de e-mailParticipantes convidadosHabilite o registro para capturar e-mails
Limite de taxa 429Muitas requisiçõesImplemente backoff exponencial

Modo de depuração

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

Melhores práticas

  1. Use Server-to-Server OAuth - Autenticação mais simples sem interação do usuário
  2. Habilite o registro de webinar - Necessário para capturar endereços de e-mail dos participantes
  3. Processe após o término da reunião - Os dados de participantes só ficam completos após o término das reuniões
  4. Segmente por tipo de evento - Atribua listas diferentes no Brevo para reuniões e webinars
  5. Rastreie métricas de engajamento - Use duração e horário de entrada para lead scoring
  6. Envie follow-ups de gravação - Automatize a entrega de links de gravação via Brevo

Segurança

  • OAuth 2.0 - Autenticação Server-to-Server ou OAuth em nível de usuário
  • Verificação de webhook - Validação de assinatura HMAC-SHA256
  • Validação de URL - Verificação challenge-response para endpoints de webhook
  • Permissões com escopo - Solicite escopos OAuth mínimos necessários
  • Rotação de tokens - Tokens Server-to-Server expiram automaticamente (1 hora)
  • Transporte criptografado - TLS 1.2+ para todas as comunicações com a API

Recursos relacionados

Subscribe to updates

developer-docs

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

auto-detect
Assistente AI

Olá! Pergunte-me qualquer coisa sobre a documentação.