 |
Resumen | Discourse Zoom permite a los administradores y usuarios de Discourse, con una suscripción de pago a Zoom, programar, gestionar y participar en seminarios web de Zoom directamente desde su plataforma Discourse. |
 |
Enlace al repositorio | https://github.com/discourse/discourse-zoom |
 |
Guía de instalación | Cómo instalar complementos en Discourse |
Descripción general
Este complemento integra seminarios web de Zoom en una instancia de Discourse. Los seminarios web de Zoom pueden asociarse a temas; los usuarios de Discourse pueden registrarse en seminarios web y unirse a ellos cuando comienzan.
Debido a que Zoom ha descontinuado la autenticación JWT, a partir del 1 de agosto de 2023, el mecanismo de autenticación del complemento ha cambiado de JWT (ahora obsoleto; Zoom lo eliminará el 1 de septiembre) a OAuth de servidor a servidor. Los usuarios existentes del complemento deben actualizar su configuración.
Características
- Cuando comienza un seminario web de Zoom, el botón “Registrarse” cambia automáticamente a “Unirse”, y al hacer clic se inicia el seminario web utilizando el SDK de Zoom en un punto final dedicado dentro de tu comunidad Discourse.
- Recuerda automáticamente a los inscritos en el seminario web N minutos antes del evento (N es configurable en la configuración del complemento; por defecto, las notificaciones están desactivadas).
- Los administradores pueden añadir ponentes a un seminario web en Discourse.
- Los administradores pueden añadir un enlace a las grabaciones en video del seminario web en Discourse, que se mostrará a los usuarios después de que finalice el evento.
- Los anfitriones y ponentes de eventos de Zoom se asocian con cuentas de usuario de Discourse.
Uso
Para usar el complemento Discourse Zoom, primero debes instalarlo en tu instancia de Discourse y configurarlo con las credenciales de tu aplicación OAuth de servidor a servidor de Zoom. Una vez configurado el complemento, puedes crear un nuevo seminario web de Zoom creando un nuevo tema y asociándolo con el seminario web. Los usuarios pueden registrarse en el seminario web directamente desde el tema.
Instalación
Paso 1: Instala el complemento en tu instancia de Discourse
Puedes instalar el complemento en tu instancia de Discourse siguiendo las instrucciones aquí.
Paso 2: Crea una aplicación OAuth de servidor a servidor en el Marketplace de Zoom
Para comenzar, necesitarás crear una aplicación OAuth de servidor a servidor en el Marketplace de Zoom. Esta aplicación será necesaria para realizar solicitudes a la API de Zoom y recibir notificaciones de eventos a través de webhooks.
Paso 3: Configura el complemento
Una vez instalado el complemento, ve a la configuración de tu sitio de Discourse, marca la casilla zoom enabled y guarda.
Desde el Marketplace de Zoom, ve a la pestaña Credenciales de la aplicación:
Luego, copia y pega los valores en la configuración del sitio correspondiente de tu instancia de Discourse:
zoom s2s account idzoom s2s client idzoom s2s client secret
Paso 4: Establece el token secreto del webhook
En la pestaña Funcionalidad de tu aplicación OAuth de servidor a servidor de Zoom, copia el “Token secreto” y añádelo a la configuración del sitio zoom webhooks secret token de tu sitio de Discourse.
Paso 5: Habilita las suscripciones a eventos
Mientras sigues en la pestaña Funcionalidad de tu aplicación OAuth de servidor a servidor de Zoom, habilita “Suscripciones a eventos” y haz clic en el botón Agregar suscripción a evento:
Luego, establece la “URL del punto final de notificación de eventos” en:
https://TU_SITIO.COM/zoom/webhooks/webinars.json
y selecciona el botón + Agregar eventos:
Abre la pestaña Seminario web desde la lista de tipos de eventos y marca todos los eventos listados. Si no puedes ver los permisos de evento Seminario web, consulta cómo habilitar los permisos.
Bajo la “URL del punto final de notificación de eventos” que estableciste anteriormente, busca el botón Validar:
Debería mostrar 
si todo funcionó correctamente.
Finalmente, selecciona el botón Guardar en la parte inferior de la página.
Paso 6: Ámbitos
Una vez que hayas configurado las suscripciones a eventos, ve a la pestaña Ámbitos y haz clic en el botón Agregar ámbitos. Aquí seleccionarás los siguientes ámbitos buscando ya sea por los valores dados en las tablas, manualmente o usando valores parciales. Por ejemplo, en lugar de buscar webinar:read:list_panelists:admin, busca webinar:read:; esto reducirá los elementos mostrados para facilitar la búsqueda de los requeridos.
En la aplicación OAuth de servidor a servidor, bajo la pestaña ámbitos, haz clic en el botón Agregar ámbitos y aparecerá una ventana:
En la búsqueda de ámbitos, busca por nombre completo o parcial. Para facilitar esto, puedes copiar y pegar cada uno de los ámbitos en las siguientes tablas o buscarlos en la pestaña correspondiente:
Usuarios
| ámbito | descripción |
|---|---|
| user:read:user:admin | Ver un usuario |
| user:read:email:admin | Verificar el correo electrónico de un usuario |
| user:read:list_users:admin | Ver usuarios |
Seminario web
| ámbito | descripción |
|---|---|
| webinar:read:list_panelists:admin | Ver los ponentes de un seminario web |
| webinar:read:list_absentees:admin | Ver los ausentes de un seminario web pasado |
| webinar:read:webinar:admin | Ver un seminario web |
| webinar:read:registrant:admin | Ver un inscrito en un seminario web |
| webinar:read:list_registrants:admin | Ver los inscritos en un seminario web |
| webinar:write:batch_registrants:admin | Agregar inscritos a un seminario web |
| webinar:delete:webinar:admin | Eliminar un seminario web |
| webinar:write:panelist | Agregar ponentes a un seminario web |
| webinar:delete:registrant | Eliminar un inscrito de un seminario web |
| webinar:write:webinar | Crear un seminario web para un usuario |
| webinar:update:status | Actualizar el estado de un seminario web |
| webinar:delete:panelist | Eliminar un ponente de un seminario web |
| webinar:update:webinar | Actualizar un seminario web |
| webinar:write:registrant | Agregar un inscrito a un seminario web |
Seminario web
| ámbito | descripción |
|---|---|
| webinar:read:list_panelists:admin | Ver los ponentes de un seminario web |
| webinar:read:list_absentees:admin | Ver los ausentes de un seminario web pasado |
| webinar:read:webinar:admin | Ver un seminario web |
| webinar:read:registrant:admin | Ver un inscrito en un seminario web |
| webinar:read:list_registrants:admin | Ver los inscritos en un seminario web |
| webinar:write:batch_registrants:admin | Agregar inscritos a un seminario web |
| webinar:delete:webinar:admin | Eliminar un seminario web |
| webinar:write:panelist | Agregar ponentes a un seminario web |
| webinar:delete:registrant | Eliminar un inscrito de un seminario web |
| webinar:write:webinar | Crear un seminario web para un usuario |
| webinar:update:status | Actualizar el estado de un seminario web |
| webinar:delete:panelist | Eliminar un ponente de un seminario web |
| webinar:update:webinar | Actualizar un seminario web |
| webinar:write:registrant | Agregar un inscrito a un seminario web |
Paso 7: Crea una aplicación Meeting SDK
La aplicación Meeting SDK autentica al usuario para que pueda unirse a la reunión del seminario web.
Comienza creando una Aplicación general y, bajo Selecciona cómo se gestiona la aplicación, elige Gestionada por el usuario.
En la pestaña Información básica de tu aplicación general, copia y pega el Client ID/ SDK key en el campo zoom sdk key y el Client Secret/SDK secret en el campo zoom sdk secret.
Desplázate hacia abajo y encontrarás la sección Información de OAuth; en URL de redirección OAuth, coloca la URL de tu sitio, por ejemplo, https://TU_SITIO.com.
Paso 8: Especifica el uso de tu aplicación
En la pestaña Funcionalidades, selecciona la subpestaña Insertar y habilita el Meeting SDK.
Limitaciones
El complemento solo funciona con seminarios web que no requieren registro en Zoom.
Aviso sobre cambios disruptivos
Debido a las descontinuaciones en la API de Zoom, las instancias antiguas del complemento deberán configurarse siguiendo los pasos mencionados en esta publicación.
¿Te lo ofrecemos nosotros? Este complemento está disponible en nuestros planes Empresariales.