Skip to main content

Connect Zoom

This guide shows a sample flow for connecting a Zoom app to your QraOnline center.

Zoom connection example

What this connection does​

After you connect Zoom, your center can:

  • create meetings from the platform
  • assign hosts for live classes
  • attach meeting links to class schedules
  • reuse one provider connection across many teachers

Step 1: Create a Zoom app​

  1. Open the Zoom App Marketplace.
  2. Select Server-to-Server OAuth.
  3. Create an app called QraOnline Center Connector.
  4. Copy the following values:
    • Account ID
    • Client ID
    • Client Secret
Example only

The values below are fake examples for documentation.

ZOOM_ACCOUNT_ID=account_123_demo
ZOOM_CLIENT_ID=client_123_demo
ZOOM_CLIENT_SECRET=secret_123_demo

Step 2: Add the keys in the platform​

In the platform dashboard, open:

Settings → Meeting Providers → Zoom → Connect

Fill in the fields:

FieldExample
Provider nameMain Zoom Workspace
Account IDaccount_123_demo
Client IDclient_123_demo
Client Secret••••••••••
Default host emailops@center.example

Step 3: Choose how meetings are created​

Most centers start with this setup:

  • Meeting type: Scheduled
  • Waiting room: Enabled
  • Passcode: Auto-generated
  • Recording: Cloud recording
  • Alternative host mode: Enabled

Step 4: Test the connection​

Create a fake class called Biology Grade 10 and attach Zoom as the meeting provider.

Expected result:

  1. a meeting ID is created
  2. a join URL is saved in the class record
  3. the teacher receives the host access
Platform entityZoom value
CenterZoom workspace
TeacherHost or alternative host
Class scheduleScheduled meeting
Attendance sessionMeeting report

Troubleshooting​

Invalid client error​

Check that the app type is Server-to-Server OAuth and not a user-level OAuth app.

Teacher cannot start meeting​

Confirm the teacher email exists in Zoom or is added as an alternative host.

Reconnect the provider and run a new test meeting from the same center.

Next step​

Continue with Connect Jitsi if some centers want an open-source provider option.