Cómo utilizar el módulo Zoom

Zoom permite trabajar con Zoom API (https://marketplace.zoom.us/docs/guides/).

Zoom Module Instalación

API Key y Secret Key de su Zoom aplicación deben ser recuperados en primer lugar(https://marketplace.zoom.us/develop/create?source=devdocs). Siguiendo el enlace verás varios tipos de Zoom aplicaciones para seleccionar.

ZoomLa aplicación de API Key y Secret Key se mostrarán después de la selección del tipo de app.

Meeting y Recurrence Modelos de Datos

Al instalar el módulo Zoom módulo, también se crean dos modelos de datos virtuales en el proyecto: Meeting y Recurrence. El primero se refiere al propio objeto de videollamada, y Recurrence es responsable de la regularidad (recurrencia) de esta videoconferencia. Los siguientes BPs son auxiliares en la creación y uso de estos modelos de datos:

• Make Zoom Meeting - crea un objeto de Meeting tipo de modelo de datos:
  • Join_url [string] - enlace de la reunión;
  • start_time [datetime] - hora de inicio de la reunión
  • Status [string] - estado de la reunión;
  • Type [enum] - tipo de reunión
    • Instant - reunión única no programada
    • Scheduled - reunión programada
    • Recurring with no fixed time - reunión recurrente sin hora fija
    • Recurring with fixed time - recurrente con hora fija
  • Meeting_id [integer] - identificador de la reunión
  • Agenda [string] - información de la agenda de la reunión
  • Topic [string] - tema de la reunión;
  • Recurrence [recurrence tipo de objeto] - objeto de Recurrence tipo de modelo de datos;
  • Password [string] - contraseña de la reunión;

• Expand Zoom Meeting - expande un objeto de Meeting tipo de modelo de datos;
  • Join_url [string] - enlace de la reunión;
  • start_time [datetime] - hora de inicio de la reunión;
  • Status [string] - estado de la reunión;
  • Type [enum] - tipo de reunión
    • Instant - reunión única no programada
    • Scheduled - reunión programada
    • Recurring with no fixed time - reunión recurrente sin hora fija
    • Recurring with fixed time - recurrente con tiempo fijo
  • Meeting_id [integer] - identificador de la reunión
  • Agenda [string] - información de la agenda de la reunión
  • Topic [string] - tema de la reunión;
  • Recurrence [recurrence tipo de objeto] - objeto de Recurrence tipo de modelo de datos;
  • Password [string] - contraseña de la reunión;

• Make Zoom Recurrence - crea un objeto de Recurrence tipo de modelo de datos;
  • Type [enum] - tipo de recurrencia
    • Daily
    • Weekly
    • Monthly
  • Ends_time [integer] - el número de veces que la reunión recurrente se producirá antes de ser cancelada, entre un valor de 1 y 50. No se puede utilizar esta clave con la tecla end_date_time clave.
  • Monthly_day [integer] - necesaria sólo para las reuniones recurrentes mensuales. El día del mes en el que se produce una reunión periódica, entre el 1 y el 31.
  • Weekly_days [enum] - necesaria sólo para las reuniones recurrentes semanales (1 - lunes, 2 - martes, ... , 7 - domingo).
  • Repeat_interval [integer] - el intervalo de repetición de la reunión. Para un intervalo diario, un máximo de 90 días. Para un intervalo semanal, un máximo de 12 semanas.
  • End_date_time [datetime] - la fecha y hora de finalización de la reunión recurrente antes de su cancelación, en formato UTC. No se puede utilizar esta clave con la tecla end_times clave.

• Expand Zoom Recurrence - expande un objeto de Recurrence tipo de modelo de datos;
  • Type [enum] - tipo de recurrencia
    • Daily
    • Weekly
    • Monthly
  • Ends_time [integer] - el número de veces que la reunión recurrente se producirá antes de ser cancelada, entre un valor de 1 y 50. No se puede utilizar esta clave con la tecla end_date_time clave.
  • Monthly_day [integer] - necesaria sólo para las reuniones recurrentes mensuales. El día del mes en el que se produce una reunión periódica, entre el 1 y el 31.
  • Weekly_days [enum] - necesaria sólo para las reuniones recurrentes semanales (1 - lunes, 2 - martes, ... , 7 - domingo).
  • Repeat_interval [integer] - el intervalo de repetición de la reunión. Para un intervalo diario, un máximo de 90 días. Para un intervalo semanal, un máximo de 12 semanas.
  • End_date_time [datetime] - la fecha y hora de finalización de la reunión recurrente antes de su cancelación, en formato UTC. No se puede utilizar esta clave con la tecla end_times clave.

Procesos de negocio que trabajan con Zoom Module

Preinstalación de Zoom Los procesos de negocio del módulo están disponibles sólo para el backend de la aplicación:

• Zoom: Get meeting - obtiene el objeto de reunión con el identificador dado:
  • Meeting_id [integer] - identificador de la reunión;

• Zoom: Delete meeting - elimina el registro de la reunión del DB con el identificador dado;
  • Meeting_id [integer] (obligatorio) - identificador de la reunión;

• Zoom: Update meeting - actualiza el objeto de reunión en el DB con el identificador dado:
  • Meeting_id [integer] (obligatorio) - identificador de la reunión;
  • Topic [string] - tema de la reunión;
  • Type [enum] - tipo de reunión
    • Instant - reunión única no programada
    • Scheduled - reunión programada
    • Recurring with no fixed time - reunión recurrente sin hora fija
    • Recurring with fixed time - recurrente con tiempo fijo
  • start_time [datetime] - hora de inicio de la reunión
  • Join_url [string] - enlace de la reunión;
  • Password [string] - contraseña de la reunión;
  • Agenda [string] - información de la agenda de la reunión;
  • Recurrence [recurrence tipo de objeto] - objeto de Recurrence tipo de modelo de datos;

• Zoom: Create Meeting - crea un objeto de Meeting tipo de modelo de datos:
  • Type [enum] - tipo de reunión
    • Instant - reunión única no programada
    • Scheduled - reunión programada
    • Recurring with no fixed time - reunión recurrente sin hora fija
    • Recurring with fixed time - recurrente con tiempo fijo
  • Password [string] - contraseña de la reunión
  • Agenda [string] - información de la agenda de la reunión
  • Recurrence [recurrence tipo de objeto] - objeto de Recurrence tipo de modelo de datos;
  • User_id [string] (obligatorio) - dirección del usuario ID o dirección de correo electrónico.

• Zoom: List meetings - usa esto API para listar las reuniones programadas de un usuario (anfitrión de la reunión). El usuario se define con su API_KEY;
  • Page_size [integer] - el número de registros devueltos en una sola API llamada. Se establece en 30 por defecto.
  • Page_number [integer] - el número de página de la página actual en los registros devueltos. Se establece en 1 por defecto.

Ejemplo de uso

Veamos un ejemplo de generación de un Zoom enlace de reunión al hacer clic en un botón. Para utilizar los procesos de negocio del módulo en el front-end de la aplicación, el primer paso es establecer el Endpoint para crear la generación del enlace (Zoom: Create meeting).

1. Crea un nuevo grupo en la sección Endpoints sección.
2. Cuando se crea el grupo hay que hacer un nuevo Endpoint. Zoom: Create meeting proceso de negocio debe ser considerado como un POST tipo de solicitud.
3. En el proceso de negocio de la aplicación web el endpoint recién creado puede ser utilizado como en el ejemplo de abajo. Aquí, se genera un enlace y se proporciona como una Label propiedad del componente Label cuando se hace clic en el botón (onClick).

El resultado se muestra a continuación: