Microaplicaciones

Integrar Zoom

Implemente la integración de Citrix para Zoom para programar reuniones desde cualquier lugar y desde cualquier dispositivo o intranet. Con nuestra integración para Zoom, los usuarios pueden:

  • Crear una reunión puntual o periódica, agregar coorganizadores y seleccionar diferentes zonas horarias. La microaplicación proporciona, asimismo, detalles de invitación de la reunión programada por el usuario.
  • Ver, modificar e iniciar reuniones creadas.
  • Programar reuniones con Zoom en horas de oficina.
  • Recibir notificación de la grabación de la reunión cuando esta termine y reproducir las grabaciones.

Nota:

¡Su opinión nos interesa! Proporcione comentarios sobre esta plantilla de integración a medida que la utiliza. Para cualquier problema, nuestro equipo también supervisará el foro dedicado a diario.

Para obtener información detallada sobre la microaplicación de uso inmediato para Zoom, consulte Usar las microaplicaciones para Zoom.

Revisar requisitos previos

En estos requisitos previos, se entiende que el administrador forma parte de la estructura de integración de Zoom de la organización. Esta cuenta de administrador de Zoom debe tener privilegios de lectura sin restricciones de la información del usuario. Tras configurar esta integración con Zoom, necesitará estos artefactos para agregar la integración en las microaplicaciones de Citrix Workspace:

  • URL base: https://api.zoom.us/v2/
  • URL de autorización: https://zoom.us/oauth/authorize
  • URL del token: https://zoom.us/oauth/token
  • ID de cliente: El ID de cliente es la cadena que representa la información de registro del cliente exclusiva del servidor de autorización.
  • Secreto: El secreto del cliente es la cadena única emitida al configurar la integración de la aplicación de destino.

Nota:

Se recomienda utilizar OAuth 2.0 como método de autenticación del servicio siempre que esté disponible. OAuth 2.0 garantiza que la integración es conforme a los requisitos de seguridad más estrictos con la microaplicación configurada.

Configure Citrix Gateway para que admita Single Sign-On para Zoom, de modo que, una vez que los usuarios hayan iniciado sesión, no tengan que volver a introducir sus credenciales para registrarse. Para obtener más información acerca de la configuración de SSO, consulte Citrix Gateway Servicehttps://docs.citrix.com/en-us/citrix-gateway-service/.

La integración requiere acceso periódico a su instancia de Zoom, por lo que recomendamos crear una cuenta de usuario dedicada. Puede ver los permisos o privilegios en https://marketplace.zoom.us/docs/api-reference/other-references/privileges. Esta cuenta debe tener los siguientes permisos:

  • Permisos necesarios para la cuenta de servicio: Privilegios de administrador total

El número de solicitudes de API que se pueden realizar a recursos específicos es limitado, por lo que recomendamos lo siguiente:

Crear una cuenta de servicio

Inicie sesión aquí: https://zoom.us/signin. Consulte la siguiente URL para las nuevas cuentas de servicio: https://marketplace.zoom.us/docs/guides/getting-started.

Configurar el servidor de OAuth

Configure el servidor de OAuth para que lea los datos a través de la integración de Zoom.

  1. Inicie sesión con su cuenta de servicio en: https://marketplace.zoom.us/.
  2. Seleccione el menú desplegable Develop en la parte superior derecha.
  3. Seleccione Build App.
  4. Seleccione Create para la aplicación OAuth y elija el tipo de aplicación Account-Level App.
  5. Inhabilite la opción botón para publicar la aplicación en “marketplace” y seleccione Create.
  6. Introduzca las siguientes URL de redirección autorizadas para esta integración en los campos Redirect URL y Whitelist URL: A continuación, seleccione Continue.

    • https://{yourmicroappserverurl}/admin/api/gwsc/auth/serverContext
  7. Complete los campos obligatorios y seleccione Continue.
  8. En la sección Scopes, seleccione Add Scopes y seleccione los ámbitos Meeting, Recording y User. A continuación, seleccione Done.
  9. Seleccione Install. Se abrirá una nueva ficha para autorizar la aplicación. Seleccione Authorize y cierre la ficha.
  10. Copie y guarde el ID de cliente y el secreto que aparecen en la pantalla. Utilice estos detalles para la autenticación de servicio mientras configura la integración.

Configurar cliente de OAuth

Configure el cliente de OAuth para reescritura de datos a través de la integración de Zoom.

  1. Inicie sesión con su cuenta de servicio, como antes: https://marketplace.zoom.us/.
  2. Seleccione el menú desplegable Develop en la parte superior derecha.
  3. Seleccione Build App.
  4. Seleccione Create para la aplicación OAuth y elija el tipo de aplicación User-Managed App.
  5. Inhabilite la opción botón para publicar la aplicación en “marketplace” y seleccione Create.
  6. Introduzca las siguientes URL de redirección autorizadas para esta integración en los campos Redirect URL y Whitelist URL: A continuación, seleccione Continue.

    • <https://{yourmicroappserverurl}/app/api/auth/serviceAction/callback>
  7. Complete los campos obligatorios y seleccione Continue.
  8. En la sección Scopes, seleccione Add Scopes y seleccione los ámbitos Meeting, Recording y User. A continuación, seleccione Done.
  9. Seleccione Install. Se abrirá una nueva ficha para autorizar la aplicación. Seleccione Authorize y cierre la ficha.
  10. Copie y guarde el ID de cliente y el secreto que aparecen en la pantalla. Utilice estos detalles para la autenticación de acciones de servicio mientras configura la integración.

Agregar la integración

Agregue la integración de Zoom Meeting a las microaplicaciones de Citrix Workspace para conectarse a su aplicación. Las opciones de autenticación están preseleccionadas. Compruebe que estas opciones estén seleccionadas a medida que complete el proceso. Esto proporciona microaplicaciones de uso inmediato con notificaciones y acciones preconfiguradas que se pueden usar desde ya en su espacio de trabajo.

Siga estos pasos:

  1. En la página Integraciones de microaplicaciones, seleccione Agregar nueva integración y Agregar una nueva integración a partir de plantillas proporcionadas por Citrix.
  2. Elija el icono de Zoom Meetings.
  3. En el campo Nombre de la integración, introduzca un nombre para la misma.
  4. Introduzca los parámetros del conector.
    • Introduzca la URL base de la instancia: https://api.zoom.us/v2/
    • Seleccione un icono para la integración en la Biblioteca de iconos, o deje el icono predeterminado.

    Nombre y URL base

  5. En Autenticación de servicio, seleccione OAuth 2.0 en el menú Método de autenticación y complete los detalles correspondientes. Las opciones de autenticación están preseleccionadas. Compruebe que estas opciones estén seleccionadas a medida que complete el proceso. Utilice el protocolo de seguridad de OAuth 2.0 para generar tokens de solicitud/autorización para el acceso delegado. Se recomienda utilizar OAuth 2.0 como método de autenticación del servicio siempre que esté disponible. OAuth 2.0 garantiza que la integración es conforme a los requisitos de seguridad más estrictos con la microaplicación configurada.

    1. Seleccione Código de autorización en el menú Tipo de concesión. De esta manera, se concede un código temporal que el cliente intercambia por un token de acceso. El código se obtiene del servidor de autorización, donde se puede ver la información que solicita el cliente. Solo este tipo de concesión permite la suplantación segura de usuarios. Se muestra la URL de respuesta, que utiliza al registrar su aplicación
    2. Seleccione el Encabezado de la autorización en el menú Autorización de token.
    3. La URL de autorización se rellena automáticamente: https://zoom.us/oauth/authorize
    4. La URL del token se rellena automáticamente: https://zoom.us/oauth/token
    5. Introduzca lo siguiente para el ámbito: meeting:read:admin,recording:read:admin,user:read:admin meeting:read,meeting:write

      Nota:

      Para activar la microaplicación Crear una reunión; meeting:read,meeting:write, meeting:read:admin Para activar la microaplicación Próximas reuniones (semana actual); meeting:read,meeting:write, meeting:read:admin Para activar la microaplicación Mi horario de oficina; meeting:read,meeting:write, meeting:read:admin Para activar la microaplicación Grabaciones de reuniones; recording:read:admin

    6. Introduzca su ID de cliente. El ID de cliente es la cadena que representa la información de registro del cliente exclusiva del servidor de autorización. Obtendrá este y el secreto al configurar el servidor de OAuth. Deberá agregar la URL de respuesta que aparece en la página de configuración de la integración.
    7. Introduzca su Secreto del cliente. El secreto del cliente es la cadena única emitida al configurar la integración de la aplicación de destino.

    Autenticación de servicio

  6. En Autenticación de acciones de servicio, habilite la opción Usar autenticación de usuario independiente en Acciones. La autenticación de acciones de servicio autentica en el nivel de acción de servicio. Las opciones de autenticación están preseleccionadas. Compruebe que estas opciones estén seleccionadas a medida que complete el proceso.

    1. En el menú Método de autenticación, seleccione OAuth 2.0 y complete los detalles de autenticación.
    2. Seleccione Código de autorización en el menú Tipo de concesión. De esta manera, se concede un código temporal que el cliente intercambia por un token de acceso. El código se obtiene del servidor de autorización, donde se puede ver la información que solicita el cliente. Solo este tipo de concesión permite la suplantación segura de usuarios. Se muestra la URL de respuesta, que utiliza al registrar su aplicación
    3. Seleccione el Encabezado de la autorización en el menú Autorización de token.
    4. La URL de autorización se rellena automáticamente: https://zoom.us/oauth/authorize
    5. La URL del token se rellena automáticamente: https://zoom.us/oauth/token
    6. Introduzca su ID de cliente. El ID de cliente es la cadena que representa la información de registro del cliente exclusiva del servidor de autorización. Obtendrá este y el secreto al configurar el cliente de OAuth. Deberá agregar la URL de respuesta que aparece en la página de configuración de la integración.
    7. Introduzca su Secreto del cliente. El secreto del cliente es la cadena única emitida al configurar la integración de la aplicación de destino.

    Autenticación de acciones de servicio

  7. Seleccione la opción Habilitar la limitación del índice de solicitudes. Introduzca 55 como Cantidad de solicitudes y 1 segundo como Intervalo de tiempo.

    Opciones para limitación de solicitudes y registro

  8. (Optativo) Habilite la opción Registro para conservar un registro de 24 horas con fines de asistencia.
  9. Seleccione Guardar para continuar.
  10. En Autorización de OAuth, seleccione Autorizar para iniciar sesión con su cuenta de servicio. Aparecerá una ventana emergente con una pantalla de inicio de sesión de Zoom.
    1. Introduzca el nombre de usuario y la contraseña de su cuenta de servicio y seleccione Iniciar sesión.
    2. Seleccione Aceptar. Autenticación de servicio

Se abrirá la página Integraciones de microaplicaciones con la integración agregada y sus microaplicaciones. Desde aquí, puede agregar otra integración, seguir configurando sus microaplicaciones de uso inmediato o crear una nueva microaplicación para esta integración.

Ya tiene todo listo para configurar y llevar a cabo su primera sincronización de datos. Como se puede extraer una gran cantidad de datos de la aplicación integrada y transferirla a la plataforma de microaplicaciones, le recomendamos utilizar la página Tabla para filtrar entidades relacionadas con la primera sincronización de datos y, así, acelerar la sincronización. Para obtener más información, consulte Verificar las entidades necesarias. Para obtener información completa acerca de las reglas de sincronización, la sincronización que no cumple con sus reglas de programación y las reglas de veto, consulte Sincronizar datos.

Para obtener más información sobre los dispositivos de punto final de las API y las entidades de tabla, consulte Especificaciones del conector HTTP de Zoom. Para obtener más información acerca de cómo administrar el acceso y los suscriptores, consulte Asignar suscriptores. Para quitar una integración, en la página Integraciones de microaplicaciones seleccione el menú situado junto a la integración que quiere desinstalar. Seleccione Eliminar integración y confirme la operación.

Usar las microaplicaciones para Zoom

Las integraciones de las aplicaciones existentes vienen con microaplicaciones de uso inmediato. Comience con estas microaplicaciones y personalícelas conforme a sus exigencias.

Crear una reunión: Permite programar reuniones según sus preferencias. El usuario puede elegir el título de la reunión, la duración, la fecha de inicio, los coorganizadores, etc.

Notificación o página Flujos de trabajo por caso de uso
Página Crear una reunión Proporciona un formulario para programar una reunión con los siguientes detalles según las preferencias del usuario: Título de la reunión, hora de inicio, duración, periodicidad (una vez, diaria, semanal, mensual), contraseña, coorganizadores, números de acceso telefónico para la reunión.
Página Nuevas reuniones puntuales Esta página proporciona el mensaje de operación completada correctamente para las reuniones creadas con el botón Ver detalles para las reuniones de tipo evento único
Página Nuevas reuniones periódicas Esta página proporciona el mensaje de operación completada correctamente para las reuniones creadas con el botón Ver detalles para las reuniones periódicas.
Página Invitaciones Proporciona los detalles de la invitación de la reunión inmediatamente después de crearla, como tema de la reunión, contraseña, detalles del calendario, detalles de repetición, URL para unirse, hora de inicio, ID de reunión, números de acceso telefónico.

