Initial commit - Help Service for Coolify

content/zoom.md

@@ -0,0 +1,258 @@
+---
+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.