Zoom Plugin 1.1

1. Setting up the Zoom plugin

To setup the plugin, you must have a Zoom service account beforehand.

1.1 JWT settings

Go to https://marketplace.zoom.us/develop/create and select JWT:

Once the application is created, retrieve the Key API and the Secret API in the credentials

And fill them in in the properties of the Zoom plugin:

1.1.1 Setting up notifications

If you want to track user connection and disconnections (for example, to have this information in a JLearn training session), you need to subscribe to meeting login/logout events. To do this, go to the "Feature" section of the JWT application you just created and enable event subscriptions.

Add a new subscription, fill in the subscription name and the URL for receiving notifications. This URL should be in the form: <url_webapp>/plugins/ZoomPlugin/jsp/eventNotif.jsp.

Add the event types Participant/Host joined meeting and Participant/Host left meeting and validate.

Copy the verification token,

and enter it in the properties of the Zoom plugin.

1.2 OAuth settings

The JWT setting allows you to create meetings with a generic account. However, it is sometimes necessary to be able to identify which member has created and started a meeting (for example, to be able to identify the trainer of a JLearn session). The OAuth setting meets this need, as it allows a member to be associated with a Zoom account.

To do this, you need to create an OAuth application.

Select "User-managed app", and do not publish on the "App Marketplace"

In the "App credentials" section, enter the OAuth redirection URL (in the form <url_webapp>/plugins/ZoomPlugin/jsp/oauth/callback.jsp) and add it to the whitelist.

In the "Information" section, fill in the required fields: Short description, long description, company, developer name and email address

In the "Scopes" section, select the following "scopes": meeting:read, meeting:write, user:read.

In the "App credentials" section, copy the OAuth client ID and the secret,

and enter them in the properties of the Zoom module.

1.2.1 Associating a member to a Zoom account

To associate a member to a Zoom account, this member must authenticate himself/herself to Zoom in his/her profile

2. Identifying meeting participants

For a Zoom meeting attendee to be identified in the Digital Workplace (e.g. to display attendees connection/disconnection dates on a calendar event), one of these conditions must be met:

• the attendee has authenticated with its Zoom account in its application (desktop or mobile) and in its profile (see OAuth settings)
• the attendee has authenticated with its Zoom account in its application (desktop or mobile) and the e-mail in its profile corresponds to the e-mail of its Zoom account.

3. Declaring the Zoom plugin as a default service

If you want the Zoom service to be the default video conferencing service to use, go to the JCall module properties and in the Video conferencing service property enter zoom.