> ## 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

> Verbinde Zoom mit Langdock, um Meetings zu verwalten, Aufzeichnungen abzurufen und Transkripte direkt aus deinen Conversations zu erhalten

## Überblick

Zoom ist eine Videokonferenz-Plattform für Meetings, Webinare und Zusammenarbeit. Nach der Verbindung kannst du über Langdock Meetings planen, Aufzeichnungen abrufen und Transkripte direkt aus deinen Conversations heraus anfordern.

<Info>
  **Authentifizierung:** OAuth
  **Kategorie:** Produktivität & Zusammenarbeit
  **Verfügbarkeit:** Alle Workspace-Pläne
</Info>

## Voraussetzungen

Bevor du die Integration einrichtest, stelle sicher, dass du Folgendes hast:

* Ein Zoom-Konto mit der Berechtigung, OAuth-Anwendungen von Drittanbietern zu autorisieren
* Cloud-Aufzeichnung in deinem Zoom-Konto aktiviert, wenn du auf Aufzeichnungen und Transkripte zugreifen möchtest
* Zoom AI Companion aktiviert, wenn du Meeting-Zusammenfassungen nutzen möchtest

## Einrichtung

<Steps>
  <Step title="Zu Integrationen navigieren">
    Geh in Langdock zu [Integrationen](https://app.langdock.com/integrations) und suche **Zoom** in der Integrationsliste.
  </Step>

  <Step title="Über OAuth verbinden">
    Klicke auf **Verbinden**, um den OAuth-Flow zu starten. Du wirst zu Zoom weitergeleitet, um Langdock zu autorisieren.
  </Step>

  <Step title="Zugriff autorisieren">
    Melde dich bei deinem Zoom-Konto an, falls nötig, und genehmige die angeforderten Berechtigungen, um Langdock Zugriff zu gewähren.
  </Step>

  <Step title="Zoom in Langdock verwenden">
    Nach der Autorisierung wirst du zurück zu Langdock weitergeleitet. Tagge die Integration mit `@` in einem beliebigen Agenten, um deine Meetings und Aufzeichnungen zu verwalten.
  </Step>
</Steps>

## Einrichtung für Dedicated Deployments

Kunden mit Dedicated Deployment können die Standard Zoom Marketplace App nicht verwenden, da die OAuth Redirect URL auf die eigene Langdock Instanz verweisen muss. Stattdessen musst du eine eigene Zoom OAuth App erstellen und diese in Langdock als eigenen OAuth Client konfigurieren.

### Voraussetzungen

* Zoom Admin- oder Entwicklerkonto mit Zugang zum [Zoom App Marketplace](https://marketplace.zoom.us/)
* Admin-Zugriff auf deine dedizierte Langdock Instanz

### Schritt 1: Zoom OAuth App erstellen

<Steps>
  <Step title="Zoom App Marketplace öffnen">
    Geh zum [Zoom App Marketplace](https://marketplace.zoom.us/) und melde dich mit deinem Zoom-Konto an. Klicke in der oberen Navigation auf **Develop** und wähle **Build App**.
  </Step>

  <Step title="Grundinformationen konfigurieren">
    Aktualisiere den App-Namen und konfiguriere Folgendes:

    * **App Name**: Wähle einen aussagekräftigen Namen (z. B. „Langdock")
    * **App Management Type**: Wähle **User-managed**, damit einzelne Nutzer ihre eigenen Zoom-Konten verbinden können
    * **OAuth Redirect URL**: Gib die Redirect URL deiner Langdock Instanz ein. Du findest sie unter **Workspace-Einstellungen > Integrationen > Zoom** in deiner Langdock Instanz, wenn du einen neuen OAuth Client konfigurierst. Die Redirect URL wird im Konfigurationsdialog angezeigt.

    <Warning>
      Die Redirect URL muss exakt übereinstimmen. Jede Abweichung führt zu `redirect_uri_mismatch`-Fehlern bei der Authentifizierung.
    </Warning>
  </Step>

  <Step title="Scopes konfigurieren">
    Navigiere zum Bereich **Scopes** und füge die folgenden Scopes hinzu:

    **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>
      Alle oben aufgeführten Scopes sind erforderlich. Fehlende Scopes führen zu Fehlern, wenn Nutzer bestimmte Zoom-Funktionen über Langdock nutzen möchten.
    </Warning>
  </Step>

  <Step title="Zugangsdaten speichern">
    Notiere dir nach dem Erstellen der App die **Client ID** und das **Client Secret** von der Zugangsdaten-Seite der App. Du benötigst diese im nächsten Schritt.
  </Step>
</Steps>

### Schritt 2: App zu Nutzern hinzufügen

Nach dem Erstellen der App musst du sie den Zoom-Nutzern zuweisen, die sich mit Langdock verbinden können sollen.

<Tabs>
  <Tab title="Für alle oder bestimmte Nutzer hinzufügen">
    Wähle **Add app for others** und wähle entweder bestimmte Nutzer oder alle Nutzer in deinem Zoom-Konto aus. Diese Option ermöglicht es dir auch, zusätzliche App-Einstellungen zu konfigurieren.
  </Tab>

  <Tab title="Nur für dich selbst hinzufügen">
    Wähle **Add app for yourself**, um die Integration für dein eigenes Konto zu aktivieren. Diese Option bietet keinen Zugriff auf zusätzliche App-Einstellungen.
  </Tab>
</Tabs>

Nach dem Hinzufügen kannst du Nutzer und deren Berechtigungen im Tab **Users & groups** in der Admin-Ansicht der App verwalten.

### Schritt 3: OAuth Client in Langdock konfigurieren

<Steps>
  <Step title="Integrationseinstellungen öffnen">
    Navigiere in deiner dedizierten Langdock Instanz zu **Workspace-Einstellungen > Integrationen** und finde **Zoom**. Wechsle den OAuth Client über das Dropdown von **Langdock client** zu **Your client**.
  </Step>

  <Step title="Zugangsdaten eingeben">
    Gib die **Client ID** und das **Client Secret** aus der in Schritt 1 erstellten Zoom App ein und klicke auf **Speichern**.
  </Step>

  <Step title="Verbindung testen">
    Lass einen Nutzer sein Zoom-Konto verbinden, um zu überprüfen:

    * Der OAuth-Zustimmungsbildschirm wird korrekt angezeigt
    * Alle erforderlichen Scopes werden gewährt
    * Zoom-Daten (Meetings, Aufzeichnungen) sind über Langdock zugänglich
  </Step>
</Steps>

## Häufige Anwendungsfälle

<CardGroup cols={2}>
  <Card title="Meeting-Verwaltung" icon="video">
    Neue Meetings planen, bevorstehende oder vergangene Meetings abrufen und Meeting-Details wie Beitrittlinks und Einstellungen einsehen
  </Card>

  <Card title="Meeting-Zusammenfassungen" icon="file-lines">
    KI-generierte Zusammenfassungen für abgeschlossene Meetings abrufen (erfordert Zoom AI Companion)
  </Card>

  <Card title="Aufzeichnungen" icon="circle-dot">
    Cloud-Aufzeichnungen durchsuchen, Aufzeichnungsdateien abrufen und vollständige Texttranskripte erhalten
  </Card>

  <Card title="Wiederkehrende Meetings" icon="rotate">
    Vergangene Instanzen wiederkehrender Meetings abrufen, um bestimmte Vorkommen nachzuverfolgen
  </Card>
</CardGroup>

## Beispiel-Prompts

* "Plane ein 30-minütiges Meeting namens 'Q2 Planung' für morgen um 14 Uhr Berliner Zeit"
* "Welche Meetings habe ich diese Woche?"
* "Hole das Transkript meiner letzten All-Hands-Aufzeichnung"
* "Zeig mir die Zusammenfassung des gestrigen Team-Standups"
* "Liste alle Aufzeichnungen vom letzten Monat auf"

## Berechtigungen

Die Integration fordert folgende Zoom-Berechtigungen an:

| Kategorie     | 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` |

## Hinweise

* Meeting-Zusammenfassungen erfordern **Zoom AI Companion** in deinem Zoom-Konto
* Transkripte sind nur für Cloud-Aufzeichnungen verfügbar, bei denen die Transkription aktiviert war
* Das Erstellen eines Meetings erfordert deine Bestätigung, bevor das Meeting geplant wird