> ## Documentation Index
> Fetch the complete documentation index at: https://docs.langdock.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Zoom

> Connect Zoom to Langdock to manage meetings, access recordings, and retrieve transcripts from your conversations

## Overview

Zoom is a video conferencing platform for meetings, webinars, and collaboration. Once connected, you can use Langdock to schedule meetings, access recordings, and retrieve transcripts directly from your conversations.

<Info>
  **Authentication:** OAuth
  **Category:** Productivity & Collaboration
  **Availability:** All workspace plans
</Info>

## Prerequisites

Before setting up the integration, make sure you have:

* A Zoom account with permission to authorize third-party OAuth applications
* Cloud recording enabled on your Zoom account if you want to access recordings and transcripts
* Zoom AI Companion enabled if you want to use meeting summaries

## Setup

<Steps>
  <Step title="Navigate to Integrations">
    In Langdock, go to [Integrations](https://app.langdock.com/integrations) and find **Zoom** in the integrations list.
  </Step>

  <Step title="Connect via OAuth">
    Click **Connect** to start the OAuth flow. You will be redirected to Zoom to authorize Langdock.
  </Step>

  <Step title="Authorize access">
    Log in to your Zoom account if prompted, then approve the requested permissions to grant Langdock access.
  </Step>

  <Step title="Start using Zoom in Langdock">
    After authorization, you will be redirected back to Langdock. Tag the integration with `@` in any agent to start managing your meetings and recordings.
  </Step>
</Steps>

## Setup for Dedicated Deployments

Dedicated deployment customers cannot use the standard Zoom Marketplace app because the OAuth redirect URL must point to your dedicated Langdock instance. Instead, you need to create your own Zoom OAuth app and configure it in Langdock using a custom OAuth client.

### Prerequisites

* Zoom admin or developer account with access to the [Zoom App Marketplace](https://marketplace.zoom.us/)
* Admin access to your dedicated Langdock instance

### Step 1: Create a Zoom OAuth App

<Steps>
  <Step title="Open the Zoom App Marketplace">
    Go to the [Zoom App Marketplace](https://marketplace.zoom.us/) and sign in with your Zoom account. Click **Develop** in the top navigation and select **Build App**.
  </Step>

  <Step title="Configure basic information">
    Update the app name and configure the following:

    * **App Name**: Choose a descriptive name (e.g., "Langdock")
    * **App Management Type**: Select **User-managed** so individual users can connect their own Zoom accounts
    * **OAuth Redirect URL**: Enter the redirect URL from your Langdock instance. To find it, go to **Workspace settings > Integrations > Zoom** in your Langdock instance and configure a new OAuth client. The redirect URL will be displayed in the configuration dialog.

    <Warning>
      The redirect URL must match exactly. Any mismatch will cause `redirect_uri_mismatch` errors during authentication.
    </Warning>
  </Step>

  <Step title="Configure scopes">
    Navigate to the **Scopes** section and add the following scopes:

    **Recording**

    * `cloud_recording:read:meeting_transcript`
    * `cloud_recording:read:recording`
    * `cloud_recording:read:list_recording_files`
    * `cloud_recording:read:list_user_recordings`

    **User**

    * `user:read:email`
    * `user:read:user`

    **Meetings**

    * `meeting:read:past_meeting`
    * `meeting:read:meeting`
    * `meeting:read:list_past_instances`
    * `meeting:read:list_meetings`
    * `meeting:read:list_upcoming_meetings`
    * `meeting:write:meeting`
    * `meeting:read:summary`

    <Warning>
      All scopes listed above are required. Missing scopes will cause errors when users try to access certain Zoom features through Langdock.
    </Warning>
  </Step>

  <Step title="Save your credentials">
    After creating the app, note down the **Client ID** and **Client Secret** from the app's credentials page. You will need these in the next step.
  </Step>
</Steps>

### Step 2: Add the App to Users

Once the app is created, you need to add it to the Zoom users who should be able to connect with Langdock.

<Tabs>
  <Tab title="Add for all users or specific users">
    Choose **Add app for others** and select either specific users or all users in your Zoom account. This option also allows you to configure additional app settings.
  </Tab>

  <Tab title="Add for yourself only">
    Choose **Add app for yourself** to enable the integration for your own account. This option does not provide access to additional app settings.
  </Tab>
</Tabs>

After adding, you can manage users and their permissions under the **Users & groups** tab in the app's admin view.

### Step 3: Configure the OAuth Client in Langdock

<Steps>
  <Step title="Open integration settings">
    In your dedicated Langdock instance, navigate to **Workspace settings > Integrations** and find **Zoom**. Switch the OAuth client from **Langdock client** to **Your client** using the dropdown.
  </Step>

  <Step title="Enter credentials">
    Enter the **Client ID** and **Client Secret** from the Zoom app you created in Step 1, then click **Save**.
  </Step>

  <Step title="Test the connection">
    Have a user connect their Zoom account to verify:

    * The OAuth consent screen appears correctly
    * All required scopes are granted
    * Zoom data (meetings, recordings) is accessible through Langdock
  </Step>
</Steps>

## Common Use Cases

<CardGroup cols={2}>
  <Card title="Meeting Management" icon="video">
    Schedule new meetings, retrieve upcoming or past meetings, and access meeting details like join links and settings
  </Card>

  <Card title="Meeting Summaries" icon="file-lines">
    Retrieve AI-generated summaries for completed meetings (requires Zoom AI Companion)
  </Card>

  <Card title="Recordings" icon="circle-dot">
    Browse cloud recordings, access recording files, and retrieve full text transcripts
  </Card>

  <Card title="Recurring Meetings" icon="rotate">
    Look up past instances of recurring meetings to track specific occurrences
  </Card>
</CardGroup>

## Example Prompts

* "Schedule a 30-minute meeting called 'Q2 Planning' for tomorrow at 2pm Berlin time"
* "What meetings do I have coming up this week?"
* "Get the transcript from my last all-hands recording"
* "Show me the summary of yesterday's team standup"
* "List all recordings from last month"

## Permissions

The integration requests the following Zoom scopes:

| Category      | Scopes                                                                                                                                                                                                        |
| ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Recording** | `cloud_recording:read:meeting_transcript`, `cloud_recording:read:recording`, `cloud_recording:read:list_recording_files`, `cloud_recording:read:list_user_recordings`                                         |
| **User**      | `user:read:email`, `user:read:user`                                                                                                                                                                           |
| **Meetings**  | `meeting:read:past_meeting`, `meeting:read:meeting`, `meeting:read:list_past_instances`, `meeting:read:list_meetings`, `meeting:read:list_upcoming_meetings`, `meeting:write:meeting`, `meeting:read:summary` |

## Notes

* Meeting summaries require **Zoom AI Companion** to be enabled on your Zoom account
* Transcripts are only available for cloud recordings where transcription was enabled
* Creating a meeting requires your confirmation before the meeting is scheduled
