help-service/content/zoom.md

id, title, icon, description, section, tags, related, order

id	title	icon	description	section	tags	related	order
zoom	Zoom Webhooks	camera-video	Automatische Zoom-Integration fuer Online-Kurse	Integrationen	Zoom Webhook Online-Kurs Meeting Aufnahme Anwesenheit	video kursarten/online-termine emails	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
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.