259 lines
6.9 KiB
Markdown
259 lines
6.9 KiB
Markdown
---
|
|
id: zoom
|
|
title: Zoom Webhooks
|
|
icon: camera-video
|
|
description: Automatische Zoom-Integration fuer Online-Kurse
|
|
section: Integrationen
|
|
tags: [Zoom, Webhook, Online-Kurs, Meeting, Aufnahme, Anwesenheit]
|
|
related: [video, kursarten/online-termine, emails]
|
|
order: 42
|
|
---
|
|
|
|
# Zoom Webhook-Automatisierung
|
|
|
|
Verbindet Ihre Zoom-Meetings automatisch mit dem Buchungssystem. Teilnehmer-Tracking, Meeting-Status und Aufnahmen werden automatisch verarbeitet.
|
|
|
|
## Funktionen
|
|
|
|
| Funktion | Beschreibung |
|
|
|----------|--------------|
|
|
| **Meeting-Status** | Kurs wird automatisch als "live" oder "beendet" markiert |
|
|
| **Anwesenheits-Tracking** | Wer hat teilgenommen? Wie lange? |
|
|
| **Aufnahmen-Import** | Zoom-Aufnahmen automatisch dem Kurs zuweisen |
|
|
| **E-Mail-Benachrichtigung** | Teilnehmer bei Meeting-Start informieren |
|
|
|
|
## Unterstuetzte Produktarten
|
|
|
|
Diese Kursarten nutzen Zoom:
|
|
|
|
| Typ | Name | Verwendung |
|
|
|-----|------|------------|
|
|
| **G** | Webinar Live | Live-Meeting mit Aufzeichnung |
|
|
| **H** | Workshop Online | Interaktiver Online-Workshop |
|
|
| **I** | Coaching Online | 1:1 Online-Coaching |
|
|
| **L** | Beratung | Telefon oder Zoom |
|
|
|
|
---
|
|
|
|
## Einrichtung
|
|
|
|
### Schritt 1: Modul aktivieren
|
|
|
|
1. Gehen Sie zu **Kurs-Booking → Einstellungen → Module**
|
|
2. Aktivieren Sie **"Zoom Webhooks"**
|
|
3. Speichern
|
|
|
|
### Schritt 2: Zoom App erstellen
|
|
|
|
1. Oeffnen Sie [Zoom App Marketplace](https://marketplace.zoom.us/develop/create)
|
|
2. Klicken Sie auf **"Build App"**
|
|
3. Waehlen Sie **"Webhook Only"**
|
|
4. Geben Sie einen Namen ein (z.B. "Kurs-Booking Webhook")
|
|
5. Klicken Sie **"Create"**
|
|
|
|
### Schritt 3: Secret Token kopieren
|
|
|
|
1. In der Zoom App unter **"Feature"**
|
|
2. Kopieren Sie das **"Secret Token"**
|
|
3. Gehen Sie zu **Kurs-Booking → Einstellungen → Zoom**
|
|
4. Fuegen Sie das Token bei **"Webhook Secret Token"** ein
|
|
5. Aktivieren Sie **"Webhooks aktivieren"**
|
|
6. Speichern
|
|
|
|
### Schritt 4: Webhook-URL eintragen
|
|
|
|
1. Kopieren Sie die angezeigte **Webhook-URL** aus den Plugin-Einstellungen
|
|
2. In der Zoom App unter **"Feature" → "Event Subscriptions"**
|
|
3. Klicken Sie **"+ Add Event Subscription"**
|
|
4. Name: "Kurs-Booking"
|
|
5. Event notification endpoint URL: **Die kopierte URL einfuegen**
|
|
6. Klicken Sie **"Validate"** - Zoom prueft die Verbindung
|
|
|
|
### Schritt 5: Events aktivieren
|
|
|
|
Aktivieren Sie folgende Events:
|
|
|
|
| Event | Kategorie |
|
|
|-------|-----------|
|
|
| `meeting.started` | Meeting |
|
|
| `meeting.ended` | Meeting |
|
|
| `meeting.participant_joined` | Meeting |
|
|
| `meeting.participant_left` | Meeting |
|
|
| `recording.completed` | Recording |
|
|
|
|
1. Klicken Sie **"Add Events"**
|
|
2. Waehlen Sie die Events aus
|
|
3. Speichern und App aktivieren
|
|
|
|
---
|
|
|
|
## Kurs mit Zoom verbinden
|
|
|
|
### Meeting-ID eintragen
|
|
|
|
1. Erstellen Sie ein Zoom-Meeting
|
|
2. Kopieren Sie die **Meeting-ID** (z.B. `123 456 7890`)
|
|
3. Bearbeiten Sie den Kurs in WordPress
|
|
4. Tragen Sie die Meeting-ID bei **"Zoom Meeting-ID"** ein
|
|
5. Optional: **Zoom-Passcode** eintragen
|
|
6. Speichern
|
|
|
|
> **Wichtig:** Die Meeting-ID muss exakt uebereinstimmen, damit Webhooks dem richtigen Kurs zugeordnet werden.
|
|
|
|
### Zoom-Link fuer Teilnehmer
|
|
|
|
Der Zoom-Link wird automatisch in der Buchungsbestaetigungs-E-Mail versendet. Platzhalter:
|
|
|
|
| Platzhalter | Ausgabe |
|
|
|-------------|---------|
|
|
| `{zoom_link}` | Meeting-Beitritts-URL |
|
|
| `{zoom_password}` | Meeting-Passwort |
|
|
| `{zoom_meeting_id}` | Meeting-ID |
|
|
|
|
---
|
|
|
|
## Automatische Aktionen
|
|
|
|
### Bei Meeting-Start
|
|
|
|
Wenn das Meeting beginnt:
|
|
|
|
1. Kurs-Status wird auf **"live"** gesetzt
|
|
2. Startzeit wird gespeichert
|
|
3. Optional: Teilnehmer werden benachrichtigt
|
|
|
|
### Bei Meeting-Ende
|
|
|
|
Wenn das Meeting endet:
|
|
|
|
1. Kurs-Status wird auf **"beendet"** gesetzt
|
|
2. Meeting-Dauer wird berechnet
|
|
3. Anwesenheitsliste ist komplett
|
|
|
|
### Bei Teilnehmer-Beitritt
|
|
|
|
Wenn ein Teilnehmer beitritt:
|
|
|
|
1. System sucht Buchung anhand der E-Mail-Adresse
|
|
2. Teilnahme wird bei der Buchung gespeichert
|
|
3. Zeitstempel: Wann beigetreten
|
|
|
|
### Bei Aufnahme fertig
|
|
|
|
Wenn Zoom die Aufnahme verarbeitet hat:
|
|
|
|
1. Aufnahme-URL wird beim Kurs gespeichert
|
|
2. Optional: Video wird automatisch importiert
|
|
3. Teilnehmer koennen informiert werden
|
|
|
|
---
|
|
|
|
## Anwesenheits-Tracking
|
|
|
|
### Wo sehe ich die Anwesenheit?
|
|
|
|
1. Oeffnen Sie eine Buchung im Admin-Bereich
|
|
2. Scrollen Sie zu **"Zoom-Teilnahme"**
|
|
3. Sie sehen:
|
|
- Ob teilgenommen wurde
|
|
- Beitritts- und Austrittszeiten
|
|
- Gesamte Teilnahmedauer
|
|
|
|
### Abgleich mit Buchungen
|
|
|
|
Das System vergleicht die E-Mail-Adresse aus Zoom mit der Buchungs-E-Mail:
|
|
|
|
- **Match:** Teilnahme wird automatisch verknuepft
|
|
- **Kein Match:** Wird als "unbekannter Teilnehmer" protokolliert
|
|
|
|
> **Tipp:** Bitten Sie Teilnehmer, sich mit der E-Mail-Adresse anzumelden, die sie bei der Buchung verwendet haben.
|
|
|
|
---
|
|
|
|
## Aufnahmen verwalten
|
|
|
|
### Automatischer Import
|
|
|
|
1. Aktivieren Sie **"Aufnahmen automatisch importieren"** in den Zoom-Einstellungen
|
|
2. Wenn eine Aufnahme fertig ist:
|
|
- Download-URL wird gespeichert
|
|
- Kann als Video-Kurs weiterverwendet werden
|
|
|
|
### Manueller Zugriff
|
|
|
|
Die Aufnahme-URLs werden beim Kurs gespeichert:
|
|
|
|
- **Aufnahme-URL:** Direkter Link zur Zoom-Aufnahme
|
|
- **Passwort:** Falls Zoom ein Passwort vergibt
|
|
|
|
---
|
|
|
|
## Webhook-Logs
|
|
|
|
### Logs einsehen
|
|
|
|
1. Gehen Sie zu **Einstellungen → Zoom**
|
|
2. Scrollen Sie zu **"Letzte Webhook-Events"**
|
|
3. Sie sehen die letzten 10 Events mit:
|
|
- Zeitstempel
|
|
- Event-Typ
|
|
- Status (Erfolg/Fehler)
|
|
|
|
### Fehlerbehebung
|
|
|
|
| Problem | Loesung |
|
|
|---------|---------|
|
|
| Keine Events | URL-Validierung in Zoom wiederholen |
|
|
| Signatur-Fehler | Secret Token pruefen |
|
|
| Kurs nicht gefunden | Meeting-ID im Kurs pruefen |
|
|
| Teilnehmer nicht erkannt | E-Mail-Adresse abgleichen |
|
|
|
|
---
|
|
|
|
## Sicherheit
|
|
|
|
### Signatur-Verifizierung
|
|
|
|
Jeder Webhook wird mit einer kryptographischen Signatur geprueft:
|
|
|
|
1. Zoom signiert jede Anfrage mit dem Secret Token
|
|
2. Das Plugin verifiziert die Signatur
|
|
3. Ungueltige Anfragen werden abgelehnt
|
|
|
|
### Nur aktivierte Webhooks
|
|
|
|
Wenn "Webhooks aktivieren" nicht aktiviert ist:
|
|
|
|
- Endpoint existiert, aber lehnt alle Anfragen ab
|
|
- Schuetzt vor ungewollter Verarbeitung
|
|
|
|
---
|
|
|
|
## Best Practices
|
|
|
|
1. **Meeting vorab erstellen** - Meeting-ID vor dem Kurs eintragen
|
|
2. **Recurring Meetings** - Fuer Kursreihen dasselbe Meeting verwenden
|
|
3. **E-Mail-Hinweis** - Teilnehmer bitten, sich mit Buchungs-E-Mail anzumelden
|
|
4. **Aufnahmen pruefen** - Vor Freigabe auf Qualitaet pruefen
|
|
5. **Logs beobachten** - Regelmaessig Webhook-Logs kontrollieren
|
|
|
|
---
|
|
|
|
## Haeufige Fragen
|
|
|
|
### Funktioniert das mit Zoom Basic (kostenlos)?
|
|
|
|
Ja, Webhooks funktionieren mit allen Zoom-Plaenen. Fuer Aufnahmen benoetigen Sie jedoch einen kostenpflichtigen Plan.
|
|
|
|
### Kann ich mehrere Kurse mit demselben Meeting verbinden?
|
|
|
|
Nein, jedes Meeting sollte nur einem Kurs zugeordnet sein. Verwenden Sie fuer Kursreihen ein Recurring Meeting.
|
|
|
|
### Was passiert bei Verbindungsproblemen?
|
|
|
|
Zoom wiederholt fehlgeschlagene Webhooks automatisch. Falls das Plugin temporaer nicht erreichbar ist, werden Events nachgeholt.
|
|
|
|
### Werden Breakout-Rooms getrackt?
|
|
|
|
Nein, nur das Haupt-Meeting. Breakout-Room-Teilnahme wird nicht separat erfasst.
|