Saltearse al contenido
Nappai Documentation

Zoom

El componente Zoom en el sistema de automatización Nappai te permite interactuar directamente con tu cuenta de Zoom. Su objetivo principal es automatizar la gestión de reuniones, facilitando tareas como programar nuevas citas, obtener detalles de reuniones existentes, manejar grabaciones y transcripciones, y más.

Actúa como un puente entre tus flujos de trabajo de Nappai y la plataforma de videoconferencias, permitiendo que las automatizaciones se ejecuten en segundo plano para agilizar tus procesos de gestión de datos y colaboración.

¿Cómo funciona?

Internamente, este componente se conecta a la API de Zoom. Cuando configuras una operación, el sistema traduce tus entradas (como la fecha, hora y participantes) en una solicitud técnica que Zoom comprende.

Por ejemplo, si decides “Crear una Reunión”, Nappai toma la información que ingresas y la envía a los servidores de Zoom para crear el evento. Luego, Zoom responde confirmando el éxito y proporcionando los enlaces necesarios para unirse. Todo este proceso técnico de comunicación se maneja automáticamente por el componente, dejándote a ti la tarea de solo definir los parámetros (como la hora o el tema) en una interfaz sencilla.

Conexión y Credenciales

Este componente requiere configurar previamente una credencial en el panel de Nappai para poder interactuar con el servicio externo de Zoom:

  1. Dirígete a la sección de Credenciales en tu panel de Nappai.
  2. Crea una nueva credencial del tipo Zoom.
    • Para hacer esto, debes ir al Zoom App Marketplace, registrar una aplicación ‘Server-to-Server OAuth’ y asegurarte de otorgar los permisos necesarios.
    • Guarda los datos que te pide el sistema: Account ID, Client ID y Client Secret.
  3. En tu flujo de trabajo en Nappai, selecciona la credencial que acabas de crear en el campo de entrada Credential de este nodo.

Nota: Una vez configurada la credencial, no necesitas repetir estos pasos; el componente recordará tu conexión.

Entradas

Campos de Entrada

Los siguientes campos están disponibles para configurar este componente. Cada campo puede estar visible según la operación que elijas:

  • Operation: Define qué acción quieres realizar con Zoom. Es el campo más importante ya que determina qué otras opciones verás disponibles. Puedes seleccionar entre crear reuniones, obtener detalles, actualizarlas o eliminarlas. Todas las operaciones funcionan con cuentas gratuitas de Zoom.
  • Get Meetings Mode: (Visible solo en operaciones de consulta) Elige cómo quieres buscar las reuniones: ‘By ID’ para obtener una reunión específica usando su número único, o ‘List All’ para obtener una lista de todas las reuniones de un usuario basadas en filtros.
  • User ID: El correo electrónico de la cuenta de Zoom (ej. user@company.com) o el identificador de usuario (ej. z9jm...). También puedes escribir 'me' si te refieres a la cuenta autenticada actualmente. Es obligatorio para crear reuniones o listar todas.
  • Meeting ID: El número único de la reunión (9-11 dígitos) o su código UUID. Lo puedes encontrar en la URL de la reunión en Zoom o en los resultados de la operación “List All”. Es útil para obtener detalles específicos o gestionar grabaciones.
  • Meeting Topic: El título o nombre que aparecerá en el calendario de los participantes (ej. “Reunión Semanal de Equipo”, “Demo Cliente Alpha”).
  • Meeting Type: Define el tipo de reunión a crear:
    • Instant: Comienza inmediatamente.
    • Scheduled: Se programa para una fecha y hora específica (el más común).
    • Recurring No Fixed: Una reunión recurrente manual.
    • Recurring Fixed: Una reunión recurrente automática.
  • Start Time: La fecha y hora de inicio en formato ISO 8601 (ej. 2024-03-20T14:00:00Z). Si lo dejas vacío, se usará la fecha y hora actual automáticamente.
  • Duration (minutes): La duración prevista de la reunión en minutos (ej. 15, 30, 60). Ten en cuenta que la reunión puede extenderse más allá de este tiempo si es necesario.
  • Timezone: La zona horaria para la reunión (ej. UTC, America/New_York, Europe/Madrid). Esto asegura que los participantes vean la hora correcta según su ubicación.
  • Meeting Password: (Opcional) Una contraseña para unirse a la reunión (máximo 10 caracteres). Si lo dejas vacío, Zoom asignará una automáticamente o no pedirá contraseña.
  • Meeting Agenda: (Opcional, máx. 2000 caracteres) Una descripción o agenda del tema a tratar, visible para los participantes (ej. “Temas: Presupuesto, Actualizaciones del equipo”).
  • Meeting Settings: (Opcional) Configuración avanzada en formato JSON. Puedes personalizar opciones como activar el video del anfitrión, silenciar a los participantes al entrar (mute_upon_entry), o grabar automáticamente en la nube. Si lo dejas vacío, se usarán los valores por defecto de tu cuenta.
  • Meetings Filter: (Para listas de reuniones) Filtra las reuniones por estado: ‘scheduled’ (pasadas y futuras), ‘live’ (en progreso), o ‘upcoming’ (solo futuras).
  • Page Size: (Para listas de reuniones) Define cuántas reuniones devolver por cada página de resultados (mínimo 1, máximo 300). Usar números más pequeños (10-30) hace que la carga sea más rápida.

