Discourse Zoom

Anpassung Plugin
,
1
:discourse2: Zusammenfassung Discourse Zoom ermöglicht es Discourse-Administratoren und -Nutzern mit einem kostenpflichtigen Zoom-Abonnement, Zoom-Webinare direkt aus ihrer Discourse-Plattform heraus zu planen, zu verwalten und daran teilzunehmen.
:hammer_and_wrench: Repository-Link https://github.com/discourse/discourse-zoom
:open_book: Installationsanleitung So installieren Sie Plugins in Discourse

Überblick

Dieses Plugin integriert Zoom-Webinare in eine Discourse-Instanz. Zoom-Webinare können mit Themen verknüpft werden, Discourse-Nutzer können sich für Webinare registrieren und daran teilnehmen, sobald sie beginnen.

:warning: Aufgrund der Abschaffung der JWT-Authentifizierung durch Zoom hat sich der Authentifizierungsmechanismus des Plugins ab dem 1. August 2023 von JWT (jetzt veraltet, Zoom wird es am 1. September entfernen) auf Server-to-Server OAuth geändert. Bestehende Nutzer des Plugins müssen ihre Einstellungen aktualisieren.

Funktionen

  • Wenn ein Zoom-Webinar startet, wechselt die Schaltfläche „Registrieren“ automatisch zu „Beitreten“, und ein Klick darauf startet das Webinar mit dem Zoom SDK auf einem dedizierten Endpunkt innerhalb Ihrer Discourse-Community
  • Automatische Erinnerung an Webinar-Registrierte N Minuten vor dem Ereignis (N ist in den Plugin-Einstellungen konfigurierbar, standardmäßig sind Erinnerungen deaktiviert)
  • Administratoren können Panelisten zu einem Webinar in Discourse hinzufügen
  • Administratoren können einen Link zu Videoaufzeichnungen des Webinars in Discourse hinzufügen, der den Nutzern nach Ende des Ereignisses angezeigt wird
  • Zoom-Event-Hosts und Panelisten werden Discourse-Nutzerkonten zugeordnet

Verwendung

Um das Discourse Zoom-Plugin zu verwenden, müssen Sie es zunächst in Ihrer Discourse-Instanz installieren und mit Ihren Zoom Server-to-Server OAuth-App-Anmeldedaten konfigurieren. Sobald das Plugin eingerichtet ist, können Sie ein neues Zoom-Webinar erstellen, indem Sie ein neues Thema erstellen und es mit dem Webinar verknüpfen. Nutzer können sich dann direkt über das Thema für das Webinar registrieren.

Installation

Schritt 1: Installieren Sie das Plugin in Ihrer Discourse-Instanz

Sie können das Plugin in Ihre Discourse-Instanz installieren, indem Sie die Anweisungen hier befolgen.

Schritt 2: Erstellen Sie eine Server-to-Server OAuth-App im Zoom Marketplace

Um zu beginnen, müssen Sie eine Server-to-Server OAuth-App im Zoom Marketplace erstellen. Diese App wird benötigt, um Anfragen an die Zoom-API zu stellen und Ereignisbenachrichtigungen über Webhooks zu empfangen.

Schritt 3: Konfigurieren Sie das Plugin

Sobald das Plugin installiert ist, gehen Sie zu Ihren Discourse-Site-Einstellungen und aktivieren Sie das Kontrollkästchen zoom enabled (Zoom aktiviert) und speichern Sie.

Gehen Sie im Zoom Marketplace zum Tab App Credentials (App-Anmeldedaten):

App Credentials
App Credentials2130×1474 221 KB

Kopieren Sie dann die Werte und fügen Sie sie in die entsprechenden Site-Einstellungen in Ihrer Discourse-Instanz ein:

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

Schritt 4: Legen Sie das Webhook-Geheimnis-Token fest

Kopieren Sie auf dem Tab Feature (Funktionen) Ihrer Zoom Server-to-Server OAuth-App das „Secret Token“ (Geheimnis-Token) und fügen Sie es in die Site-Einstellung zoom webhooks secret token (Geheimnis-Token für Zoom-Webhooks) Ihrer Discourse-Site ein.

Webhooks Secret Token
Webhooks Secret Token2376×1230 209 KB

Schritt 5: Ereignisabonnements aktivieren

Bleiben Sie auf dem Tab Feature (Funktionen) Ihrer Zoom Server-to-Server OAuth-App, aktivieren Sie „Event Subscriptions“ (Ereignisabonnements) und klicken Sie auf die Schaltfläche Add Event Subscription (Ereignisabonnement hinzufügen):

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

Legen Sie als Nächstes die „Event notification endpoint URL“ (URL des Ereignisbenachrichtigungs-Endpunkts) fest auf:

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

und klicken Sie dann auf die Schaltfläche + Add Events (+ Ereignisse hinzufügen):

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

Öffnen Sie den Tab Webinar aus der Liste der Ereignistypen und aktivieren Sie alle aufgeführten Ereignisse. Wenn Sie die Berechtigungen für das Webinar-Ereignis nicht sehen können, lesen Sie wie Sie die Berechtigungen aktivieren.

Untitled
Untitled908×586 43.7 KB

Finden Sie unter der zuvor festgelegten „Event notification endpoint URL“ die Schaltfläche Validate (Validieren):

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

Es sollte A checkmark icon with "Validated" in green angezeigt werden, wenn alles funktioniert hat.

Wählen Sie abschließend die Schaltfläche Save (Speichern) unten auf der Seite aus.

