 |
Résumé | Discourse Zoom offre aux administrateurs et aux utilisateurs de Discourse disposant d’un abonnement Zoom payant la possibilité de planifier, gérer et participer à des webinaires Zoom directement depuis leur plateforme Discourse. |
 |
Lien vers le dépôt | |
 |
Guide d’installation |
Vue d’ensemble
Ce plugin intègre les webinaires Zoom dans une instance Discourse. Les webinaires Zoom peuvent être associés à des sujets, et les utilisateurs de Discourse peuvent s’inscrire aux webinaires et y participer dès leur démarrage.
Étant donné que Zoom a déprécié l’authentification JWT, à compter du 1er août 2023, le mécanisme d’authentification du plugin est passé de JWT (désormais déprécié, Zoom le supprimera le 1er septembre) à l’OAuth serveur-à-serveur. Les utilisateurs existants du plugin doivent mettre à jour leurs paramètres.
Fonctionnalités
- Lorsqu’un webinaire Zoom commence, le bouton « S’inscrire » passe automatiquement à « Rejoindre », et en cliquant dessus, le webinaire est lancé en utilisant le SDK Zoom dans un point de terminaison dédié au sein de votre communauté Discourse
- Rappelle automatiquement aux personnes inscrites au webinaire N minutes avant l’événement (N est configurable dans les paramètres du plugin ; par défaut, les rappels sont désactivés)
- Les administrateurs peuvent ajouter des panélistes à un webinaire dans Discourse
- Les administrateurs peuvent ajouter un lien vers les enregistrements vidéo du webinaire dans Discourse, qui sera ensuite affiché aux utilisateurs après la fin de l’événement
- Les hôtes et les panélistes des événements Zoom sont associés aux comptes utilisateurs Discourse
Utilisation
Pour utiliser le plugin Discourse Zoom, vous devez d’abord l’installer dans votre instance Discourse et le configurer avec les informations d’identification de votre application OAuth serveur-à-serveur Zoom. Une fois le plugin configuré, vous pouvez créer un nouveau webinaire Zoom en créant un nouveau sujet et en l’associant au webinaire. Les utilisateurs peuvent ensuite s’inscrire au webinaire directement depuis le sujet.
Installation
Étape 1 : Installer le plugin dans votre instance Discourse
Vous pouvez installer le plugin dans votre instance Discourse en suivant les instructions ici.
Étape 2 : Créer une application OAuth serveur-à-serveur dans le Marketplace Zoom
Pour commencer, vous devez créer une application OAuth serveur-à-serveur dans le Marketplace Zoom. Cette application sera nécessaire pour effectuer des requêtes vers l’API Zoom et recevoir des notifications d’événements via des webhooks.
Étape 3 : Configurer le plugin
Une fois le plugin installé, accédez aux paramètres de votre site Discourse, cochez la case zoom enabled (plugin Zoom activé) et enregistrez.
Depuis le Marketplace Zoom, accédez à l’onglet App Credentials (Informations d’identification de l’application) :
Copiez ensuite et collez les valeurs dans les paramètres de site correspondants de votre instance Discourse :
zoom s2s account id(ID de compte OAuth serveur-à-serveur Zoom)zoom s2s client id(ID client OAuth serveur-à-serveur Zoom)zoom s2s client secret(Secret client OAuth serveur-à-serveur Zoom)
Étape 4 : Définir le jeton secret du webhook
Dans l’onglet Feature (Fonctionnalité) de votre application OAuth serveur-à-serveur Zoom, copiez le « Secret Token » (Jeton secret) et ajoutez-le au paramètre de site zoom webhooks secret token de votre site Discourse.
Étape 5 : Activer les abonnements aux événements
Toujours dans l’onglet Feature (Fonctionnalité) de votre application OAuth serveur-à-serveur Zoom, activez « Event Subscriptions » (Abonnements aux événements) et cliquez sur le bouton Add Event Subscription (Ajouter un abonnement aux événements) :
Ensuite, définissez l’« Event notification endpoint URL » (URL du point de terminaison de notification d’événement) sur :
https://VOTRESITE.COM/zoom/webhooks/webinars.json
puis cliquez sur le bouton + Add Events (Ajouter des événements) :
Ouvrez l’onglet Webinar (Webinaire) dans la liste des types d’événements et cochez tous les événements répertoriés. Si vous ne voyez pas les permissions d’événement Webinar, consultez comment activer les permissions.
Sous l’« Event notification endpoint URL » que vous avez définie précédemment, trouvez le bouton Validate (Valider) :
Si tout fonctionne correctement, vous devriez voir 
.
Enfin, cliquez sur le bouton Save (Enregistrer) en bas de la page.
Étape 6 : Portées (Scopes)
Une fois les abonnements aux événements configurés, accédez à l’onglet Scopes (Portées) et cliquez sur le bouton Add Scopes (Ajouter des portées). Ici, vous sélectionnerez les portées suivantes en recherchant soit les valeurs indiquées dans les tableaux, soit manuellement, soit en utilisant des valeurs partielles. Par exemple, au lieu de rechercher webinar:read:list_panelists:admin, recherchez webinar:read: ; cela permettra de filtrer les éléments affichés et facilitera la recherche de ceux dont vous avez besoin.
Dans l’application OAuth serveur-à-serveur, sous l’onglet Scopes, cliquez sur le bouton Add Scopes (Ajouter des portées) et une fenêtre s’affichera :
Dans la recherche de portée, recherchez par nom complet ou partiel. Pour faciliter cela, vous pouvez copier-coller chacune des portées dans les tableaux suivants ou les rechercher dans l’onglet correspondant :
Utilisateurs
| scope | desc |
|---|---|
| user:read:user:admin | Voir un utilisateur |
| user:read:email:admin | Vérifier l’email d’un utilisateur |
| user:read:list_users:admin | Voir les utilisateurs |
Webinaire
| scope | desc |
|---|---|
| webinar:read:list_panelists:admin | Voir les panélistes d’un webinaire |
| webinar:read:list_absentees:admin | Voir les absents d’un webinaire passé |
| webinar:read:webinar:admin | Voir un webinaire |
| webinar:read:registrant:admin | Voir un inscrit à un webinaire |
| webinar:read:list_registrants:admin | Voir les inscrits à un webinaire |
| webinar:write:batch_registrants:admin | Ajouter des inscrits à un webinaire |
| webinar:delete:webinar:admin | Supprimer un webinaire |
| webinar:write:panelist | Ajouter des panélistes à un webinaire |
| webinar:delete:registrant | Supprimer un inscrit à un webinaire |
| webinar:write:webinar | Créer un webinaire pour un utilisateur |
| webinar:update:status | Mettre à jour le statut d’un webinaire |
| webinar:delete:panelist | Supprimer un panéliste d’un webinaire |
| webinar:update:webinar | Mettre à jour un webinaire |
| webinar:write:registrant | Ajouter un inscrit à un webinaire |
Webinaire
| scope | desc |
|---|---|
| webinar:read:list_panelists:admin | Voir les panélistes d’un webinaire |
| webinar:read:list_absentees:admin | Voir les absents d’un webinaire passé |
| webinar:read:webinar:admin | Voir un webinaire |
| webinar:read:registrant:admin | Voir un inscrit à un webinaire |
| webinar:read:list_registrants:admin | Voir les inscrits à un webinaire |
| webinar:write:batch_registrants:admin | Ajouter des inscrits à un webinaire |
| webinar:delete:webinar:admin | Supprimer un webinaire |
| webinar:write:panelist | Ajouter des panélistes à un webinaire |
| webinar:delete:registrant | Supprimer un inscrit à un webinaire |
| webinar:write:webinar | Créer un webinaire pour un utilisateur |
| webinar:update:status | Mettre à jour le statut d’un webinaire |
| webinar:delete:panelist | Supprimer un panéliste d’un webinaire |
| webinar:update:webinar | Mettre à jour un webinaire |
| webinar:write:registrant | Ajouter un inscrit à un webinaire |
Étape 7 : Créer une application Meeting SDK
L’application SDK Meeting authentifie l’utilisateur afin qu’il puisse rejoindre la réunion du webinaire.
Commencez par créer une General App (Application générale), et sous Select how the app is managed (Sélectionner comment l’application est gérée), choisissez User-managed (Gérée par l’utilisateur).
Dans l’onglet Basic Information (Informations de base) de votre General App, copiez et collez le Client ID/ SDK key (ID client / clé SDK) dans le champ zoom sdk key, et le Client Secret/SDK secret (Secret client / secret SDK) dans le champ zoom sdk secret.
En faisant défiler vers le bas, vous trouverez la section OAuth Information (Informations OAuth) ; dans le champ OAuth Redirect URL (URL de redirection OAuth), placez l’URL de votre site, par exemple https://VOTRESITE.com.
Étape 8 : Spécifier l’utilisation de votre application
Sous l’onglet Features (Fonctionnalités), sélectionnez le sous-onglet Embed (Intégrer) et activez le Meeting SDK.
Limitations
Le plugin ne fonctionne qu’avec les webinaires qui ne nécessitent pas d’inscription dans Zoom.
Avis concernant les modifications majeures (Breaking Changes)
En raison des dépréciations dans l’API Zoom, les anciennes instances du plugin devront être configurées en suivant les étapes mentionnées dans ce message.
Hébergé par nous ? Ce plugin est disponible dans nos offres Entreprise.