Zoom Discourse

Personalizzazione Plugin
,
1
:discourse2: Riepilogo Discourse Zoom offre agli amministratori e agli utenti di Discourse, dotati di un abbonamento Zoom a pagamento, la possibilitĂ  di pianificare, gestire e partecipare a webinar Zoom direttamente dalla piattaforma Discourse.
:hammer_and_wrench: Link al Repository https://github.com/discourse/discourse-zoom
:open_book: Guida all’Installazione Come installare i plugin in Discourse

Panoramica

Questo plugin integra i webinar Zoom in un’istanza di Discourse. I webinar Zoom possono essere associati a discussioni (topic); gli utenti di Discourse possono registrarsi ai webinar e parteciparvi al momento dell’avvio.

:warning: A causa della deprecazione dell’autenticazione JWT da parte di Zoom, a partire dal 1° agosto 2023, il meccanismo di autenticazione del plugin è cambiato da JWT (ora deprecato; Zoom lo rimuoverà il 1° settembre) a OAuth Server-to-Server. Gli utenti esistenti del plugin devono aggiornare le proprie impostazioni.

FunzionalitĂ 

  • Quando un webinar Zoom inizia, il pulsante “Registrati” passa automaticamente a “Partecipa”; cliccandolo si avvia il webinar utilizzando l’SDK Zoom in un endpoint dedicato all’interno della tua community Discourse
  • Invia automaticamente promemoria ai partecipanti registrati N minuti prima dell’evento (N è configurabile nelle impostazioni del plugin; di default i promemoria sono disattivati)
  • Gli amministratori possono aggiungere relatori (panelists) a un webinar in Discourse
  • Gli amministratori possono aggiungere un link alle registrazioni video del webinar in Discourse, che verrĂ  visualizzato agli utenti dopo la fine dell’evento
  • Gli ospiti e i relatori degli eventi Zoom sono associati agli account utente di Discourse

Utilizzo

Per utilizzare il plugin Discourse Zoom, devi prima installarlo nella tua istanza di Discourse e configurarlo con le credenziali della tua applicazione OAuth Server-to-Server di Zoom. Una volta configurato il plugin, puoi creare un nuovo webinar Zoom creando una nuova discussione (topic) e associandola al webinar. Gli utenti potranno quindi registrarsi al webinar direttamente dalla discussione.

Installazione

Passaggio 1: Installa il plugin nella tua istanza di Discourse

Puoi installare il plugin nella tua istanza di Discourse seguendo le istruzioni qui.

Passaggio 2: Crea un’app OAuth Server-to-Server nel Marketplace Zoom

Per iniziare, dovrai creare un’app OAuth Server-to-Server nel Marketplace Zoom. Questa app sarà necessaria per effettuare richieste all’API di Zoom e ricevere notifiche degli eventi tramite Webhook

Passaggio 3: Configura il plugin

Una volta installato il plugin, vai alle impostazioni del tuo sito Discourse, seleziona la casella di controllo zoom enabled e salva.

Dal Marketplace Zoom, vai alla scheda Credenziali dell’app:

Credenziali dell'app
Credenziali dell'app2130×1474 221 KB

Quindi copia e incolla i valori nelle impostazioni del sito corrispondenti nella tua istanza di Discourse:

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

Passaggio 4: Imposta il token segreto del webhook

Nella scheda Funzionalità della tua applicazione OAuth Server-to-Server di Zoom, copia il “Secret Token” e aggiungilo all’impostazione del sito zoom webhooks secret token del tuo sito Discourse.

Token segreto dei webhook
Token segreto dei webhook2376×1230 209 KB

Passaggio 5: Abilita le sottoscrizioni agli eventi

Rimanendo nella scheda Funzionalità della tua applicazione OAuth Server-to-Server di Zoom, abilita “Event Subscriptions” e clicca sul pulsante Add Event Subscription:

Interruttore Event Subscriptions e pulsante "Add Event Subscription"
Interruttore Event Subscriptions e pulsante "Add Event Subscription"1634×734 57.8 KB

Successivamente, imposta l’“Event notification endpoint URL” su:

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

quindi seleziona il pulsante + Add Events:

