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