Zoom in Booknetic SaaS integrieren

Booknetic SaaS unterstützt Zoom als mandantenspezifische Videokonferenzintegration. Wenn der Termin eines Mandanten gebucht wird, erstellt Booknetic automatisch ein Zoom-Meeting und stellt den Beitrittslink für Workflow-Benachrichtigungen über den kundenbezogenen Shortcode {zoom_meeting_url} und den mitarbeiterbezogenen Shortcode {zoom_meeting_host_url} bereit.

Auf Booknetic SaaS gibt es zwei unterstützte Integrationsmethoden:

Wichtig: Booknetic unterstützt keine Zoom JWT Apps mehr. Zoom-Sonnenuntergang der JWT-Apps am 1. September 2023. Wenn Sie eine ältere Booknetic SaaS-Installation für JWT konfiguriert haben, wechseln Sie mithilfe der folgenden Anweisungen zu OAuth oder Server-to-Server.

Bevor eine der beiden Methoden funktioniert:

1. Die zoom Die Planfunktion muss für jeden Mandantenplan aktiviert werden, der Zoom-Zugriff haben soll (Booknetic SaaS → Plans → Tarif bearbeiten → umschalten). zoom an).
2. Jeder Mandant muss ein Zoom-Konto mit jedem Mitarbeiter verbinden, der Zoom verwenden soll (Mandantenpanel → Staff → Mitarbeiter bearbeiten → Zoom verbinden).
3. Jeder Mandant muss „Zoom für den Dienst aktivieren“ für jeden Dienst umschalten, der automatisch ein Zoom-Meeting erstellen soll (Mandantenbereich → Dienste → Dienst bearbeiten).

OAuth-Methode – Richten Sie die plattformweite Zoom-App ein

Verwenden Sie diesen Pfad, wenn Sie eine Zoom OAuth-App für das gesamte SaaS benötigen, wobei sich jeder Mandant über diese gemeinsame App bei seinem eigenen Zoom-Konto anmeldet.

Schritt 1: Öffnen Sie die Entwicklerkonsole Zoom Marketplace.

1. Melden Sie sich an unter https://marketplace.zoom.us mit dem Zoom-Konto, dem die App gehört.
2. Klicken Sie Entwickeln → App erstellen.
3. Wählen OAuth App (Zoom kann dies auch nennen OAuth-App (Kontoebene) abhängig von der UI-Rev.).

Schritt 2: Füllen Sie die App-Grundlagen aus.

• App-Name – öffentlich zugänglicher App-Name; Kunden sehen dies im Zoom-Zustimmungsbildschirm.
• App-Typ – auswählen Vom Benutzer verwaltete App Daher verbindet jeder Mandant sein eigenes Zoom-Benutzerkonto.
• App-Symbol — Laden Sie Ihr Branding-Logo hoch (300×300 PNG empfohlen).

Schritt 3: Kopieren Sie die Umleitung URI von Booknetic in Zoom.

1. In Booknetic SaaS → Settings → Integrations → Zoom, setze Integrationsmethode = OAuth. Der Bildschirm zeigt jetzt eine schreibgeschützte Anzeige an Rückruf URI (in Zooms UI auch Redirect URI genannt).
2. Kopieren Sie das URI genau.
3. Zurück im Zoom Marketplace → Ihrer App → App-Anmeldeinformationen, fügen Sie den URI in beide ein Leiten Sie URL zu OAuth um und Fügen Sie Zulassungslisten hinzu.

Schritt 4: Fügen Sie die Zoom-Anmeldeinformationen in Booknetic ein.

1. Kopieren Sie in Zoom Marketplace → App-Anmeldeinformationen Kunde ID (Entwicklung) und Client-Geheimnis (Entwicklung).
2. Fügen Sie sie in Booknetic SaaS → Settings → Integrations → Zoom ein Kunde ID und Client-Geheimnis.
3. Speichern.

Schritt 5: Legen Sie die Standardeinstellungen für Besprechungsthemen und -beschreibungen fest (mandantenseitig).

Diese können später von jedem Mandanten in seinem eigenen Panel bearbeitet werden, es ist jedoch hilfreich, sinnvolle Standardwerte festzulegen:

• Besprechungsthema – Titel des Zoom-Treffens. Shortcodes wie {service_name}, {staff_name}, {customer_full_name} werden unterstützt.
• Beschreibung des Treffens — Tagesordnungstext (maximal 2000 Zeichen).
• Legen Sie ein zufälliges Passwort fest – Schalten Sie ON um, wenn Zoom automatisch ein 6-stelliges Meeting-Passwort generieren soll.

