Vergrößern

  # Zoom Transcript Integration

Empfangen und automatisieren Sie in Botpress die Mitschriften von Zoom-Meetings, die von bestimmten Zoom-Benutzern abgehalten werden.

## So funktioniert es

1. **Zoom-Meeting endet** → Zoom sendet einen webhook , wenn die Abschrift fertig ist.
2. **Integrationsfilter `host_id`** → Erlaubt nur Ereignisse von bestimmten Zoom-Benutzern.
3. **Transkript wird abgeholt und gesäubert** → Heruntergeladen von Zoom und konvertiert in einfachen Text.
4. **Ereignis wird ausgegeben** → Ein "TranscriptReceived"-Ereignis mit "MeetingUUID" und "Transcript" ist für Ihre Abläufe verfügbar.

---

## Verwendung

- **Workflows auslösen** → Fügen Sie eine "Listen to Event"-Karte für `transcriptReceived` hinzu.
- **Zugriff auf Daten** → Verwenden Sie `event.payload.meetingUUID` und `event.payload.transcript` in Workflows.
- **Transkripte speichern** → In Tabellen für spätere Analysen oder Berichte speichern.

---

## Voraussetzungen

Sie müssen sein:
- Ein Zoom **Kontoinhaber**, **Admin** oder die **Rolle "Zoom für Entwickler "**, um die Zoom OAuth App erstellen zu können
- Sie müssen einen **Zoom-Premium-Tarif** haben (die kostenlose Version unterstützt keine Cloud-Aufnahmen)

---

## Schritt-für-Schritt-Einrichtung

### 1. Erstellen Sie eine Zoom OAuth App

- Besuchen Sie: [https://marketplace.zoom.us/](https://marketplace.zoom.us/)
- Gehen Sie zu **Entwickeln > App erstellen** → Wählen Sie **Server-to-Server OAuth** → Benennen Sie Ihre App
- Kopieren Sie auf der Seite **App Credentials**:
  - **Account ID**
  - **Client ID**
  - **Client-Geheimnis**

Sie werden diese Daten später in der Konfiguration der Botpress verwenden.

- Geben Sie unter **Information** die erforderlichen Informationen über sich selbst und die App ein.
- Kopieren Sie unter **Features** das **Secret Token**.
- Fügen Sie unter **Scopes** hinzu:
cloud_recording:read:list_user_recordings:admin
wolkenaufzeichnung:lesen:liste_aufzeichnung_dateien:admin
cloud_recording:read:aufnahme:admin

- Aktivieren Sie die App unter der Registerkarte **Aktivierung**.

### 2. Zoom `host_id` abrufen

Sie können Ihre Zoom `Host_id` direkt im Zoom Webportal finden.

#### Schritte:
1. Melden Sie sich bei Ihrem Zoom-Konto an und navigieren Sie zu:  
   **Zoom Admin Panel > Benutzerverwaltung > Benutzer**  

2. Klicken Sie auf den Namen des Benutzers, für den Sie die "host_id" erhalten möchten.

3. Sehen Sie sich die URL in der Adressleiste Ihres Browsers an. Sie wird in diesem Format sein:
https://yourdomain.zoom.us/user/xxxxxxxxxxxxx/profile Sie möchten die xxxxxxxxxxxxx kopieren, da dies Ihre Host_id ist.


---

### 3. Konfigurieren Sie die Botpress 

- Installieren Sie diese Integration in Ihrem Bot
- Einfügen:
- `Zoom-Kunden-ID`
- Zoom-Kunden-Geheimnis".
- Zoom-Konto-ID".
- `Geheimes Token`
- Erlaubte Zoom-Benutzer-IDs" → Fügen Sie Ihre "host_id" ein (Sie können mehrere angeben)

Klicken Sie auf **Konfiguration speichern**.

---

### 4. Webhook in Zoom einstellen

Zurück in Ihrer Zoom OAuth App:

- Gehen Sie zu **Features** → Aktivieren Sie **Event Subscriptions**
- Name: `Transcript Received` (Sie können auch einen anderen Namen wählen)
- Methode: Webhook
- Endpunkt-URL: Verwenden Sie die Botpress .
- Ereignisse hinzufügen:
- Unter **Aufzeichnung**:
  - `Alle Aufnahmen wurden abgeschlossen`
  - Aufzeichnung von Transkriptdateien abgeschlossen".
- Klicken Sie auf **Erledigt**.
- Klicken Sie auf **Validieren** neben der Endpunkt-URL (Sie sollten "Validiert" sehen)
- Klicken Sie auf **Speichern**.

---

## Erledigt! 

Ihr Botpress erhält nun Abschriften für zugelassene Zoom-Benutzer, wenn die Cloud-Aufnahmen abgeschlossen sind. Vergewissern Sie sich:

- Sie **in der Cloud aufzeichnen**
- Sie haben einen **bezahlten Zoom-Tarif**.
- Sie haben alle vorgesehenen `host_id`s korrekt hinzugefügt