Artisan IMG > Zoom (zoom) (72a0b340-4c94-465d-863a-e83b403cd1b6)

Zoom
3.1

Zoom makes video and web conferencing frictionless.

Overview
Copy

The Zoom connector on Tray allows you to manage and update user information and content for the Zoom account. It enables managing operations at the personal as well as organizational level.

Note that the Zoom connector requires administrative-level permissions.

API Information
Copy

The Zoom connector has the following Base URL: https://api.zoom.us/v2. More information can be found on their main API documentation (v2) site. Details regarding their API limitations can be found here.

Authentication
Copy

Before you start using the Zoom connector, you will have to create the authentication.

To do so, with the Zoom connector step highlighted, in the properties panel on the right, click the 'Authenticate' tab and 'Add new authentication'.

Version 3.0+
Copy

Note that if you are using your own OAuth application, that application must have the `user:read:admin` scope.

The first page will ask you to name your authentication.

In the next step, it asks for your 'Client ID' and 'Client secret'.

To find the above-asked credentials, go to the Zoom Marketplace site. Click 'Manage' from the top right corner of the screen.

Select your app and then click the 'App Credentials' tab from the left panel.

Use the values for the 'Client ID' and 'Client secret' available on this page.

Once done, click the 'Create authentication' button.

Version 2.0 and earlier
Copy

The first page will ask you to name your authentication. In the next step, it asks to select the 'Environment' of your choice.

Once done, click the 'Create authentication' button. On doing so, you will be prompted to sign in to your Zoom account.

Zoom trigger
Copy

If you wish your workflow to be kicked off by a particular action in Zoom, you can use the Zoom Trigger.

The Zoom trigger allows you to receive notifications and trigger workflows when given events occur associated with the selected trigger operation.

IMPORTANT!: The zoom trigger does not activate for Webinars, unless the user has an Enterprise Tier Account. Lower tier accounts cannot use this trigger for Webinars.

Trigger operation available:
Copy

  • Webhook

Instead of using a connector, choose Zoom as your trigger at the 'Create new workflow' section and wait to be redirected to your new workflow.

Use the instructions above to authenticate your trigger, and select from the options available the event you want your trigger to listen to, in order to set off the workflow itself:

Example 1 - List meetings
Copy

To use this operation, select the 'List meetings' operation in the input panel. Select the user ID from the drop down menu. You also have the option to select the meeting type to filter the meetings. Once you have provided the input fields as required click the 'Run workflow' button.

Example 2 - Get webinar report
Copy

To use this operation, select the 'Get webinar report' operation in the input panel. This operation allows you to retrieve a detail report for a specific webinar. Add the webinar ID that you would like to retrieve and click 'Run workflow' button. You can find a list of webinar IDs by using the 'List webinar operation'.

Uninstalling the Tray Addon
Copy

Uninstalling the Tray addon will be done from your Zoom dashboard.

To do this first login to your Zoom Account and navigate to the Zoom App Marketplace .

Click 'Manage' and select 'Installed Apps'. Find the Tray application and press the 'Uninstall' button.

Notes for Embedded customers
Copy

Custom OAuth apps
Copy

You can create a custom OAuth app in order to White-label your authentications dialog in during your integrations.

Simply follow the steps outlined below:

Scopes
Copy

Please be aware of the following points when dealing with scopes while using an Embedded account:

  • The scopes you use for your source / master workflow are the scopes that your end users will have when creating the auth.

  • You can also override scopes in the solution editor. This will allow you to specify that only a subset of the scopes set in the master workflow are available to your End Users. Please reach out to your Tray technical support if you wish to activate this feature.

  • When creating an OAuth app in the Zoom UI, you shouldn't set granular scopes. This way, you would have to create a custom OAuth app for every integration that you create for this service to enforce scope limitation.

    • A better way would be to use the standard method of setting the scopes when you are creating an authentication in your source / master workflow for each Solution. This way you can have multiple integrations that use the same custom OAuth app and control them within Tray.