README.md

Zoom

Prerequisites

As of July 2023, pulling historical data (last 6 months) and all scheduled and instant meetings requires a Zoom paid account on Pro or higher plan (Business, Business Plus). On other plans Zoom data may be incomplete.

Accounts on unpaid plans do not have access to some methods Worklytics use like:

• Zoom Reports API -required for historical data
• certain Zoom Meeting API methods such as retrieving past meeting participants

Examples

• Example Rules
• Example Data : original/meeting-details.json | sanitized/meeting-details

See more examples in the docs/sources/zoom/example-api-responses folder of the Psoxy repository.

Steps to Connect

The Zoom connector through Psoxy requires a Custom Managed App on the Zoom Marketplace. This app may be left in development mode; it does not need to be published.

1. Go to https://marketplace.zoom.us/develop/create and create an app of type "Server to Server OAuth" for creating a server-to-server app.

2. After creation, it will show the App Credentials.

   Copy the following values:

   • Account ID
   • Client ID
   • Client Secret

   

   Share them with the AWS/GCP administrator, who should fill them in your host platform's secret manager (AWS Systems Manager Parameter Store / GCP Secret Manager) for use by the proxy when authenticating with the Zoom API:

   • Account ID --> PSOXY_ZOOM_ACCOUNT_ID
   • Client ID --> PSOXY_ZOOM_CLIENT_ID
   • Client Secret --> PSOXY_ZOOM_CLIENT_SECRET

   NOTE: Anytime the Client Secret is regenerated it needs to be updated in the Proxy too. NOTE: Client Secret should be handled according to your organization's security policies for API keys/secrets as, in combination with the above, allows access to your organization's data.

3. Fill the 'Information' section. Zoom requires company name, developer name, and developer email to activate the app.

4. No changes are needed in the 'Features' section. Continue.

5. Fill the scopes section clicking on + Add Scopes and adding the following:

• meeting:read:past_meeting:admin

• meeting:read:meeting:admin

• meeting:read:list_past_participants:admin

• meeting:read:list_past_instances:admin

• meeting:read:list_meetings:admin

• meeting:read:participant:admin

• report:read:list_meeting_participants:admin

• report:read:meeting:admin

• report:read:user:admin

• user:read:user:admin

• user:read:list_users:admin

  

Alternatively, the scopes: user:read:admin, meeting:read:admin, report:read:admin are sufficient, but as of May 2024 are no longer available for newly created Zoom apps.

Once the scopes are added, click on Done and then Continue.

6. Activate the app