Zoom
Zoom is a cloud-based video and audio conferencing platform. It allows you to set up virtual video and audio conferencing, one-to-one chat sessions, webinars, live chats, screen-sharing, and other collaborative capabilities.
Zoom can be connected with Relyance AI using either:
Which method to choose
Both are listed above; the difference that matters later is what holds the authorisation:
| Method | Authorises as | Needs re-authorising? |
|---|---|---|
| Server-to-Server App (recommended) | the app itself, using Account ID + Client ID/Secret | No |
| OAuth2 / App Token | the user who completed the browser flow | Yes, when their grant is revoked or expires |
A Server-to-Server app also keeps the connection independent of any one person's Zoom account remaining active, which is the usual reason a working Zoom connection stops.
Creating Server-to Server App in Zoom
- Login to your Zoom account.
- On the side menu expand the Admin section and click Advanced and then App MarketPlace.
- In the top right corner click on the Develop dropdown and select Build App.
\NoteIf you've already created an app then click on the Manage link beside the drop-down.
- Choose Server-to-Server OAuth App in the resulting dialog and click Create.
- Provide a meaningful name as the App Name (e.g. Relyance Scan).
- Copy the Account ID, Client ID and Client Secret to be used in Relyance.
- In the OAuth Information section, fill in the fields - Short Description, Company Name, Developer Contact information (these fields are mandatory to activate the app) ,and click Continue
- Click Scopes from the left-hand navigation menu.\
- Click on the Add Scopes button.
- The list of scopes that should be added is here:
Contact Center
- contact_center_inbox:read:admin
- contact_center_queue:read:admin
- contact_center_recording:read:admin
- contact_center_region:read:admin
- contact_center_skill:read:admin
- contact_center_user:read:admin
- contact_center:delete:queue_supervisor:admin
- contact_center:read:inbox_user:admin
- contact_center:read:list_address_book_contacts:admin
- contact_center:read:list_address_books:admin
- contact_center:read:list_engagements:admin
- contact_center:read:list_inboxes:admin
- contact_center:read:list_queue_agents:admin
- contact_center:read:list_queues:admin
- contact_center:read:list_recordings:admin
- contact_center:read:list_region_users:admin
- contact_center:read:list_regions:admin
- contact_center:read:list_skill_users:admin
- contact_center:read:list_skills:admin
- contact_center:read:list_users:admin
- contact_group:read:list_groups:admin
- contact_group:read:list_members:admin
Contact Group - contact_group:read:list_groups:admin
- contact_group:read:list_members:admin
Dashboard - dashboard:read:chat:admin
- dashboard:read:list_meeting_participants_qos:admin
- dashboard:read:list_meeting_participants:admin
- dashboard:read:list_meetings:admin
- dashboard:read:list_webinar_participants_qos:admin
- dashboard:read:list_webinars:admin
- dashboard:read:meeting_sharing:admin
- dashboard:read:meeting:admin
- dashboard:read:zoomroom:admin
Device - device:read:list_groups:admin
- device:read:list_zdm_devices:admin
Mail - email:read:list_setting_filters
- email:read:profile:admin
- email:read:setting_filter:admin
Groups - group:read:list_groups:admin
Marketplace - marketplace:read:app_request:admin
- marketplace:read:app:admin
- marketplace:read:list_apps:admin
Meetings - meeting:read:list_meetings:admin
- meeting:read:list_past_instances:admin
- meeting:read:list_past_participants:admin
- meeting:read:list_poll_results:admin
- meeting:read:list_registrants:admin
- meeting:read:list_summaries:admin
- meeting:read:meeting:admin
- meeting:read:past_meeting:admin
- meeting:read:summary:admin
Phone - phone:read:call_log:admin
- phone:read:list_call_logs:admin
- phone:read:list_call_pickup_groups:admin
- phone:read:list_call_recordings:admin
- phone:read:list_external_contacts:admin
- phone:read:list_numbers:admin
- phone:read:list_recordings:admin
- phone:read:list_shared_line_appearances:admin
- phone:read:list_tracked_locations:admin
- phone:read:list_users:admin
- phone:read:list_voicemails:admin
- phone:read:role_member:admin
- phone:read:sms_charges:admin
- phone:read:user:admin
Recording - cloud_recording:read:list_user_recordings:admin
Report - report:read:admin
- report:read:list_meeting_participants:admin
- report:read:list_meeting_polls:admin
- report:read:list_users:admin
- report:read:list_webinar_polls:admin
- report:read:meeting_qna:admin
- report:read:meeting_survey:admin
- report:read:meeting:admin
- report:read:operation_logs:admin
- report:read:telephone:admin
- report:read:upcoming_meetings_webinars:admin
- report:read:user_activities:admin
- report:read:user:admin
- report:read:webinar_qna:admin
- report:read:webinar:admin
Role - role:read:list_members
- role:read:list_roles:admin
- role:read:role:admin
SCIM - scim2
Team Chat - team_chat:read:channel:admin
- team_chat:read:list_channels:admin
- team_chat:read:list_members:admin
- team_chat:read:list_user_channels:admin
- team_chat:read:list_user_messages:admin
- team_chat:read:list_user_sessions:admin
- team_chat:read:user_message:admin
Account - account:read:settings:admin
- account:read:settings:master
Group - group:read:list_groups:admin
- group:read:list_members:admin
User - user:read:list_assistants:admin
- user:read:list_collaboration_devices
- user:read:list_schedulers:admin
- user:read:list_users:admin
- user:read:settings:admin
- user:read:user:admin
Webinar - webinar:read:list_panelists:admin
- webinar:read:list_registrants:admin
- webinar:read:list_webinars:admin
- webinar:read:past_qa:admin
- webinar:read:webinar:admin
Whiteboard - whiteboard_collaborator:read:admin
- whiteboard_content:read:admin
- whiteboard:read:admin
- whiteboard:read:list_collaborators:admin
- whiteboard:read:list_sessions:admin
- whiteboard:read:list_whiteboards:admin
- whiteboard:read:session:admin
- whiteboard:read:whiteboard:admin
Zoom Rooms - zoom_rooms:read:list_rooms:admin
- zoom_rooms:read:room:admin
- zoom_rooms:read:list_locations:admin
- zoom_rooms:read:location:admin
Zoom Events - zoom_events:read:event_registration:admin
- zoom_events:read:list_coeditors:admin
- zoom_events:read:list_events:admin
- zoom_events:read:list_session_attendees:admin
- zoom_events:read:list_session_surveys:admin
- zoom_events:read:list_speakers:admin
- zoom_events:read:list_tickets:admin
Note
When creating your app, if you don't see the expected scopes in the Zoom Marketplace:
- Confirm your user role has access to all licenses within Zoom Enterprise.
- If scopes remain unavailable, it's probable your enterprise version doesn't have the appropriate licensing.
- Click Done.
- Click Continue to proceed in the wizard.
- Click on Activate App to proceed with the activation of the app
In the Relyance AI application:
- Login to your Relyance tenant
- Navigate to the Settings (bottom-left corner)
- Select Integrations
- Search and locate the Zoom integration card and click on it
- Click on the Add Connection button on the top right
- Provide a meaningful name for the integration and click on the Add button
- In the Overview section, select the integration features you wish to enable for the integration (Data Inspection, Data Subject Requests), review the Scope and Permission, and Endpoint details and click on Continue. Note
For More details see Integrations Features
- In the Connection section, provide the appropriate values and click on Continue,
- Connection Name: This property allows you to update the integration specified in Step 6. If you have multiple integrations for the same vendor, you may want to assign distinct names to each. This helps streamline filtering by Discovery Source across the Inventory, Visual Maps, Assets, and Data Flow Analysis pages.
- Rescan Frequency: This property allows you to configure how often Relyance executes scans against this Vendor connection.
- Business Atlas Associations (required): the business entities or products that newly discovered third parties, services and assets from this integration are attributed to. Choose at least one from the Select Associations dropdown — the wizard will not advance past this step without one. For more details, see Business Atlas.
- In the Authentication section, provide the Account ID, Client ID, and Client Secret into their respective fields
- If the Data Inspection check box is checked from step 7, In the Data Inspection section, provide the appropriate values and click on Continue
- Minimum Confidence Level: This property adjusts the sensitivity of the Data Inspection feature. Lower likelihoods (e.g., unlikely) offer more coverage but may produce false positives, while higher sensitivity (e.g., very likely) provides greater accuracy but less coverage.
- Review the configuration summary from the Completion section and click on Finish.
- Confirm the integration Status reflects Connected
Creating an OAuth2 App in Zoom:
- Login to your Zoom account.
- On the side menu click Advanced and then App MarketPlace.
- In the top right corner click on the Develop dropdown and select Build App.\Note
If you've already created an app then click on the Manage link beside the drop-down.
- Choose General App in the resulting dialog and click Create.
- This will open up a new App. Provide a meaningful name in the top left-hand corner (e.g. Relyance Scan).
- Ensure the manage type is Admin-managed and click on Save.
- Copy the Client ID and Client Secret to be used in Relyance.
- In the OAuth Information section, enter this value into the OAuth Redirect URL: https://root.relyance.ai/api/oauth2
- Below this, ensure you add this URL to the OAuth Allow Lists: https://root.relyance.ai/api/oauth2
- Click Scopes from the left-hand navigation menu.
- Click on the Add Scopes button
- The list of scopes that should be added is here:
Contact Center
- contact_center_inbox:read:admin
- contact_center_queue:read:admin
- contact_center_recording:read:admin
- contact_center_region:read:admin
- contact_center_skill:read:admin
- contact_center_user:read:admin
- contact_center:delete:queue_supervisor:admin
- contact_center:read:inbox_user:admin
- contact_center:read:list_address_book_contacts:admin
- contact_center:read:list_address_books:admin
- contact_center:read:list_engagements:admin
- contact_center:read:list_inboxes:admin
- contact_center:read:list_queue_agents:admin
- contact_center:read:list_queues:admin
- contact_center:read:list_recordings:admin
- contact_center:read:list_region_users:admin
- contact_center:read:list_regions:admin
- contact_center:read:list_skill_users:admin
- contact_center:read:list_skills:admin
- contact_center:read:list_users:admin
- contact_group:read:list_groups:admin
- contact_group:read:list_members:admin
Account - account:read:settings:admin
- account:read:settings:master
Contact Group - contact_group:read:list_groups:admin
- contact_group:read:list_members:admin
Dashboard - dashboard:read:chat:admin
- dashboard:read:list_meeting_participants_qos:admin
- dashboard:read:list_meeting_participants:admin
- dashboard:read:list_meetings:admin
- dashboard:read:list_webinar_participants_qos:admin
- dashboard:read:list_webinars:admin
- dashboard:read:meeting_sharing:admin
- dashboard:read:meeting:admin
- dashboard:read:zoomroom:admin
Device - device:read:list_groups:admin
- device:read:list_zdm_devices:admin
Mail - email:read:list_setting_filters
- email:read:profile:admin
- email:read:setting_filter:admin
Groups - group:read:list_groups:admin
Marketplace - marketplace:read:app_request:admin
- marketplace:read:app:admin
- marketplace:read:list_apps:admin
Meetings - meeting:read:list_meetings:admin
- meeting:read:list_past_instances:admin
- meeting:read:list_past_participants:admin
- meeting:read:list_poll_results:admin
- meeting:read:list_registrants:admin
- meeting:read:list_summaries:admin
- meeting:read:meeting:admin
- meeting:read:past_meeting:admin
- meeting:read:summary:admin
Phone - phone:read:call_log:admin
- phone:read:list_call_logs:admin
- phone:read:list_call_pickup_groups:admin
- phone:read:list_call_recordings:admin
- phone:read:list_external_contacts:admin
- phone:read:list_numbers:admin
- phone:read:list_recordings:admin
- phone:read:list_shared_line_appearances:admin
- phone:read:list_tracked_locations:admin
- phone:read:list_users:admin
- phone:read:list_voicemails:admin
- phone:read:role_member:admin
- phone:read:sms_charges:admin
- phone:read:user:admin
Recording - cloud_recording:read:list_user_recordings:admin
Report - report:read:admin
- report:read:list_meeting_participants:admin
- report:read:list_meeting_polls:admin
- report:read:list_users:admin
- report:read:list_webinar_polls:admin
- report:read:meeting_qna:admin
- report:read:meeting_survey:admin
- report:read:meeting:admin
- report:read:operation_logs:admin
- report:read:telephone:admin
- report:read:upcoming_meetings_webinars:admin
- report:read:user_activities:admin
- report:read:user:admin
- report:read:webinar_qna:admin
- report:read:webinar:admin
Role - role:read:list_members
- role:read:list_roles:admin
- role:read:role:admin
Zoom Rooms - zoom_rooms:read:list_rooms:admin
- zoom_rooms:read:list_locations:admin
SCIM - scim2
Team Chat - team_chat:read:channel:admin
- team_chat:read:list_channels:admin
- team_chat:read:list_members:admin
- team_chat:read:list_user_channels:admin
- team_chat:read:list_user_messages:admin
- team_chat:read:list_user_sessions:admin
- team_chat:read:user_message:admin
Group - group:read:list_groups:admin
- group:read:list_members:admin
User - user:read:list_assistants:admin
- user:read:list_collaboration_devices
- user:read:list_schedulers:admin
- user:read:list_users:admin
- user:read:settings:admin
- user:read:user:admin
Webinar - webinar:read:list_panelists:admin
- webinar:read:list_registrants:admin
- webinar:read:list_webinars:admin
- webinar:read:past_qa:admin
- webinar:read:webinar:admin
Whiteboard - whiteboard_collaborator:read:admin
- whiteboard_content:read:admin
- whiteboard:read:admin
- whiteboard:read:list_collaborators:admin
- whiteboard:read:list_sessions:admin
- whiteboard:read:list_whiteboards:admin
- whiteboard:read:session:admin
- whiteboard:read:whiteboard:admin
Zoom Rooms - zoom_rooms:read:list_rooms:admin
- zoom_rooms:read:room:admin
Zoom Events - zoom_events:read:event_registration:admin
- zoom_events:read:list_coeditors:admin
- zoom_events:read:list_events:admin
- zoom_events:read:list_session_attendees:admin
- zoom_events:read:list_session_surveys:admin
- zoom_events:read:list_speakers:admin
- zoom_events:read:list_tickets:admin
- Click Done.
- Click Continue to proceed in the wizard.
- On the following page you are finished. (You do not need to click Add App Now .)
In the Relyance AI application:
- Login to your Relyance account.
- Navigate to the Settings (bottom-left corner).
- Select Integrations.
- Search and locate the Zoom integration card and click on it.
- Click on the Add Connection button on the top right
- Provide a meaningful name for the integration and click on the Add button
- In the Overview section, select the integration features you wish to enable for the integration (Data Inspection, Data Subject Requests), review the Scope and Permission, and Endpoint details and click on Continue. Note
For More details see Integrations Features
- In the Connection section, provide the appropriate values and click on Continue,
- Connection Name: This property allows you to update the integration specified in Step 6. If you have multiple integrations for the same vendor, you may want to assign distinct names to each. This helps streamline filtering by Discovery Source across the Inventory, Visual Maps, Assets, and Data Flow Analysis pages.
- Rescan Frequency: This property allows you to configure how often Relyance executes scans against this Vendor connection.
- Business Atlas Associations (required): the business entities or products that newly discovered third parties, services and assets from this integration are attributed to. Choose at least one from the Select Associations dropdown — the wizard will not advance past this step without one. For more details, see Business Atlas.
- In the Authentication section, provide the Client ID, and Client Secret into their respective fields
- If the Data Inspection check box is checked from step 7, In the Data Inspection section, provide the appropriate values and click on Continue
- Minimum Confidence Level: This property adjusts the sensitivity of the Data Inspection feature. Lower likelihoods (e.g., unlikely) offer more coverage but may produce false positives, while higher sensitivity (e.g., very likely) provides greater accuracy but less coverage.
- Minimum Confidence Level: This property adjusts the sensitivity of the Data Inspection feature. Lower likelihoods (e.g., unlikely) offer more coverage but may produce false positives, while higher sensitivity (e.g., very likely) provides greater accuracy but less coverage.
- Review the configuration summary from the Completion section and click on Finish
Manage this integration with Terraform
Connections for this integration can be managed as code with the Relyance Terraform provider. Non-secret fields go in auth.params; secret fields go in auth.secrets_wo, which is write-only — never stored in Terraform state. Rotate secrets by bumping auth.secrets_wo_version.
OAuth (browser authorization)
The OAuth (browser authorization) method uses a browser authorization flow, so the connection is created in the Relyance app. Manage it in Terraform afterwards by importing it (terraform import relyance_integration_connection.example zoom/<connection_id>) or reading it with the relyance_integration_connection data source.
OAuth client credentials
resource "relyance_integration_connection" "zoom_1" {
vendor = "zoom"
name = "<your connection name>"
auth = {
method = "oauth-client-credentials"
params = {
account_id = "<account_id>"
client_id = "<client_id>"
data_storage_location = "us"
}
# Secret fields are write-only: sent to Relyance, never stored in state.
secrets_wo = {
client_secret = var.zoom_client_secret
}
secrets_wo_version = 1
}
scans = { "data-inspection" = { enabled = true } }
}