Zoom Integration

Zoom Integration Overview #

Zoom Integration with Parascolaire allows organizers and administrators to host live lessons and meetings to create a more interactive eLearning experience. To have better control over the meetings, each organizer must connect their own API details from the backend dashboard.

Create a Zoom Account #

To get started, you need to create a Zoom account. Visit Zoom’s website and sign up to create an account.

Create a Server-to-Server OAuth App #

After creating an account, you must create an app that will connect Parascolaire to Zoom.

Steps to Create a Server-to-Server OAuth App #

1. Go to the Zoom App Marketplace Developer Dashboard (https://marketplace.zoom.us/develop) and log in with your Zoom account.
2. Scroll down to find Server-to-Server. Click on “Create” under the Server-to-Server OAuth app type.
3. Fill in the App Name field and click on Create.
4. Go to Information to set your Company Name and Developer Contact Information (i.e., your name and email address).
5. Go to Scopes and configure your app’s necessary scopes based on your Parascolaire integration requirements. Recommended scopes include:

Meeting Scopes: #

• meeting:read:local_recording_token:admin
• meeting:read:summary:admin
• meeting:read:list_summaries:admin
• meeting:read:past_meeting:admin
• meeting:read:meeting:admin
• meeting:read:list_past_participants:admin
• meeting:read:list_upcoming_meetings:admin
• meeting:read:list_past_instances:admin
• meeting:read:list_meetings:admin
• meeting:read:invitation:admin
• meeting:read:alert:admin
• meeting:read:list_registrants:admin
• meeting:read:livestream:admin
• meeting:read:participant:admin
• meeting:write:registrant:admin
• meeting:update:meeting:admin
• meeting:delete:meeting:admin
• meeting:write:meeting:admin
• meeting:write:invite_links:admin
• meeting:read:list_summaries:master
• meeting:read:summary:master

Recording Scopes: #

• archiving:read:archived_file_statistics:admin
• archiving:read:list_archived_files:admin

User Scopes: #

• user:read:list_schedulers:admin
• user:read:summary:admin
• user:read:list_collaboration_devices:admin
• user:read:list_users:admin
• user:read:token:admin
• user:read:user:admin
• user:read:email:admin
• user:read:list_permissions:admin
• user:read:list_assistants:admin
• user:read:list_assistants:master
• user:read:list_permissions:master
• user:read:summary:master
• user:read:user:master
• user:read:list_users:master
• user:read:token:master
• user:read:list_schedulers:master
• user:read:zak:admin

Webinar Scopes: #

• webinar:read:list_past_instances:admin
• webinar:read:list_webinars:admin
• webinar:read:list_panelists:admin
• webinar:read:list_absentees:admin
• webinar:read:participant:admin
• webinar:read:alert:admin
• webinar:update:webinar:admin
• webinar:delete:webinar:admin

Finally, go to Activation and activate your app.

Obtain the App Credentials #

Once your Server-to-Server OAuth app is activated, go to App Credentials to obtain the Account ID, Client ID, and Client Secret. Keep these credentials handy for the next step.

Connect Zoom to Parascolaire #

To connect Zoom to Parascolaire:

1. Head to your dashboard and navigate to Zoom > Set API.
2. Add the Server-to-Server OAuth app credentials (Account ID, Client ID, and Client Secret) obtained in the previous step.
3. Click on Save & Check Connection to update the integration settings.

Test and Verify #

Thoroughly test your Parascolaire integration with Zoom using the credentials. Check if the integration functionalities, such as creating meetings, are working as expected.

Zoom Backend Panel #

The Zoom Backend Panel offers several functionalities beyond Set API.

All Meeting Lists #

Once your Zoom Integration is set up and connected, an All Meetings tab will appear. This tab contains a list that gives administrators a detailed view of all future Zoom Meetings currently scheduled. You can:

• Search for meetings.
• Filter by activity, date, or status.
• Edit or delete meetings directly from this panel.

Expired Meetings #

The Expired Meetings tab lists all Zoom Meetings that have already passed. You can:

• Search, filter, edit, and delete meetings from this tab.
• Reschedule an expired meeting by clicking the edit button and updating the date and time. This will move the meeting back to the All Meetings tab.

إعدادات #

The Settings tab allows you to customize meeting behavior:

• Join Before Host: Allows participants to join before the organizer. Applicable to scheduled or recurring meetings.
• Host Video: Starts the host’s video when the host joins a meeting.
• Participants Video: Starts with participants’ video enabled when they join the meeting.
• Mute Participants: Mutes participants’ audio initially when they join a meeting.
• Enforce Login: Allows only users logged into Zoom to join the meeting.
• Recording Setting: Specify recording access for participants: No Recordings, Local Drive, Zoom Cloud

Creating a Zoom Meeting as a Lesson #

To create a Zoom Meeting:

1. From the Activity Builder, either visit an activity of your choice in edit mode or create a new activity.
2. Scroll down to the Zoom Meeting section and click on the Create a Zoom Meeting button.
3. Fill in the following meeting details in the Zoom Meeting form:

• Meeting Name: Give the meeting a name.
• Meeting Summary: Provide a summary of what the meeting is about, including topics to be covered, type of meeting, etc.
• Meeting Date: Select the time and date of the meeting.
• Meeting Duration: Select the duration of the meeting. Note that free Zoom users cannot hold meetings longer than 40 minutes.
• Time Zone: Specify the time zone for the meeting.
• Auto Recording: Specify the recording type (Local for user’s PC, Cloud for Zoom Cloud Storage, or No Recording to disable).
• Meeting Password: Set a password to restrict random access. Only participants with proper credentials can join.
• Meetings Host: Displays the name of the meeting host.

4. Click the Create Meeting button. The meeting will appear under All Meetings in the Zoom Panel.

Creating Zoom Meetings for Activities #

You can also schedule live classes for your eLearning activities from the Additional tab. After setting up, participants will receive information about upcoming meetings on the lesson page.