Skip to main content

Zoom Integration Setup Guide

To integrate Zoom into our platform, you will need access to the following;  

  • CCCrowdComms Dashboard/CMSContent Management System (CMS) Dashboard
  • The front-endEvent of theApp platform
  • A Pro, Business or Enterprise Zoom account (https://zoom.us/account )
    N.B. The Zoom API and Client SDKs are not available to Basic Accounts. If you have a basic account and want to set up an integration with our platform, you will need to speak to zoomZoom directly to discuss upgrading your account. If you are not the account owner or an admin on the account, you may also need to check that you have been given developer privileges. This can be set by account owners and admin here.

Please note: If you are looking to use zoomZoom to run concurrent meetings, there are some limitations on zoom'Zoom's side, so please see these best practices before deciding if this setup will work for you.

Here is a video guide on integrating your account with the platform:



All steps are also listed below for you to refer back to:

Step 1. Zoom Developer Platform

  1. Once you are logged into zoom,Zoom Marketplace, you will need to navigate to the‘Develop’ developer platform. You can find this under solutions inat the top left right-hand menu

    Switching-to-Zoom-Developer-Section.PNG

    of

    the page and click ‘Build App’ from the dropdown.

  2. Then you need to click on 'buildthe app'‘Meeting inSDK’ tile, and you will be presented with a prompt where you add the topApp rightName.
    3. next to your initials as per the shot below:

    Zoom-Integration-Shot-2.PNG

  3. You are now ready to start building your app ready for integration with the platformplatform.

    Zoom-Dev-Build.PNG

    4. From

  4. Please here,note pleasethe followClient these steps:

    1. Click on 'Create' under JWTID and fill in the fields as appropriate (More info can be found under 'Useful Links' at the end of this guide)
    Please note: If you are not the account admin, then you won't automatically be given developer privileges and so will need to contact them to be able to create a JWT.

    Capture15.PNG

    You will only need to do this once as you can only have one JWT per zoom account. You will need to make note of your API Key and APIClient Secret ready to paste into the CMS later.

    2.

    5. Click on 'Create' under OAuth and fill in the fields as appropriate (More info can be found under 'Useful Links' at the end of this guide) 
    Please note: You can have multiple OAuth's under the same zoom account, so you will want to have a new one per CC platform. Make sure your app type is 'account-level app' and that you turn off the option to publish the app. You will need to make a note of your Client ID and Client Secret ready to paste into the CMS later.

    appbuild1.PNG

    3.

  5. Add the following redirect URL: https://api-cms.crowdcomms.com/cms/integrations/zoom/redirect-callback/
    4.
  6. Add the following whitelist URL: https://api-cms.crowdcomms.com/
    5.
    7. You can click 'continue' through the information and features sections as the app is not being published anywhere
    6.
  7. When you get to "Scopes", click the plus to 'add scope'. Select the option to 'view and manage all...' for both meetings and webinars respectively, depending on what you are using.

appbuild2.PNG


7.8. Click 'Done' and then "Continue"'Continue'. This
9. isNext, then the developer setup complete. You can then navigate back to https://zoom.us/
8. Scheduleschedule the meetings/webinars you would like to integrate via zoomZoom as normal
Please note: As the integration is set up by one central person's zoomZoom account, we recommend using the 'alternative hosts' option, so that whoever is running each specific meeting is able to start it. You will need to then communicate the meeting link with them as you would outside of the platform.


Step 2. CMS

1. Log into the CrowdComms dashboardCMS Dashboard with your credentials credentials.
2. Select App the App you wish to create the Zoom integration.
3. Click on Plugins (You can also get here directly via this URL: https://dashboard.crowdcomms.com/app/appshortcode/integrations (replacing 'appshortcode' with the shortcode of your app)
4. ClickThen, click on Zoom

Zoom-Plugin-Page.PNG

5. Paste the JWT Client ID (API Key) and Client Secret (API Secret) you took note of earlier
Please note: If you forgot to make note of this earlier, you can go back to the developer platform and find your JWT here: https://marketplace.zoom.us/develop/create
And you can find your OAuth by navigating to the marketplace, then manage to find your app. Link here:them https://marketplace.zoom.us/user/buildhere.
6. Click on 'Authorise'  
Please note: Your browser will need to allow popups in order for the authorisation to work. This is to generate the success message. Without this, the CMS will generate an error and you won't be able to import your meetings.
7. You will receive a successful authorisation message (If authentication has failed, see troubleshooting section)  
8. Click on 'Libraries'  
9. Click on 'Zoom meetings and Webinars'

Libraries.PNG

10. Click on the 'Import Meetings & Webinars'   Import-.png

11. Select the meeting(s) and or Webinar(s) you wish to import (Switch between Meetings and Webinars using the TAB)  
12. Click 'Import Now' (At this point you can select a meeting/Webinar and edit them. You can add an image and or change the description also - this change will only be visible in CC)

Editing.PNG13. Click on 'Builder'  
14. Click on 'Agenda'  
15. Select your agenda session and click on the 'Edit' icon icon 
16. Click on the 'Embed' tab

Embed-Page.PNG

17. Use the drop-down menu under 'zoom meetings & webinars' to select your meeting/Webinar Webinar 
18. Click 'Save'. Your integration is now set up and ready to test via the front end.


Step 3. FE

1. Log into FE (Front-end) using your credentials credentials 
2. Go to the Agenda module module 
3. Click on the meeting/Webinar (NOTE; if you are hosting the meeting/Webinar, you will need to return to Zoom to start the session)  
Please note: We advise that hosts join ONLY via zoom as normal to avoid any feedback loops/repeated audio. Zoom session details should be pre-filled for participants, allowing them to join the session.
4. Click on "Join meeting"

FE-Join.PNG

Please note: The host will have to start the meeting before anyone else is let in the meeting, and zoom controls on microphones and cameras etc will be there also, same as normal. Once the session is over you can simply 'leave meeting' in the usual fashion.  

 

Best Practices
  • Utilise the 'alternative hosts' feature
    In zoom you can't start concurrent meeting from the same account unless you are a licensed user on an Enterprise, Business or Education account. With these accounts, you can run 2 meetings concurrently. The only thing to rememer with this is that you still can't be in two meetings at once, so one of them will need to have an alternative host added. You could either do this at point of setup, or you could start one meeting, make someone the host, leave and then start the other meeting. Please not that you can't use alternative hosts on both meetings. To run concurrent meetings you will need to be the host of one of them. Basic and pro accounts do not have this function and can only have one meeting at a time, regardless of the use of alternative hosts. You can find more info here on alternative hosts and running concurrent meetings.

  • Utilise Scheduling privileges
    As only one Zoom account can be linked to a CrowdComms platform, this feature could be a good way to set up your meetings. This allows you to give privileges to another user or users to set up meetings on your behalf. You could give scheduling privileges to all users who need to run the meetings so they can set them up and also therefore act as an alternative host. this will require a bit more setup and the use of a plugin so please allow yourself time to set this up and test in enough time ahead of your event. To use this feature, both yourself and those you are giving privileges to need to be licensed users, or they can be sub accounts on your master account. For more information on this, please see here

  • Utilise zoom's own breakout feature
    If this setup suits your needs, this will be the easiest to set up as you only need to set up one meeting in zoom which everyone can join through the platform. You will still need to set some things up in zoom first, but it will avoid the concurrent meetings issue. then people can breakout using zoom's own feature. You will need to be the account owner or have admin privileges to set this up and will need to enable breakout rooms via your account. You can assign people automatically, manually, or let participants choose. If you want to pre-assign people, then all users will need to have a zoom account. Be extra careful with this option as they would therefore need to be using the same email for the CrowdComms platform for it to work. Some useful links on this feature can be found here for enabling breakout rooms, managing breakout rooms & pre-assigning participants to breakout rooms.

 

Notes

  • Meetings will show upcoming only (not previous meetings)
  • Webinars will show both upcoming and previous Webinars Webinars 
  • Authenticated Webinars are not supported supported 
  • Two people can not both use the same Zoom account to be a host & a delegate (One would be timed out from joining the Webinar)  

Troubleshooting Troubleshooting 

If you are have an error message when authorising the integration via the plugins page, please check the below with your setup in zoom:

CMS

  • Check the redirect URL is correct correct 
  • Check that the whitelist URL is correctly filled in in 
  • Make sure the JWT and OAuth are the correct way round  round  

Front End

  • Joining Zoom before the host has started the session will present you with a 'Joining meeting, timeout' message (Click 'Retry or Ok'
  • If you are presented with a 'The session has expired or is no longer valid' message, click 'Retry'  

If you still face trouble after going through this guide, please contact your support agent.


How to create a JWT:
https://marketplace.zoom.us/docs/guides/build/jwt-app#:~:text=To%20register%20your%20app%2C%20visit,type%20and%20click%20on%20Create.

How to create OAuth:
https://marketplace.zoom.us/docs/guides/build/oauth-app  

Developer Accounts
https://marketplace.zoom.us/docs/sdk/native-sdks/developer-accounts

User Role Management:
https://support.zoom.us/hc/en-us/articles/115001078646-Role-Based-Access-Control

Zoom User Types & Roles:
https://support.zoom.us/hc/en-us/articles/201363173-Account-types

 

Back to top