URL dell'endpoint di notifica evento e pulsante "Add Events"
URL dell'endpoint di notifica evento e pulsante "Add Events"1052×1378 110 KB

Apri la scheda Webinar dall’elenco dei tipi di evento e seleziona tutti gli eventi elencati. Se non riesci a vedere le autorizzazioni per l’evento Webinar, consulta come abilitare le autorizzazioni.

Senza titolo
Senza titolo908×586 43.7 KB

Sotto l’“Event notification endpoint URL” che hai impostato in precedenza, trova il pulsante Validate:

Pulsante Validate sotto "Event notification endpoint URL"
Pulsante Validate sotto "Event notification endpoint URL"1204×370 59.3 KB

Se tutto funziona correttamente, dovrebbe apparire Un'icona di spunta con "Validated" in verde.

Infine, seleziona il pulsante Save in fondo alla pagina.

Passaggio 6: Scope

Una volta impostate le sottoscrizioni agli eventi, passa alla scheda Scopes e clicca sul pulsante Add Scopes. Qui dovrai selezionare i seguenti scope cercando i valori indicati nelle tabelle, manualmente o utilizzando valori parziali; ad esempio, invece di cercare webinar:read:list_panelists:admin, cerca webinar:read:. Questo restringerĂ  gli elementi mostrati, rendendo piĂš facile trovare quelli necessari.

Questa è un'immagine di cattura dello schermo della funzionalità "Add Scope" dal client web di Zoom, che mostra una finestra di dialogo con campi per nome prodotto, nome team e nome account. (Sottotitolo generato dall'AI)
Questa è un'immagine di cattura dello schermo della funzionalità "Add Scope" dal client web di Zoom, che mostra una finestra di dialogo con campi per nome prodotto, nome team e nome account. (Sottotitolo generato dall'AI)2263×760 92.8 KB

Nell’app OAuth Server-to-Server, sotto la scheda scope, clicca sul pulsante Add Scopes e apparirà una finestra:

Questa immagine mostra uno schermo del computer con un modulo per aggiungere scope a un account. (Sottotitolo generato dall'AI)
Questa immagine mostra uno schermo del computer con un modulo per aggiungere scope a un account. (Sottotitolo generato dall'AI)2267×1576 308 KB

Nella ricerca degli scope, cerca per nome completo o parziale. Per facilitare questa operazione, puoi copiare e incollare ciascuno degli scope nelle tabelle seguenti o cercarli sotto la scheda corrispondente:

L'immagine è uno screenshot di un'interfaccia utente che mostra un modulo per inserire informazioni sull'utente. (Sottotitolo generato dall'AI)
L'immagine è uno screenshot di un'interfaccia utente che mostra un modulo per inserire informazioni sull'utente. (Sottotitolo generato dall'AI)1877×586 43.7 KB

Utenti

scope desc
user:read:user:admin Visualizza un utente
user:read:email:admin Verifica l’email di un utente
user:read:list_users:admin Visualizza gli utenti

