Zoom Integration

Erstellen Sie automatisch ein Zoom-Meeting fuer jede bestaetigte Buchung und liefern Sie den Beitrittslink an Ihren Kunden: in der Bestaetigungs-E-Mail, in Telegram und in jedem anderen Benachrichtigungskanal, den Sie nutzen.

Wie es funktioniert

Baza Booking Calendar verbindet sich mit Zoom ueber eine Server-to-Server OAuth App, einen Zugangsdatentyp, den Zoom fuer serverseitige Integrationen bereitstellt, die keine Benutzeranmeldung zur Laufzeit erfordern. Sobald Sie Ihre Zugangsdaten in BBC einfuegen, uebernimmt das Plugin die Token-Verwaltung automatisch.

Die Integration wird pro Dienstleistung einzeln aktiviert. Sie entscheiden genau, fuer welche Dienstleistungen Zoom-Meetings erstellt werden sollen, Online-Beratungen, Kurse, Coaching-Sitzungen, waehrend persoenliche Termine oder Raumbuchungen unangetastet bleiben.

Wenn eine Buchung fuer eine Zoom-aktivierte Dienstleistung bestaetigt wird:

• BBC ruft die Zoom API auf und erstellt ein Meeting, benannt nach der Dienstleistung und der Buchung
• Die eindeutige Beitritts-URL wird zusammen mit dem Buchungsdatensatz gespeichert
• Ein Join Zoom meeting Button wird der Bestaetigungs-E-Mail des Kunden hinzugefuegt
• Die Beitritts-URL wird an alle Messenger-Benachrichtigungen angehaengt (Telegram, Viber usw.)
• Ein Zoom-Abzeichen erscheint in der Admin-Buchungsliste
• Ein Join Button erscheint im Header des Buchungs-Seitenpanels

Wird die Buchung spaeter storniert, abgelehnt oder laeuft ab, loescht BBC das Zoom-Meeting automatisch.

Voraussetzungen

• Ein Zoom Konto, Pro, Business oder hoeher (kostenlose Konten haben eingeschraenkten API-Zugriff)
• Sie muessen Kontoinhaber oder Administrator sein, um Marketplace-Apps zu erstellen und OAuth Scopes zu verwalten
• Baza Booking Calendar mit Pro Tarif oder hoeher
• Ihre WordPress Website muss oeffentlich ueber HTTPS erreichbar sein, damit Zoom Webhook-Ereignisse zustellen kann

Schritt 1, Die Zoom App erstellen

1. Gehen Sie zu marketplace.zoom.us und melden Sie sich als Kontoinhaber an.
2. Klicken Sie auf Develop, Build App und waehlen Sie Server-to-Server OAuth, dann klicken Sie auf Create.
3. Geben Sie einen beliebigen App-Namen ein (z.B. Baza Booking Calendar) und klicken Sie auf Create.
4. Kopieren Sie im Tab App Credentials Ihre Account ID, Client ID und Client Secret. Lassen Sie diese Seite geoeffnet, Sie benoetigen sie fuer den Webhook-Schritt.

Schritt 2, Scopes konfigurieren

BBC benoetigt genau vier Scopes. Fuegen Sie diese im Tab Scopes Ihrer Zoom App hinzu.

meeting:write:meeting:admin
meeting:write:meeting:master
meeting:read:meeting:admin
user:read:user:admin

So fuegen Sie Scopes hinzu: oeffnen Sie den Tab Scopes, klicken Sie auf Add Scopes, suchen Sie jeden Namen, waehlen Sie ihn aus und klicken Sie auf Done. Wiederholen Sie dies fuer alle vier, dann speichern Sie.

Wichtig: Diese Scope-Namen sind exakt. Verwenden Sie keine verkuerzten Varianten wie meeting:write:admin, das sind andere Scopes und fuehren zu Authentifizierungsfehlern.

Schritt 3, Webhook einrichten (empfohlen)

Der Webhook ermoeglicht es Zoom, BBC zu benachrichtigen, wenn Meetings beginnen oder enden. Meeting-Erstellung und -Loeschung funktionieren auch ohne ihn, aber der Webhook aktiviert Echtzeit-Ereignisverfolgung.

Ihre BBC Webhook-Endpunkt-URL:

https://yoursite.com/wp-json/bbc/v1/api/zoom

Diese URL wird zum einfachen Kopieren auch auf der BBC Zoom Einstellungsseite angezeigt.

So fuegen Sie das Ereignis-Abonnement in Zoom hinzu:

