Zoom de Discourse

Personalización Plugin
,
1
:discourse2: Resumen Discourse Zoom permite a los administradores y usuarios de Discourse, con una suscripción de pago a Zoom, programar, gestionar y participar en webinars de Zoom directamente desde su plataforma Discourse.
:hammer_and_wrench: Enlace al repositorio https://github.com/discourse/discourse-zoom
:open_book: Guía de instalación Cómo instalar plugins en Discourse

Descripción general

Este plugin integra webinars de Zoom en una instancia de Discourse. Los webinars de Zoom pueden asociarse con temas, los usuarios de Discourse pueden registrarse para los webinars y unirse a ellos cuando comiencen.

:warning: Debido a que Zoom ha descontinuado la autenticación JWT, a partir del 1 de agosto de 2023, el mecanismo de autenticación del plugin ha cambiado de JWT (ahora descontinuado, Zoom lo eliminará el 1 de septiembre) a OAuth de Servidor a Servidor. Los usuarios existentes del plugin deben actualizar su configuración.

Funcionalidades

  • Cuando comienza un webinar de Zoom, el botón “Registrarse” cambia automáticamente a “Unirse”, y al hacer clic en él se lanza el webinar utilizando el SDK de Zoom en un punto de acceso dedicado dentro de tu comunidad de Discourse
  • Envía recordatorios automáticos a los registrados N minutos antes del evento (N es configurable en la configuración del plugin, por defecto los recordatorios están desactivados)
  • Los administradores pueden añadir panelistas a un webinar en Discourse
  • Los administradores pueden añadir un enlace a las grabaciones de video del webinar en Discourse, que luego se muestra a los usuarios después de que el evento haya terminado
  • Los organizadores y panelistas de eventos de Zoom se asocian con cuentas de usuario de Discourse

Uso

Para usar el plugin 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 que el plugin esté configurado, puedes crear un nuevo webinar de Zoom creando un nuevo tema y asociándolo con el webinar. Los usuarios pueden entonces registrarse para el webinar directamente desde el tema.

Instalación

Paso 1: Instalar el plugin en tu instancia de Discourse

Puedes instalar el plugin en tu instancia de Discourse siguiendo las instrucciones aquí.

Paso 2: Crear 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: Configurar el plugin

Una vez instalado el plugin, ve a la configuración de tu sitio de Discourse y marca la casilla zoom enabled (habilitar zoom) y guarda.

Desde el Marketplace de Zoom, ve a la pestaña App Credentials (Credenciales de la aplicación):

App Credentials
App Credentials2130×1474 221 KB

Luego copia y pega los valores en la configuración de sitio correspondiente en tu instancia de Discourse:

  • zoom s2s account id
  • zoom s2s client id
  • zoom s2s client secret

Paso 4: Establecer el token secreto del webhook

En la pestaña Feature (Funcionalidad) de tu aplicación OAuth de Servidor a Servidor de Zoom, copia el “Secret Token” (Token secreto) y añádelo a la configuración de sitio zoom webhooks secret token de tu sitio de Discourse.

Webhooks Secret Token
Webhooks Secret Token2376×1230 209 KB

Paso 5: Habilitar suscripciones de eventos

Mientras sigas en la pestaña Feature (Funcionalidad) de tu aplicación OAuth de Servidor a Servidor de Zoom, habilita “Event Subscriptions” (Suscripciones a eventos) y selecciona el botón Add Event Subscription (Añadir suscripción a evento):

Event Subscriptions toggle and "Add Event Subscription" button
Event Subscriptions toggle and "Add Event Subscription" button1634×734 57.8 KB

A continuación, establece la “Event notification endpoint URL” (URL del punto de conexión de notificación de eventos) en:

https://YOURSITE.COM/zoom/webhooks/webinars.json

luego selecciona el botón + Add Events (Añadir eventos):

Event notification endpoint URL and "Add Events" button
Event notification endpoint URL and "Add Events" button1052×1378 110 KB

Abre la pestaña Webinar (Webinar) desde la lista de tipos de evento y marca todos los eventos que se enumeran. Si no puedes ver los permisos de evento de Webinar, consulta cómo habilitar los permisos.

Untitled
Untitled908×586 43.7 KB

Debajo de la “Event notification endpoint URL” (URL del punto de conexión de notificación de eventos) que estableciste anteriormente, encuentra el botón Validate (Validar):

Validate button under "Event notification endpoint URL"
Validate button under "Event notification endpoint URL"1204×370 59.3 KB

Debería mostrar A checkmark icon with "Validated" in green si todo funcionó correctamente.

Finalmente, selecciona el botón Save (Guardar) en la parte inferior de la página.

Paso 6: Ámbitos (Scopes)

Una vez que hayas establecido las suscripciones de eventos, ve a la pestaña Scopes (Ámbitos) y haz clic en el botón Add Scopes (Añadir ámbitos). Aquí seleccionarás los siguientes ámbitos ya sea buscando 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 que sea más fácil encontrar los requeridos.

This is a screenshot of the "Add Scope" feature from the Zoom web client, showing a dialog box with fields for product name, team name, and account name. (Captioned by AI)
This is a screenshot of the "Add Scope" feature from the Zoom web client, showing a dialog box with fields for product name, team name, and account name. (Captioned by AI)2263×760 92.8 KB

