Integración de Zoom con Korbyt Booking
Escrito por Ed Kinne
Última actualización Hace 1 día
Introducción
Este documento describe los pasos necesarios para configurar Korbyt Booking e incluir la integración con Zoom. Contiene los pasos que debe seguir el cliente (administrador de TI) en la aplicación Zoom Marketplace para habilitar el acceso a la API de Zoom, así como los pasos que deben seguir los equipos de Korbyt para configurar la aplicación front-end.
El uso de la integración de Zoom con la aplicación Korbyt Booking permitirá a los clientes añadir datos de Zoom a las reservas creadas en Korbyt Booking de forma fluida y distribuir la información pertinente a los asistentes.
Requisitos previos
Tienes una cuenta de Zoom.
Ser el propietario de la cuenta de Zoom, el administrador de la cuenta o haber sido asignado al rol de Zoom para desarrolladores.
Para habilitar el rol de «Zoom para desarrolladores», inicie sesión en el portal web de Zoom como administrador.
Vaya a Gestión de usuarios > Roles > Funciones avanzadas.
Selecciona las casillas de verificación Ver y Editar para Zoom para desarrolladores.
Configuración de Zoom mediante OAuth para la autenticación
OAuth 2.0 es el protocolo de autorización estándar del sector que permite a las aplicaciones obtener el acceso solicitado a las cuentas de usuario a través de HTTPS con la aprobación del usuario. Mediante OAuth, tu aplicación puede realizar solicitudes de API para un usuario autorizado.
Configuración de la aplicación en Zoom
Para ello, sigue los pasos que se indican a continuación. Ten en cuenta que se necesitarán permisos de administrador en Zoom para completar esta configuración.
Acceda al mercado de Zoom en https://marketplace.zoom.us/
En la esquina superior derecha, haz clic en el menú desplegable «Develop» y selecciona «Build App».
Seleccione «Aplicación general» como tipo de aplicación y haga clic en «Crear».
En la sección «Seleccionar cómo se gestiona la aplicación», seleccione «Gestionada por el administrador».
Puede cambiar el nombre de la aplicación en la esquina superior izquierda de la página.
Credenciales de la aplicación: el flujo de compilación genera automáticamente las credenciales de la aplicación (ID de cliente y secreto de cliente) para su aplicación.
Utiliza las credenciales de desarrollo
(no es necesario publicar la aplicación en Zoom Marketplace, por lo que solo utilizamos credenciales de desarrollo).
En la sección «Información de OAuth», configura OAuth para tu aplicación.
URL de redireccionamiento de OAuth (obligatorio): Introduce la URL de tu aplicación web de reservas Korbyt y añade «/Pages/ZoomAuthorization.aspx» al final
Listas de permitidos de OAuth (obligatorio): Añade la URL de tu aplicación web de reservas Korbyt a la lista de permitidos de OAuth
Haga clic en Continuar.
En la sección «Acceso, superficie e incrustación» no se requieren opciones, así que haz clic en «Continuar» o ve directamente a la sección «Ámbitos».
Selecciona los ámbitos (métodos API)
En la página «Ámbitos», seleccione «Añadir ámbitos», busque y seleccione los siguientes ámbitos obligatorios.
meeting:read:meeting:admin
meeting:read:invitation:admin
meeting:update:meeting:admin
meeting:delete:meeting:admin
meeting:write:meeting:admin
Nota: Después de añadir nuevos permisos, se debe generar un nuevo token de Zoom en Workspace para garantizar el correcto funcionamiento.
En la sección Prueba local,
haga clic en «Generar» para generar la URL de autorización
A continuación, haz clic en «Copiar» para generar la URL de autorización
Configuración de la reserva de Korbyt para Zoom OAuth
Esta sección da por supuesto que ya existe un sistema de reservas de Korbyt activo y operativo configurado en el entorno que se está utilizando. Debe ser completada por el equipo técnico de NFS.
Habilitación y configuración de los ajustes de OAuth para la integración con Zoom
La configuración de esta sección debe completarse antes de habilitar la integración de Zoom sala por sala.
Vaya a «Configuración global» en la aplicación web, desplácese hasta el final y establezca «Integración de colaboración» en «SÍ», seleccione Zoom como protocolo y guarde los cambios.
Haga clic en el enlace «Configurar».
Configure los ajustes específicos de Zoom: Tipo de autenticación: OAuth
ID de cliente: un identificador único generado al configurar el OAuth de Zoom
Secreto del cliente: un identificador único generado al configurar el OAuth de Zoom
URL de OAuth: URL proporcionada por Zoom en la sección Activación de la configuración de la aplicación
Haga clic en Obtener configuración de OAuth de Zoom
Esto abrirá una nueva ventana de Zoom y le pedirá al administrador que inicie sesión.
Después de iniciar sesión, haz clic en «Permitir»
A continuación, haz clic en «Cerrar».
Esto rellenará los campos «Token de acceso», «Token de actualización» y «Caducidad del token».
Haga clic en «Guardar».
La configuración de OAuth de Zoom ya está completa.
Configuración de la aplicación web en Gestión de recursos
La configuración de esta sección habilitará la integración de Zoom sala por sala.
Vaya a Administración > Gestión de recursos > Recurso y seleccione un recurso que se configurará con la integración de Zoom.
Establezca ¿Está activa la colaboración? en SÍ y seleccione Zoom en el cuadro de opciones.
ID del buzón: se utiliza si la sala tiene asociada su propia dirección de correo electrónico. La dirección de correo electrónico de este campo debe recibir un correo electrónico con la información de Zoom cada vez que se cree una reserva en esta sala.
Configuración de alertas de la aplicación web
La configuración de esta sección añadirá la información de la reserva de Zoom a las alertas que se enviarán a los anfitriones y a los asistentes.
Vaya a Administración > Alertas.
Configure las alertas pertinentes que sean necesarias (Confirmación, Modificación, Cancelación, etc.).
Asegúrate de que se incluya la etiqueta de colaboración que se muestra a continuación.
Esta etiqueta generará un enlace que dará acceso a la reunión de Zoom creada automáticamente al realizar la reserva, junto con toda la información estándar de Zoom.
Reservas de la aplicación web
En esta sección se muestra cómo activar la integración con Zoom al crear reservas en la aplicación web de reservas de Korbyt.
Comience a crear una reserva en una sala compatible con Zoom.
Si la sala que se está reservando no está habilitada para Zoom, no se mostrará la opción que aparece en la captura de pantalla siguiente.
Establezca la colaboración en Zoom para activar la integración de Zoom para esta reserva, lo que permitirá al sistema generar automáticamente reuniones de Zoom.
Reservas de Bookit
Esta sección muestra cómo activar la integración con Zoom al crear reservas en la interfaz de Bookit.
Empieza a crear una reserva en una sala compatible con Zoom. a. Si la sala que se está reservando no es compatible con Zoom, no se mostrará la opción que aparece en la captura de pantalla siguiente.
Establezca la colaboración en Zoom para activar la integración de Zoom para esta reserva, de modo que el sistema pueda generar automáticamente reuniones de Zoom.
NOTA: Al crear reservas de Zoom desde Bookit, la invitación automática de EWS incluirá los detalles de la reunión de Zoom y la URL. Esto no es configurable y se realizará automáticamente.