Próximas reuniones (semana en curso): Sirve para ver las próximas reuniones de la semana en curso. El usuario puede modificar e iniciar la reunión.

Notificación o página Flujos de trabajo por caso de uso
Notificación Recordatorio de reunión única Cuando falta menos de una hora para el comienzo de la reunión puntual, el anfitrión de la reunión recibe una notificación.
Notificación Recordatorio de reunión recurrente Cuando falta menos de una hora para el comienzo de la reunión periódica, el anfitrión de la reunión recibe una notificación.
Página Todas las reuniones Proporciona información sobre todas las próximas reuniones, puntuales y periódicas, de la semana actual e incluye una opción de búsqueda para filtrar las reuniones por tema de la reunión.
Página Detalles de la reunión única Proporciona los detalles de la invitación de la reunión de tipo evento único inmediatamente después de crearla, como tema de la reunión, contraseña, detalles del calendario, URL para unirse, hora de inicio, ID de reunión, números de acceso telefónico y botones Modificar e Iniciar.
Página Detalles de la reunión recurrente Proporciona los detalles de la invitación de la reunión de tipo periódica inmediatamente después de crearla, como tema de la reunión, contraseña, detalles del calendario, detalles de repetición, URL para unirse, hora de inicio, ID de reunión, números de acceso telefónico y botones Modificar e Iniciar.
Página Modificar reuniones únicas Proporciona un formulario para modificar una reunión de tipo evento único con los siguientes detalles según las preferencias del usuario: título de la reunión, hora de inicio, duración, zona horaria, periodicidad (una vez, diaria, semanal, mensual), contraseña, coorganizadores de la reunión.
Página Modificar reunión recurrente Proporciona un formulario para programar una reunión periódica con los siguientes detalles según las preferencias del usuario: título de la reunión, hora de inicio, duración, zona horaria, periodicidad (una vez, diaria, semanal, mensual), contraseña, coorganizadores de la reunión. Ofrece la posibilidad de guardar esta instancia y también todas las instancias.
Página Recordatorio de reunión única Proporciona los detalles de la invitación de la reunión de tipo evento único inmediatamente después de crearla, como tema de la reunión, contraseña, detalles del calendario, URL para unirse, hora de inicio, ID de reunión, números de acceso telefónico y botones Iniciar y Cerrar.
Página Recordatorio de reunión recurrente Proporciona los detalles de la invitación de la reunión de tipo periódica inmediatamente después de crearla, como tema de la reunión, contraseña, detalles del calendario, URL para unirse, hora de inicio, ID de reunión, números de acceso telefónico y botones Iniciar y Cerrar.

Mi horario de oficina: Permite programar una reunión en horario de oficina conforme a las preferencias. El usuario puede elegir la duración, la fecha de inicio, los números de marcado, etc.

Notificación o página Flujos de trabajo por caso de uso
Horario de oficina virtual Proporciona los detalles de las reuniones de horario de oficina programadas en la tabla para el mes actual. Esta página también ayuda al usuario a crear las horas de oficina si no ha programado ninguna reunión para el mes actual.
Configurar horas virtuales Proporciona un formulario para programar una reunión de horario de oficina con los siguientes detalles según las preferencias del usuario: hora de inicio, fecha, duración, zona horaria, periodicidad (una vez, diaria, semanal, mensual), contraseña, números de acceso telefónico para la reunión.
Nueva reunión Muestra el mensaje de operación completada correctamente para las reuniones creadas con el botón “Ver detalles”
Invitaciones Proporciona los detalles de la invitación de la reunión inmediatamente después de crearla, como tema de la reunión, contraseña, detalles del calendario, detalles de repetición, URL para unirse, hora de inicio, ID de reunión, números de acceso telefónico.
Modificar horas de oficina Ayuda al usuario a modificar la reunión de horario de oficina programada según sus preferencias para campos tales como Hora de inicio, Duración o Fecha.

Grabaciones de reuniones: Sirve para ver todas las grabaciones de reuniones de los últimos siete días. También permite a los usuarios reproducir grabaciones desde cualquier dispositivo.

Notificación o página Flujos de trabajo por caso de uso
Notificación Grabaciones de reuniones Cuando haya disponible una nueva grabación de reunión, el anfitrión recibirá la notificación.
Página Tabla de grabaciones Proporciona una tabla para ver todas las grabaciones de reuniones del anfitrión durante los últimos siete días.
Detalles de grabación Proporciona información detallada de la grabación, como tema de la reunión, fecha, hora, URL de descarga, con el botón Reproducir grabación.
Integrar Zoom