Salidas

El componente devuelve los datos procesados por Zoom en formato JSON. Esta información incluye el estado de la operación (si fue exitosa o hubo errores) y los detalles de la reunión o reuniones solicitadas.

Puedes usar estas salidas en el siguiente componente de tu flujo para tomar decisiones o almacenar información.

Ejemplo de Respuesta JSON

json { “data”: { “id”: “z9jmZcq1QR2bWxYzABCDEF==”, “topic”: “Weekly Team Standup”, “type”: 2, “status”: “scheduled”, “start_time”: “2024-03-20T14:00:00Z”, “join_url”: “https://us05web.zoom.us/j/123456789?pwd=abc123…”, “settings”: { “mute_upon_entry”: true, “auto_recording”: “cloud” } } }

Conectividad

Este componente suele conectarse a otros nodos en un flujo de automatización de la siguiente manera:

  • Conectando con “Crear Tarea” o “Enviar Email”: Una vez que el componente de Zoom crea una reunión, es común conectar su salida (el join_url o meeting_id) a un componente de email o gestión de tareas para notificar a los participantes automáticamente.
  • Conectando con “Obtener Datos”: Si estás gestionando muchas reuniones, puedes conectar el componente a un nodo que procese la lista resultante para filtrar solo las reuniones futuras o eliminar las pasadas.

Ejemplo de Uso

Escenario: Crear una reunión recurrente semanal

  1. Seleccionas la operación Create (Crear).
  2. En User ID, escribes 'me'.
  3. En Meeting Type, seleccionas Recurring Fixed.
  4. En Meeting Topic, escribes “Revisión de Proyectos”.
  5. En Meeting Settings, defines {"auto_recording": "cloud"} para grabar automáticamente.
  6. Al ejecutar el flujo, Nappai creará la reunión en Zoom y devolverá el enlace de invitación, que puedes usar en el siguiente paso para notificar al equipo.

Componentes Relacionados

(Esta sección está vacía en la información técnica proporcionada)

Notas Importantes

(Esta sección está vacía en la información técnica proporcionada)

Consejos y Mejores Prácticas

  • Usa 'me' para simplicidad: Si solo vas a gestionar reuniones de tu propia cuenta de Zoom, usa el valor 'me' en el campo User ID para evitar tener que copiar y pegar identificadores de usuario largos.
  • Maneja las páginas con cuidado: Si usas List All para muchas reuniones, considera ajustar Page Size a 30 o 50. Esto hace que el flujo sea más rápido y evita sobrecargar el sistema con demasiados datos de una vez.
  • Valida la contraseña: Si eliges poner una Meeting Password, asegúrate de que tenga máximo 10 caracteres y sea fácil de recordar para los participantes, pero segura para tu equipo.

Consideraciones de Seguridad

  • Asegúrate de proteger tus credenciales de Zoom App Marketplace (Client ID y Client Secret), ya que permiten el acceso total a la API de tu cuenta. No compartas estos datos públicamente en tus flujos de Nappai.