1. Gehen Sie zum Tab Feature Ihrer App und aktivieren Sie Event Subscriptions.
2. Klicken Sie auf Add New Event Subscription, geben Sie einen Namen ein und fuegen Sie Ihre Endpunkt-URL ein.
3. Klicken Sie auf Add Events, suchen Sie nach Meeting und waehlen Sie Start Meeting und End Meeting. Optional koennen Sie auch Participant/Host joined meeting hinzufuegen.
4. Speichern, Zoom zeigt ein Secret Token an. Kopieren Sie es und fuegen Sie es in das Feld Webhook Secret Token in BBC ein.
5. Klicken Sie auf Validate. BBC uebernimmt die Pruefung automatisch. Ist Ihre Website erreichbar, ist die Validierung in Sekunden abgeschlossen.

Schritt 4, In BBC verbinden

1. Gehen Sie im WordPress Admin zu Baza Booking, Zoom.
2. Fuegen Sie Account ID, Client ID, Client Secret und (falls konfiguriert) Webhook Secret Token ein.
3. Klicken Sie auf Test connection. BBC ruft die Zoom Users API auf und zeigt bei Erfolg die Konto-E-Mail an.
4. Aktivieren Sie den Schalter Enable Zoom synchronization und klicken Sie auf Save.

Alle Zugangsdaten werden verschluesselt gespeichert und niemals in Einstellungs-Exporten enthalten.

Schritt 5, Pro Dienstleistung aktivieren

Die Erstellung von Zoom-Meetings ist standardmaessig fuer jede Dienstleistung deaktiviert, auch nachdem die Integration aktiv ist.

1. Gehen Sie zu Baza Booking, Dienstleistungen und oeffnen Sie die Dienstleistung, fuer die Zoom-Meetings vorgesehen sind (z.B. eine Online-Beratung).
2. Aktivieren Sie im Einstellungsbereich der Dienstleistung die Checkbox Create Zoom meeting.
3. Speichern Sie die Dienstleistung.

Ab diesem Zeitpunkt erstellt jede fuer diese Dienstleistung bestaetigte Buchung automatisch ein Zoom-Meeting.

Tipp: Lassen Sie die Checkbox fuer persoenliche Dienstleistungen deaktiviert. So bleibt Ihr Zoom Konto uebersichtlich und Kunden mit physischen Terminen erhalten keine Beitrittslinks.

Meeting-Benennung: BBC benennt jedes Meeting nach Dienstleistungstitel und Bestell-ID, zum Beispiel Photography Session #a3f2c1. Das macht Ihre Zoom-Meeting-Liste ohne zusaetzliche Konfiguration lesbar.

Meeting-Lebenszyklus

Erneute Bestaetigung: Wird eine stornierte Buchung zurueck in den Status Booked versetzt, prueft BBC auf ein bestehendes Meeting und erstellt nur dann ein neues, wenn keines gefunden wird, keine Duplikate.

Dauer: berechnet aus den gebuchten Zeitfenstern. Eine 3-stuendige Buchung erstellt ein 180-minuetiges Meeting. Mindestdauer 30 Minuten.

Zeitzone: die Meeting-Startzeit verwendet die Zeitzone, die unter WordPress, Einstellungen, Allgemein, Zeitzone festgelegt ist.

Benachrichtigungen

Die Beitritts-URL wird auch automatisch in Erinnerungsbenachrichtigungen aufgenommen, sodass Kunden den Link immer haben, wenn sie ihn brauchen.

Fehlerbehebung

Test connection schlaegt fehl

• Pruefen Sie, ob die Zugangsdaten ohne fuehrende/nachfolgende Leerzeichen kopiert wurden
• Stellen Sie sicher, dass der App-Status im Zoom Marketplace Activated ist
• Ueberpruefen Sie, ob alle vier erforderlichen Scopes im Tab Scopes vorhanden sind

Meetings werden nach Bestaetigung nicht erstellt

• Bestaetigen Sie, dass Enable Zoom synchronization in den BBC, Zoom Einstellungen aktiviert ist
• Bestaetigen Sie, dass Create Zoom meeting fuer die spezifische Dienstleistung aktiviert ist
• Pruefen Sie, ob die Buchung den Status Booked erreicht hat, fuer Pending Buchungen werden bei erforderlicher manueller Bestaetigung keine Meetings erstellt

Scope-Fehler in der Zoom API Antwort. Kehren Sie zum Tab Scopes im Zoom Marketplace zurueck, fuegen Sie alle vier in Schritt 2 aufgelisteten Scopes hinzu, speichern Sie und warten Sie 1-2 Minuten, bis die Aenderungen wirksam werden, bevor Sie erneut testen.

Webhook-Validierung schlaegt fehl

• Ihre Website muss oeffentlich ueber HTTPS erreichbar sein, lokale oder durch Firewalls geschuetzte Umgebungen koennen keine Zoom Webhooks empfangen
• Pruefen Sie, ob das Webhook Secret Token in BBC genau mit dem im Zoom Marketplace angezeigten uebereinstimmt
• Pruefen Sie, ob keine Firewall- oder Cloudflare-Regeln POST-Anfragen an /wp-json/bbc/v1/api/zoom blockieren

Haeufig gestellte Fragen