Deploying imper.ai for Zoom

Prev Next

This article provides end-to-end instructions for deploying imper.ai for Zoom.

It covers both:

  • The technical integration of Zoom as a communication channel, and

  • The steps required to activate meeting protection for Zoom meetings created by protected users.

Zoom integrations involve multiple components, including Server-to-Server OAuth, event subscriptions, and optional client-side deployment.

Follow the steps in the order listed to ensure successful deployment and protection.


Prerequisites

Before connecting imper.ai to Zoom, administrators must ensure that all prerequisites are met and that deployment steps are completed in the correct order.

Before you begin, ensure that:

  • A supported Identity Provider (IdP) is already connected in imper.ai:

    • Microsoft Entra ID or

    • Google Workspace

  • You have Zoom account administrator privileges

  • Your Zoom account supports Server-to-Server OAuth apps

  • You have Admin access to the imper.ai Admin Console

  • Outbound connectivity to Zoom APIs is allowed from your environment

  • You have reviewed internal security and compliance requirements for third-party integrations

Some Zoom configuration steps must be performed by an account-level admin.
Role-based admins may not have sufficient permissions.


Integration Components

The Zoom deployment consists of several dependent components that work together to enable meeting protection:

  • Zoom Communication Channel

    Uses Zoom APIs, webhooks, and event subscriptions to monitor meetings and participants.

  • Zoom Permissions

    Required to retrieve meeting metadata, participant context, and security signals. The full list of permissions requested by imper.ai, including scope descriptions and security considerations, is documented separately.

    Zoom Permissions

  • imper.ai Zoom Add-on (optional)

    A Zoom client add-on that provides protected users with in-meeting visibility and verification indicators.

    The add-on does not replace backend monitoring.

Each component is configured separately and activated in sequence.


What Not to Do

To avoid configuration issues:

  • Do not deploy the Zoom Add-on before connecting the Zoom communication channel

  • Do not skip the permissions review

  • Do not assume the Zoom Add-on replaces backend integration

  • Do not mix end-user steps into the administrator onboarding process


Deployment Procedure

Step 1: Begin Zoom Connection

  1. Log in to imper.ai using your administrator credentials or Single Sign-On (SSO).

  2. Navigate to Integrations.

  3. In the Zoom Interaction Channel, click Connect.

Integration options for various platforms displayed on the Imper.ai dashboard interface.

The Zoom integration pop-up window opens.

Settings interface for Zoom integration with fields for Account ID and Client secret.

  1. In the pop-up window, click Go to Zoom Marketplace. If prompted, authenticate using the same Zoom admin account.

This redirects you to the Zoom App Marketplace to create the required OAuth app.


Step 2: Create a Server-to-Server OAuth App

  1. In the Zoom App Marketplace, open the top-right menu and select Develop > Build App.

Zoom App Marketplace interface showing options to develop and manage applications.

  1. Choose Server-to-Server OAuth App when asked, “What kind of app are you creating?”

Options for creating different types of Zoom applications are displayed on the screen.

  1. Name the application imper.ai (recommended) and click Next.

You’ll be redirected to the App Credentials tab.


Step 3: Copy Your Credentials to imper.ai

  1. In the App Credentials tab, copy the following and paste them into the corresponding fields in the imper.ai Zoom Connection dialog:

  • Account ID

  • Client ID

  • Client Secret

App credentials section displaying Account ID, Client ID, and Client Secret for Zoom API.

  1. After pasting these into the imperial.ai Zoom Connection dialog, return to Zoom and click Continue.


Step 4: Complete the App Setup in Zoom

  1. In the Information tab, fill in the required information and click Continue.

App credentials form displaying basic information and developer contact details for ImperStaging.

  1. In the Feature tab, Zoom generates a Secret Token.

Zoom app settings showing feature token and instructions for event notifications.

  1. Copy the Secret Token.

  2. Paste it into imper.ai Zoom Connection dialog.

  3. Click Save Settings.

imper.ai will display a second window containing a webhook endpoint URL that must be added inside Zoom.

Instructions for Zoom integration, including webhook URL and installation steps.

Important

Do not click Finish yet.


Step 5: Configure Event Subscriptions

  1. In the Zoom App Marketplace, enable Event Subscriptions.

  2. Enter a Subscription name (e.g., imper.ai Webhook).

  3. Choose the Webhook method option.

  4. Paste the webhook endpoint URL shown in imper.ai (from the previous step).

  5. Click Validate.

You should see a Validated badge.

Zoom App Marketplace event subscriptions with webhook method and endpoint URL validation.


Step 6: Add Required Zoom Event Types

  1. In Event Types, add the following nine Meeting events:

  • Start Meeting

  • End Meeting

  • Participant joined meeting before host

  • Participant waiting for host to join

  • Participant/Host joined meeting

  • Participant/Host left meeting

  • Meeting has been created

  • Meeting has been updated

  • Meeting has been deleted

List of event types with checkboxes for meeting-related actions and requirements.

  1. After selecting these events, click Save.


Step 7: Add Required Scopes

In the Scopes section of the app, add the following admin-level scopes:

  • user:read:list_users:admin

  • user:read:user:admin

User permissions display with options to view user information and actions available.

These allow imper.ai to sync user accounts, validate identities, and analyze meeting participation.

For a detailed explanation of each permission and how it is used, see Zoom Permissions.


Step 8: Activate the Zoom App

  1. Activate your Zoom application.

  2. Once activation is confirmed, return to imper.ai and click Finish in the Zoom Connection dialog.

Confirmation message indicating app activation and permission to use Zoom APIs.

In the imper.ai Integrations page, the Zoom Communication Channel should now appear as Connected.

Zoom application icon indicating a successful connection status.


Integration Complete

Zoom is now successfully connected to imper.ai.

From this point forward:

  • Zoom meetings are monitored automatically

  • Participant verification and risk scoring are applied in real time

  • Results are available in the imper.ai console


Verification and Status

Once users are added:

  • imper.ai wraps Zoom meeting links created by protected users with a secure verification link

  • imper.ai begins monitoring Zoom meetings automatically

  • No additional configuration is required to activate protection


What Happens During a Zoom Meeting

For meetings created by protected users:

  1. A participant clicks the wrapped Zoom meeting link.

  2. imper.ai intercepts the link and initiates verification.

  3. Identity and contextual signals are evaluated in real time.

  4. After verification, the participant is redirected to the Zoom meeting.

Verification results and meeting activity are available in the imper.ai console.


Validate the Deployment

  1. Create a test Zoom meeting.

  2. Verify that the meeting link is wrapped by imper.ai.

  3. Confirm that participants are redirected to the verification flow.

  4. Review meeting status and activity in the imper.ai console.


Next Steps

After validating the deployment, manage protected users, investigate monitored meetings, and respond to risk using Communication Channel Protection.