Questa immagine visualizza un elenco di webinar creati dagli utenti, con una varietĂ  di argomenti e configurazioni dei panel. (Sottotitolo generato dall'AI)
Questa immagine visualizza un elenco di webinar creati dagli utenti, con una varietà di argomenti e configurazioni dei panel. (Sottotitolo generato dall'AI)1900×1597 272 KB

Questa è un'immagine di cattura dello schermo di un'interfaccia utente che mostra un elenco di azioni che possono essere eseguite sui webinar. (Sottotitolo generato dall'AI)
Questa è un'immagine di cattura dello schermo di un'interfaccia utente che mostra un elenco di azioni che possono essere eseguite sui webinar. (Sottotitolo generato dall'AI)1924×1412 254 KB

Webinar

scope desc
webinar:read:list_panelists:admin Visualizza i relatori di un webinar
webinar:read:list_absentees:admin Visualizza gli assenti di un webinar passato
webinar:read:webinar:admin Visualizza un webinar
webinar:read:registrant:admin Visualizza un partecipante registrato a un webinar
webinar:read:list_registrants:admin Visualizza i partecipanti registrati a un webinar
webinar:write:batch_registrants:admin Aggiungi partecipanti registrati a un webinar
webinar:delete:webinar:admin Elimina un webinar
webinar:write:panelist Aggiungi relatori a un webinar
webinar:delete:registrant Rimuovi un partecipante registrato da un webinar
webinar:write:webinar Crea un webinar per un utente
webinar:update:status Aggiorna lo stato di un webinar
webinar:delete:panelist Rimuovi un relatore da un webinar
webinar:update:webinar Aggiorna un webinar
webinar:write:registrant Aggiungi un partecipante registrato a un webinar

Webinar

scope desc
webinar:read:list_panelists:admin Visualizza i relatori di un webinar
webinar:read:list_absentees:admin Visualizza gli assenti di un webinar passato
webinar:read:webinar:admin Visualizza un webinar
webinar:read:registrant:admin Visualizza un partecipante registrato a un webinar
webinar:read:list_registrants:admin Visualizza i partecipanti registrati a un webinar
webinar:write:batch_registrants:admin Aggiungi partecipanti registrati a un webinar
webinar:delete:webinar:admin Elimina un webinar
webinar:write:panelist Aggiungi relatori a un webinar
webinar:delete:registrant Rimuovi un partecipante registrato da un webinar
webinar:write:webinar Crea un webinar per un utente
webinar:update:status Aggiorna lo stato di un webinar
webinar:delete:panelist Rimuovi un relatore da un webinar
webinar:update:webinar Aggiorna un webinar
webinar:write:registrant Aggiungi un partecipante registrato a un webinar

Passaggio 7: Crea un’app Meeting SDK

:warning: Zoom ha apportato modifiche sul loro lato; stiamo lavorando per aggiornare la guida.

L’app Meeting SDK autentica l’utente in modo che possa partecipare alla riunione del webinar

Inizia creando un’app General App e, sotto Select how the app is managed, seleziona User-managed.

Sotto la scheda Informazioni di base nella tua app General App, copia e incolla il Client ID/ SDK key nel campo zoom sdk key e il Client Secret/SDK secret nel campo zoom sdk secret.

Questa immagine mostra uno screenshot della pagina delle informazioni di base di un'app. (Sottotitolo generato dall'AI)
Questa immagine mostra uno screenshot della pagina delle informazioni di base di un'app. (Sottotitolo generato dall'AI)1699×1427 197 KB

Scorrendo verso il basso, troverai la sezione OAuth Information; nel campo OAuth Redirect URL inserisci l’URL del tuo sito, ad esempio https://TUOSITO.com.

Questa immagine mostra una sezione di una pagina web con un modulo per aggiungere un nuovo URL di reindirizzamento OAuth 2.0. (Sottotitolo generato dall'AI)
Questa immagine mostra una sezione di una pagina web con un modulo per aggiungere un nuovo URL di reindirizzamento OAuth 2.0. (Sottotitolo generato dall'AI)1755×1091 87.1 KB

Passaggio 8: Specifica l’utilizzo della tua app

Sotto la scheda Features, seleziona la sotto-scheda Embed e abilita Meeting SDK.

Uno screenshot dello schermo di un dispositivo Android con istruzioni testuali su come utilizzare Google Meet. (Sottotitolo generato dall'AI)
Uno screenshot dello schermo di un dispositivo Android con istruzioni testuali su come utilizzare Google Meet. (Sottotitolo generato dall'AI)2842×1434 358 KB

Limitazioni

Il plugin funziona solo con webinar che non richiedono registrazione su Zoom.

Avviso sulle modifiche che interrompono la compatibilitĂ 

A causa delle deprecazioni nell’API di Zoom, le vecchie istanze del plugin dovranno essere configurate seguendo i passaggi indicati in questo post.

:discourse2: Ospitato da noi? Questo plugin è disponibile nei nostri piani Enterprise.

63 Mi Piace
Hosting Webinars on Discourse?
BigBlueButton video conference
Can we host events in discourse?
Tips for hosting large events?
Host Zoom Events in Discourse
Discourse as a Conference App (in person, virtual, or hybrid)
Clarification on Zoom permissions