Schritt 6: Geben Sie die App-Informationen ein.

Zoom benötigt App-Informationen zur Überprüfung: Kurzbeschreibung, lange Beschreibung, Kategorien, Unternehmens-/Supportkontakt, Datenschutzrichtlinie URL und Nutzungsbedingungen URL auf Ihrer Plattform.

Schritt 7: Bereiche auswählen.

Booknetic benötigt mindestens:

• meeting:write:admin — Besprechungen erstellen/aktualisieren.
• user:read:admin — Lesen Sie das verbundene Benutzerprofil.

Fügen Sie alle zusätzlichen Bereiche hinzu, die Zoom für Ihren App-Typ und Ihre App-Stufe benötigt.

Schritt 8: Zur Überprüfung einreichen.

Produktionszugangsdaten werden erst verfügbar, nachdem Zoom die App genehmigt hat. Die Überprüfung dauert in der Regel 5–10 Werktage. Zoom ist streng über Überprüfungsbeweise; Registrieren Sie im Abschnitt „Testkonto und Anmeldeinformationen“ einen privaten Demo-Mandanten auf Ihrem SaaS und geben Sie den Zoom-Prüfern Anmeldeinformationen, damit diese den Ablauf der automatischen Erstellung von Zoom-Meetings durchgängig sehen können.

Während die Überprüfung noch aussteht, können Sie die verwenden Entwicklungsnachweise Zoom wird im Bildschirm „App-Anmeldeinformationen“ angezeigt. Booknetic akzeptiert Entwicklungsnachweise, damit Sie den Test abschließen können.

Schritt 9: Nach der Genehmigung – Wechseln Sie zu Produktionsanmeldeinformationen.

Wenn Sie die Genehmigungs-E-Mail von Zoom erhalten:

1. Öffnen Sie Ihre Zoom-App → App-Anmeldeinformationen.
2. Kopieren Produktion Client ID und Client Secret.
3. Fügen Sie sie in Booknetic SaaS → Settings → Integrations → Zoom ein (und ersetzen Sie die Entwicklungs-values).
4. Speichern.

Server-to-Server-Methode – mandantenspezifische Zoom-Anmeldeinformationen

Verwenden Sie diesen Pfad, wenn Sie möchten, dass jeder Mandant seine eigenen Zoom-Anmeldeinformationen mitbringt, ohne dass Sie eine OAuth-App registrieren müssen.

Schritt 1: Integrationsmethode wechseln.

Legen Sie in Booknetic SaaS → Settings → Integrations → Zoom die Integrationsmethode = fest Server-to-Server. Die Felder Client ID / Client Secret / Account ID verschieben den Geltungsbereich: jetzt Mandanten Füllen Sie diese in ihrem eigenen Panel aus.

Schritt 2: Tenants registriert eine Server-to-Server-App im Zoom Marketplace.

Jeder Mandant meldet sich bei marketplace.zoom.us mit seinem eigenen Zoom-Konto an und geht dann wie folgt vor:

1. Entwickeln → App erstellen → Server-to-Server OAuth App.
2. Füllen Sie die App-Grundlagen aus → Aktivieren Sie die App.
3. Kopieren Konto ID, Kunde ID, Client-Geheimnis.

Schritt 3: Tenants fügt Anmeldeinformationen in sein Mandantpanel ein.

Mandantenpanel → Settings → Integrations → Zoom →

• Konto ID
• Kunde ID
• Client-Geheimnis

Speichern.

Schritt 4: Tenants verbindet Mitarbeiter mit Zoom.

Mandantenpanel → Staff → Personal bearbeiten → Abschnitt Zoom → Zoom-Benutzer Dropdown-Liste → Wählen Sie den Zoom-Benutzer aus, für den dieser Mitarbeiter Besprechungen abhalten soll.

Gängige Setup-Blocker

Wechsel von JWT (Legacy-Installationen)

Wenn Ihre Booknetic SaaS-Installation vor September 2023 für Zoom JWT eingerichtet wurde:

1. Die JWT-App in Ihrem Zoom-Konto autorisiert keine Anfragen mehr – Zoom lehnt Anrufe ab.
2. Erstellen Sie Ihre Integration mit neu OAuth (die erste Methode dieses Leitfadens) oder Server-to-Server (oben).
3. Bitten Sie jeden Mandanten, sein Zoom-Konto erneut zu verbinden, sobald die neuen Anmeldeinformationen vorhanden sind.
4. Bestehende Zoom-Meetings, die bereits erstellt wurden, bleiben auf Zoom; Nur neue Buchungen benötigen den neuen Authentifizierungspfad.