Module Zoom 1.1
Description
Le module Zoom est un connecteur JCall pour le service de visioconférence Zoom.
Outre le déclenchement d'une visioconférence, le module permet le suivi des connexions (qui s'est connecté, quand et pendant combien de temps)
Il peut aussi être utilisé avec JLearn/1day1learn pour organiser des sessions de formation en classes virtuelles.
Cette utilisation permet notamment :
- de distinguer le rôle du formateur de celui de simples participants
- de suivre de manière détaillée la participation des inscrits à la formation afin d'en déduire une présence ou absence à la session.
L'utilisation du service nécessite la souscription d'un abonnement payant. Plus d'information sur Zoom
Installation
1. Paramétrage du module Zoom
Il vous faut, au préalable, disposer d'un compte de service Zoom.
1.1 Paramétrage JWT
Après vous êtes créé un compte, il vous faut créer une application de type JWT.
Allez sur https://marketplace.zoom.us/develop/create et sélectionnez JWT :
Une fois l'application créée, récupérez l'API Key et l'API Secret dans les credentials :
Et renseignez-les dans les propriétés du module Zoom :
1.1.1 Paramétrage des notifications
Si vous souhaitez activer la récupération des informations de participation des utilisateurs (par exemple, pour avoir ces informations dans une session de formation JLearn), il vous faut souscrire aux événements de connexion/déconnexion aux réunions. Pour cela, allez dans la section "Feature" de l'application JWT que vous venez de créer et activez la souscriptions aux événements.
Ajoutez une nouvelle souscription, renseignez le nom de la souscription et l'URL de réception des notifications. Cette URL doit être de la forme : <url_webapp>/plugins/ZoomPlugin/jsp/eventNotif.jsp
.
Ajouter les types d'événements Participant/Host joined meeting
et Participant/Host left meeting
et validez.
Copiez le jeton de vérification,
et renseignez-le dans les propriétés du module Zoom.
1.2 Paramétrage OAuth
Le paramétrage JWT permet de créer des réunions avec un compte générique. Or, il est parfois nécessaire de pouvoir identifier quel membre a créé et démarré une réunion (par exemple, pour pouvoir identifier le formateur d'une session JLearn). Le paramétrage OAuth répond à ce besoin, car il permet d'associer un membre à un compte Zoom.
Pour cela, il vous faut créer une application de type OAuth.
Sélectionner "User-managed app", et ne pas publier sur l'"App Marketplace"
Dans la section "App credentials", renseignez l'URL de redirection OAuth (de la forme <url_webapp>/plugins/ZoomPlugin/jsp/oauth/callback.jsp
) et ajoutez-la à la liste blanche.
Dans la section "Informations", renseignez les champs obligatoires : Description courte, description longue, société, nom et adresse e-mail du développeur.
Dans la section "Scopes", sélectionner les "scopes" suivants : meeting:read, meeting:write, user:read
.
Dans la section "App credentials", copiez l'ID du client OAuth et le secret,
et renseignez-les dans les propriétés du module Zoom.
1.2.1 Associer un membre à un compte Zoom
Pour associer un membre à un compte Zoom, il faut que ce membre s'authentifie à Zoom dans son profil
2. Identification des participants à une réunion
Pour qu'un participant à une réunion Zoom soit identifié dans la Digital Workplace (par exemple pour pouvoir afficher ses informations de connexion à une réunion), il faut :
- qu'il se soit authentifié avec son compte Zoom dans son application (desktop ou mobile) et dans son profil (voir paramétrage OAuth)
- ou qu'il se soit authentifié avec sont compte Zoom dans son application (desktop ou mobile) et que l'e-mail de son profil corresponde à l'e-mail de son compte Zoom.
3. Déclaration du module Zoom comme service par défaut
Si vous souhaitez que le service Zoom soit le service à utiliser par défaut, allez dans les propriétés du module JCall et dans la propriété Service de visioconférence saisissez zoom
.