En la aplicación OAuth de Servidor a Servidor, bajo la pestaña de ámbitos, haz clic en el botón Add Scopes (Añadir ámbitos) y se abrirá una ventana:

This image shows a computer screen with a form to add scopes to an account. (Captioned by AI)
This image shows a computer screen with a form to add scopes to an account. (Captioned by AI)2267×1576 308 KB

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 bajo la pestaña correspondiente:

The image is a screenshot of a user interface, showing a form for entering user information. (Captioned by AI)
The image is a screenshot of a user interface, showing a form for entering user information. (Captioned by AI)1877×586 43.7 KB

Usuarios

scope desc
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

This image displays a list of user-created webinars, with a variety of topics and panel configurations. (Captioned by AI)
This image displays a list of user-created webinars, with a variety of topics and panel configurations. (Captioned by AI)1900×1597 272 KB

This is a screenshot of a user interface showing a list of actions that can be done on webinars. (Captioned by AI)
This is a screenshot of a user interface showing a list of actions that can be done on webinars. (Captioned by AI)1924×1412 254 KB

Webinar

scope desc
webinar:read:list_panelists:admin Ver los panelistas de un webinar
webinar:read:list_absentees:admin Ver los ausentes de un webinar pasado
webinar:read:webinar:admin Ver un webinar
webinar:read:registrant:admin Ver el registrante de un webinar
webinar:read:list_registrants:admin Ver los registrantes de un webinar
webinar:write:batch_registrants:admin Añadir registrantes a un webinar
webinar:delete:webinar:admin Eliminar un webinar
webinar:write:panelist Añadir panelistas a un webinar
webinar:delete:registrant Eliminar un registrante de un webinar
webinar:write:webinar Crear un webinar para un usuario
webinar:update:status Actualizar el estado de un webinar
webinar:delete:panelist Eliminar un panelista de un webinar
webinar:update:webinar Actualizar un webinar
webinar:write:registrant Añadir un registrante a un webinar

Webinar

scope desc
webinar:read:list_panelists:admin Ver los panelistas de un webinar
webinar:read:list_absentees:admin Ver los ausentes de un webinar pasado
webinar:read:webinar:admin Ver un webinar
webinar:read:registrant:admin Ver el registrante de un webinar
webinar:read:list_registrants:admin Ver los registrantes de un webinar
webinar:write:batch_registrants:admin Añadir registrantes a un webinar
webinar:delete:webinar:admin Eliminar un webinar
webinar:write:panelist Añadir panelistas a un webinar
webinar:delete:registrant Eliminar un registrante de un webinar
webinar:write:webinar Crear un webinar para un usuario
webinar:update:status Actualizar el estado de un webinar
webinar:delete:panelist Eliminar un panelista de un webinar
webinar:update:webinar Actualizar un webinar
webinar:write:registrant Añadir un registrante a un webinar

Paso 7: Crear una aplicación SDK de Reunión

:warning: Zoom ha realizado cambios en su lado, estamos trabajando en actualizar la guía.

La aplicación de reunión SDK autentica al usuario para que pueda unirse a la reunión del webinar.

Comienza creando una General App (Aplicación general) y, bajo Select how the app is managed (Selecciona cómo se gestiona la aplicación), elige User-managed (Gestionada por el usuario).

En la pestaña Basic Information (Información básica) de tu Aplicación general, copia y pega el Client ID/ SDK key (ID de cliente/Clave SDK) en el campo zoom sdk key (clave sdk de zoom), y el Client Secret/SDK secret (Secreto de cliente/Secreto SDK) en el campo zoom sdk secret (secreto sdk de zoom).

This image displays a screenshot of an app's basic information page. (Captioned by AI)
This image displays a screenshot of an app's basic information page. (Captioned by AI)1699×1427 197 KB

Al desplazarte hacia abajo, encontrarás la sección OAuth Information (Información OAuth). En OAuth Redirect URL (URL de redirección OAuth), coloca la URL de tu sitio, por ejemplo, https://YOURSITE.com.

This image shows a section of a webpage with a form to add a new OAuth 2.0 redirect URL. (Captioned by AI)
This image shows a section of a webpage with a form to add a new OAuth 2.0 redirect URL. (Captioned by AI)1755×1091 87.1 KB

Paso 8: Especificar el uso de tu aplicación

Bajo la pestaña Features (Funcionalidades), selecciona la subpestaña Embed (Incrustar) y habilita el Meeting SDK (SDK de reuniones).

A screenshot of an Android device screen with text instructions on how to use Google Meet. (Captioned by AI)
A screenshot of an Android device screen with text instructions on how to use Google Meet. (Captioned by AI)2842×1434 358 KB

Limitaciones

El plugin solo funciona con webinars que no requieren registro en Zoom.

Aviso sobre cambios importantes (Breaking Changes)

Debido a las descontinuaciones en la API de Zoom, las instancias antiguas del plugin necesitarán configurarse siguiendo los pasos mencionados en esta publicación.

:discourse2: ¿Alojado por nosotros? Este plugin está disponible en nuestros planes Enterprise.

63 Me gusta
Hosting Webinars on Discourse?
BigBlueButton video conference
Can we host events in discourse?
Tips for hosting large events?
Host Zoom Events in Discourse
Discourse Zoom validate endpoint URL issue (discourse log shows errors)
Clarification on Zoom permissions
Discourse as a Conference App (in person, virtual, or hybrid)