Schritt 6: Berechtigungen (Scopes)

Sobald Sie die Ereignisabonnements festgelegt haben, wechseln Sie zum Tab Scopes (Berechtigungen) und klicken Sie auf die Schaltfläche Add Scopes (Berechtigungen hinzufügen). Hier wählen Sie die folgenden Berechtigungen aus, entweder durch Suche nach den in den Tabellen angegebenen Werten, manuell oder unter Verwendung von Teilwerten. Beispielsweise suchen Sie statt nach webinar:read:list_panelists:admin nach webinar:read:. Dies verengt die angezeigten Elemente ein, sodass es einfacher ist, die erforderlichen zu finden.

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

Klicken Sie in der Server-to-Server OAuth-App unter dem Tab Berechtigungen auf die Schaltfläche Add Scopes (Berechtigungen hinzufügen), und es wird ein Fenster angezeigt:

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

Suchen Sie im Suchfeld für Berechtigungen nach dem vollständigen oder teilweisen Namen. Um dies zu erleichtern, können Sie jede der Berechtigungen in die folgenden Tabellen kopieren und einfügen oder sie unter dem entsprechenden Tab suchen:

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

Nutzer

scope desc
user:read:user:admin Einen Nutzer anzeigen
user:read:email:admin Die E-Mail-Adresse eines Nutzers verifizieren
user:read:list_users:admin Nutzer anzeigen

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 Die Panelisten eines Webinars anzeigen
webinar:read:list_absentees:admin Die Abwesenden eines vergangenen Webinars anzeigen
webinar:read:webinar:admin Ein Webinar anzeigen
webinar:read:registrant:admin Die registrierten Nutzer eines Webinars anzeigen
webinar:read:list_registrants:admin Die registrierten Nutzer eines Webinars anzeigen
webinar:write:batch_registrants:admin Registrierte Nutzer zu einem Webinar hinzufügen
webinar:delete:webinar:admin Ein Webinar löschen
webinar:write:panelist Panelisten zu einem Webinar hinzufügen
webinar:delete:registrant Einen registrierten Nutzer eines Webinars entfernen
webinar:write:webinar Ein Webinar für einen Nutzer erstellen
webinar:update:status Den Status eines Webinars aktualisieren
webinar:delete:panelist Einen Panelisten eines Webinars entfernen
webinar:update:webinar Ein Webinar aktualisieren
webinar:write:registrant Einen registrierten Nutzer zu einem Webinar hinzufügen

Webinar

scope desc
webinar:read:list_panelists:admin Die Panelisten eines Webinars anzeigen
webinar:read:list_absentees:admin Die Abwesenden eines vergangenen Webinars anzeigen
webinar:read:webinar:admin Ein Webinar anzeigen
webinar:read:registrant:admin Die registrierten Nutzer eines Webinars anzeigen
webinar:read:list_registrants:admin Die registrierten Nutzer eines Webinars anzeigen
webinar:write:batch_registrants:admin Registrierte Nutzer zu einem Webinar hinzufügen
webinar:delete:webinar:admin Ein Webinar löschen
webinar:write:panelist Panelisten zu einem Webinar hinzufügen
webinar:delete:registrant Einen registrierten Nutzer eines Webinars entfernen
webinar:write:webinar Ein Webinar für einen Nutzer erstellen
webinar:update:status Den Status eines Webinars aktualisieren
webinar:delete:panelist Einen Panelisten eines Webinars entfernen
webinar:update:webinar Ein Webinar aktualisieren
webinar:write:registrant Einen registrierten Nutzer zu einem Webinar hinzufügen

Schritt 7: Erstellen Sie eine Meeting SDK App

:warning: Zoom hat auf ihrer Seite Änderungen vorgenommen. Wir arbeiten daran, die Anleitung zu aktualisieren.

Die SDK-Meeting-App authentifiziert den Nutzer, damit dieser dem Webinar-Meeting beitreten kann.

Beginnen Sie damit, eine General App (Allgemeine App) zu erstellen, und wählen Sie unter Select how the app is managed (Auswählen, wie die App verwaltet wird) User-managed (Vom Nutzer verwaltet) aus.

Kopieren Sie auf dem Tab „Basic Information“ (Grundlegende Informationen) Ihrer Allgemeinen App den Client ID/ SDK key (Client-ID/SDK-Schlüssel) und fügen Sie ihn in das Feld zoom sdk key ein, und den Client Secret/SDK secret (Client-Geheimnis/SDK-Geheimnis) in das Feld zoom sdk secret.

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

Scrollen Sie nach unten, und Sie finden den Abschnitt OAuth Information (OAuth-Informationen). Geben Sie in OAuth Redirect URL (OAuth-Weiterleitungs-URL) die URL Ihrer Site ein, z. B. 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

Schritt 8: Legen Sie die Verwendung Ihrer App fest

Wählen Sie unter dem Tab Features (Funktionen) den Unter-Tab Embed (Einbetten) aus und aktivieren Sie den Meeting SDK.

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

Einschränkungen

Das Plugin funktioniert nur mit Webinaren, für die in Zoom keine Registrierung erforderlich ist.

Hinweis zu Breaking Changes

Aufgrund von Abschaffungen in der Zoom-API müssen alte Instanzen des Plugins gemäß den in diesem Beitrag genannten Schritten konfiguriert werden.

:discourse2: Von uns gehostet? Dieses Plugin ist in unseren Enterprise-Plänen verfügbar.

63 „Gefällt mir“
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)