Documentación de integración con Zoom

Descripción general

Tiveko permite a los organizadores de eventos conectar su cuenta de Zoom para crear reuniones o webinars desde el panel de administración y habilitar el seguimiento automático de asistencia en eventos en línea e híbridos.

Requisitos previos

• Una cuenta de Tiveko con rol de Administrador u Organizador
• Una cuenta de Zoom (Pro, Business o Enterprise)
• Al menos un evento creado con modalidad En línea o Híbrido

Conectar tu cuenta de Zoom

1. Inicia sesión en Tiveko y ve a Configuración > Zoom
2. Haz clic en Conectar Zoom
3. Serás redirigido a Zoom para autorizar el acceso
4. Acepta los permisos solicitados
5. Serás redirigido de vuelta a Tiveko con un mensaje de confirmación

Una vez conectado, puedes activar o desactivar la integración sin desconectarla usando el interruptor en la página de Zoom.

Crear una reunión o webinar

1. Ve al detalle de tu evento
2. En la sección de fechas, localiza una fecha con modalidad En línea o Híbrido
3. Haz clic en el botón de Zoom junto a la fecha
4. Selecciona el tipo de sesión:
   • Reunión — para sesiones interactivas de hasta 1,000 participantes
   • Webinar — para presentaciones de hasta 10,000 participantes (requiere licencia de webinar en Zoom)
5. La sesión se crea automáticamente en tu cuenta de Zoom y se vincula a la fecha del evento
6. Los detalles (ID, enlace de acceso, contraseña) se guardan automáticamente

Desde el mismo botón de Zoom puedes:

• Copiar el enlace de acceso para compartirlo
• Abrir la reunión directamente en Zoom
• Eliminar la sesión si necesitas recrearla

Enlace de acceso en el email de confirmación

Cuando un asistente compra un boleto en línea, el enlace de Zoom (join_url) se incluye automáticamente en el email de confirmación de compra. No necesitas enviar el enlace manualmente.

Seguimiento automático de asistencia

Una vez vinculada una reunión o webinar, la asistencia se sincroniza de dos formas:

Sincronización en tiempo real

Cuando una reunión o webinar finaliza en Zoom, se envía una notificación automática (webhook) a Tiveko que inicia la sincronización de participantes inmediatamente. Los datos de participantes están disponibles aproximadamente 30 minutos después de que la sesión termina.

Sincronización diaria (respaldo)

Además del webhook, Tiveko ejecuta una tarea diaria a las 8:00 AM UTC que busca sesiones finalizadas que aún no se hayan sincronizado. Esto cubre casos donde el webhook no se entregó correctamente.

Sincronización manual

Desde el botón de Zoom de la fecha del evento, selecciona Ver asistencia para:

• Ejecutar una sincronización manual en cualquier momento
• Ver la tabla de participantes con nombre, email, duración y estado
• Verificar cuántos participantes coinciden con compras de boletos

Cómo funciona el cruce de asistencia

1. Se obtiene la lista de participantes desde la API de Zoom
2. Cada participante se cruza por correo electrónico con las compras de boletos con modalidad en línea
3. Si coincide, el boleto se marca como "asistió" automáticamente
4. Los participantes sin boleto aparecen como "Sin coincidencia" en el reporte

Datos que se recopilan

Tiveko accede a la siguiente información de Zoom:

• Correo electrónico del participante — para cruzar con compras de boletos
• Nombre del participante — para identificación en el reporte de asistencia
• Duración de participación — para verificar asistencia efectiva
• ID de la reunión/webinar — para vincular con la fecha del evento

Esta información se utiliza exclusivamente para el seguimiento de asistencia y no se comparte con terceros.

Desconectar Zoom

1. Ve a Configuración > Zoom
2. Haz clic en Desconectar
3. Se eliminarán los tokens de acceso almacenados
4. Las reuniones vinculadas dejarán de sincronizar asistencia

Solo el propietario de la organización puede desconectar la integración.

Permisos solicitados

Tiveko solicita los siguientes permisos de Zoom:

Preguntas frecuentes

¿Se sincroniza la asistencia en tiempo real?

La sincronización se inicia automáticamente cuando la reunión o webinar termina en Zoom. Los datos de participantes están disponibles aproximadamente 30 minutos después. Como respaldo, también se ejecuta una sincronización diaria.

¿Qué pasa si un participante no tiene boleto?

Los participantes que no coincidan con ninguna compra de boleto aparecerán como "Sin coincidencia" en el reporte de asistencia.

¿Puedo vincular la misma reunión a múltiples fechas?

No. Cada reunión o webinar de Zoom se vincula a una sola fecha de evento.

¿Funciona con Zoom gratuito?

Las funciones básicas de reunión funcionan, pero los webinars requieren una licencia de Zoom con complemento de webinar.

¿Puedo sincronizar asistencia manualmente?

Sí. Desde el botón de Zoom de la fecha del evento, selecciona Ver asistencia y haz clic en Sincronizar para ejecutar la sincronización en cualquier momento.

Soporte

Si tienes problemas con la integración de Zoom, contáctanos en soporte@tiveko.com.