How to integrate an external zoom license with your Graphy platform?

This article describes how to integrate an external Zoom license with your course platform.

You can integrate Zoom with your Graphy course platform in 3 major steps

1. Create a Server-to-Server app.
2. Create a meeting SDK app.
3. Add credentials on the Graphy platform.

Creating a Server-to-server OAuth app

Step 1: Log in to Zoom App Marketplace.

Step 2: Click on 'Develop' > 'Build App'.

Step 3: Select Server-to-Server OAuth and click on Create.

Step 4: Add the App Name and click on 'Create'.

Step 5: From the 'App Credentials' section copy and keep 'Account ID', 'Client ID' and 'Client Secret'. We'll use this information in further steps.

Step 6: Click 'Continue' from the App Credentials section.

Step 7: Under the 'Information' > 'Basic Information' section add 'App Name', 'Short Description', and 'Company Name'.

Step 8: Under the 'Information' > 'Developer Contact Information' section add 'Name' and 'Email'. Click on 'Continue'.

Step 9: Under the 'Feature' section copy and keep the 'Secret Token'.

Step 10: Log in to your Graphy dashboard in a separate tab.

Step 11: Navigate to 'Integrations' > 'Third-party integrations' and scroll to 'Zoom'.

Step 12: Paste the values for 'Zoom Account ID', 'Zoom Client ID', 'Zoom Client Secret' and 'Zoom Secret token' that you saved from steps 5 and 9. Click 'Save'.

Step 13: Copy and keep the 'Zoom webhook URL' mentioned under the 'Zoom secret token' field. 

Step 14: Go back to the Zoom Marketplace tab, turn on 'Event Subscription' and click on 'Add Event Subscription'.

Step 15: Paste the Zoom webhook endpoint URL from Step 13 in the shown field and click on 'Validate'.

Step 16: If you receive any error at this step, ensure that you've added and saved the correct values for 'Zoom Account ID', 'Zoom Client ID', 'Zoom Client Secret' and 'Zoom Secret token' on your Graphy dashboard. Once validated it will show 'Validated'.

Step 17: Click on 'Add Events'.

Step 18: Under 'Meeting' select 'Start Meeting' and 'End Meeting'.

Step 19: Now move to 'Webinar' and select 'Start Webinar' and 'End Webinar'.

Step 20: Finally move to 'Recording' and select 'All Recordings have completed'. Click 'Done'.

Step 21: Click 'Save'. After saving it is shown as follows.

Step 22: Select 'Continue' and move to 'Scopes'.

Step 23: Select 'Add Scopes'. Search and add the following scopes.

• Meeting:
  • meeting:read:meeting:admin
  • meeting:write:meeting:admin
  • meeting:update:meeting:admin
  • meeting:read:meeting:master
• Recording:
  • cloud_recording:read:recording:admin
  • cloud_recording:read:recording:master
• User:
  • user:read:list_users:admin
• Webinar:
  • webinar:read:webinar:admin
  • webinar:read:webinar:master

Step 24: Once you've added all the 9 permissions, select 'Done' and click 'Continue'.

Step 25: Finally click on 'Activate your app'.

Once the server-to-server app is activated it shows as follows.

Now you have completed the first step of creating a server-to-server OAuth app. For the final step you have to Create one meeting SDK app. 

Note: You have already added 'Zoom Account ID', 'Zoom Client ID', 'Zoom Client Secret' and 'Zoom Secret token' on your Graphy dashboard. The remaining two fields i.e. 'Zoom SDK client ID' and 'Zoom SDK client secret' will be added in the next step.

Creating a Meeting SDK App

Step 1: Log in to Zoom App Marketplace.

Step 2: Click on the 'Develop' > 'Build App'.

Step 3: Choose the 'General App' option and click on the 'Create' button.

Step 4: You can optionally change the app name to Meeting SDK.

Step 5: In the 'Basic Information' > 'OAuth Information' section add your Graphy domain in the 'OAuth Redirect URL' and 'OAuth Allow Lists' fields.

Step 6: Navigate to the Features > Embed section and enable the Meeting SDK by toggling the switch.

Step 7: Navigate to the 'Scopes' section. Check if 'user:read:zak' is already added, if not click on 'Add Scopes'. 

Step 8: Search and add 'user:read:zak'.

Step 9: After setting up the scopes, from the 'App Credentials' section on the top left copy and keep the 'Client ID' and 'Client Secret'. These will be used to link Zoom with Graphy.

Step 10: Log in to your Graphy account. Navigate to the 'Integration' > 'Third-party integrations' and scroll down to 'Zoom'. You have already added values for the first 4 fields.

Step 11: Paste the 'Zoom SDK Client ID' and 'Zoom SDK Client Secret' you copied in Step 9.

Step 12: As a final step click on 'Save'

Now you have successfully integrated your external zoom account with Graphy.