Tenant-URLs und Routing-Modi in Booknetic SaaS

Verstehen Sie Tenant-URLs in Booknetic SaaS: Verzeichnis- und Subdomain-Routing, Wildcard-DNS, Permalinks, Slug-Änderungen und typische Fehlerbehebung.

Version:
Kategorien

Was ist eine Mandant-URL?

In Booknetic SaaS benötigt jeder Mandant einen öffentlichen Buchungslink, den er mit seinen eigenen Kunden teilen kann.

Wenn beispielsweise Ihre SaaS-Plattform für Kliniken bestimmt ist, kann jede Klinik eine eigene Buchungsseite haben:

  • Aurora Wellness Studio →https://your-platform.com/aurora-wellness/
  • Metro Dental Group →https://your-platform.com/metro-dental/

Browser-Adressleiste zeigt eine Arbeitsverzeichnis-Stil Mandant URL für Aurora Wellness

Wenn ein Kunde einen dieser Links öffnet, lädt Booknetic die gemeinsam genutzte Buchungsseite für den richtigen Mandant. Der Kunde sieht die Leistungen, Mitarbeiter, Standorte und Buchungsoptionen des Mandanten.

Die beiden Mandant URL-Stile

Booknetic SaaS Mandanten-URLs werden in der Regel in zwei Stilen diskutiert:

  1. Verzeichnismodus — der Mandantenname kommt nach Ihrer Domain, zum Beispiel example.com/tenant1/.
  2. Subdomain-Modus — der Mandantenname kommt vor Ihre Domain, zum Beispiel tenant1.example.com.

Der Verzeichnismodus ist das einfachere Setup, das derzeit für den Standard-SaaS-Flow überprüft wird. Subdomain-Modus hängt von Ihrem Hosting- und DNS-Setup ab, daher sollte es nur verwendet werden, wenn Ihre Installation speziell dafür konfiguriert und getestet wird.

Vergleich nebeneinander

Nebeneinander Vergleich des Subdomain-Modus Mandant1.example.comund Verzeichnismodusexample.com/tenant1/

Gegenstand

Ordnermodus

Subdomain-Modus

Beispiel-URL

example.com/tenant1/

tenant1.example.com

Wie Kunden es sehen

Mandant erscheint nach der Haupt-Website-Adresse

Mandant erscheint vor der Haupt-Website-Adresse

Einrichtungsschwierigkeiten

Leichter

Fortgeschrittener

DNS-Anforderungen

Normalerweise keine spezielle Platzhalter DNS Setup

Erfordert Platzhalter DNS, wie *.example.com

Hosting-Anforderung

Funktioniert auf vielen Standard-WordPress Hosting-Setups

Das Hosting muss alle Mandanten-Subdomains akzeptieren und an die gleiche WordPress-Website senden.

Das Beste für

Die meisten neuenSaaS-Plattformen, schnellerer Start, einfacherer Support

Plattformen, die speziell Mandant-Branded Subdomains wollen und DNS korrekt verwalten können

Häufigste Fehlerursache

WordPress permalinks sind auf Plain gesetzt, oder der Mandanten-Slug ist falsch

Wildcard DNS fehlt oder weist nicht auf die SeiteSaaS

Welchen Modus soll ich wählen?

Verwenden Sie diesen einfachen Entscheidungsfluss:

  1. Brauchen Sie Mandanten-URLs wie tenant1.example.com für Branding? — Wenn nein, wählen Sie Verzeichnismodus.

    • Wenn ja, fahren Sie mit Schritt 2 fort.
  2. Können Sie DNS-Datensätze für Ihre Domain verwalten? — Wenn nein, wählen Sie Verzeichnismodus.

    • Wenn ja, dann Schritt 3.
  3. Kann Ihr Hosting alle Mandanten-Subdomains routen auf dieselbe WordPress-Installation routen kann? — Wenn nein oder wenn Sie unsicher sind, wählen Sie zuerst Verzeichnismodus.

    • Wenn ja, kann der Subdomain-Modus möglich sein, aber testen Sie ihn, bevor Sie Mandant einladen.
  4. Sind Mandant bereits live und teilen Buchungslinks?

    • Wenn ja, schalten Sie nicht den URL-Stil beiläufig. Bestehende Links,QRCodes, E-Mails, iframes und Lesezeichen müssen möglicherweise aktualisiert werden.

Für die meisten Plattformbesitzer,Der Verzeichnismodus ist der sicherste Ausgangspunkt weil es einfacher zu konfigurieren und einfacher zu beheben ist.

Verzeichnismodus:example.com/tenant1/

Im Verzeichnismodus hat jeder Mandant eine URL unter Ihrer Hauptdomäne.

Add Tenant Bildschirm zeigt das Feld Domain mit dem Präfix saas-docs.instawp.site Verzeichnisstil

Beispiel:

https://example.com/aurora-wellness/
https://example.com/metro-dental/

Der letzte Teil der URL ist der Mandanten-Slug. Ein Mandanten-Slug ist der im Link verwendete Kurzname, wie z.B.aurora-wellness.

Wann wird der Verzeichnismodus verwendet?

Verzeichnismodus auswählen, wenn:

  • Du willst die einfachste Einrichtung.
  • Sie wollen keine Platzhalter DNS konfigurieren.
  • Ihr Hosting unterstützt keine Platzhalter-Subdomains.
  • Sie starten schnell und wollen weniger technische Setup-Schritte.
  • Sie sind sich nicht sicher, welcher Modus Ihr Hosting unterstützen kann.

Schritte im Ordnermodus einrichten

  1. Öffnen Sie in WordPress Settings → Permalinks.
  2. Stellen Sie sicher, dass Permalinks nicht eingestellt auf Plain. Wählen Sie eine lesbare Option wie Post name.
  3. In Booknetic SaaS öffnen SaaS Settings → Seiten.
  4. Wählen Sie die Seite WordPress, die das Buchungsformular von Booknetic als Ihre Booking page.

SaaS Settings Bildschirm als Seiten- und Booking page Aufbauanker

  1. Einen Mandant erstellen oder bearbeiten und den Mandanten-Slug festlegen, zum Beispiel aurora-wellness.
  2. Öffnen Sie die Mandant-URL in einem Browser, zum Beispiel:
https://example.com/aurora-wellness/
  1. Bestätigen Sie, dass die Buchungsseite des Mandanten korrekt geladen wird.

Wichtige Permalink-Anmerkung

Der Verzeichnismodus muss korrekt funktionieren. Wenn WordPress Permalinks gesetzt ist Plain, Mandanten-Links wie example.com/tenant1/ darf nicht wie erwartet geladen werden.

WordPress Permalink Settings Bildschirm mit anstelle von Plain ausgewählten Postnamen

Wenn Verzeichnis Mandanten-URLs nicht funktionieren, überprüfen Sie Settings → Permalinks Zuerst.

Subdomain-Modus:tenant1.example.com

Im Subdomain-Modus hat jeder Mandant eine Subdomain unter seiner Hauptdomain.

Beispiel:

aurora-wellness.example.com
metro-dental.example.com

Dies sieht eher getrennt von der Hauptplattformdomäne aus, die einigeSaaS-Besitzer beim Branding bevorzugen. Es ist aber auch technischer zu etablieren.

Wann Subdomain-Modus verwendet werden soll

Wählen Sie Subdomain-Modus nur, wenn:

  • Sie wollen speziell Mandanten-URLs im Formattenant.example.com.
  • Sie steuern die DNS-Einstellungen für Ihre Domain.
  • Ihr Hosting kann alle Mandanten-Subdomains an die gleiche Installation nach WordPress senden.
  • Ihre Installation nach Booknetic SaaS wurde für das Subdomain Routing konfiguriert und getestet.

Wenn eine davon unklar ist, verwenden Sie zuerst den Verzeichnismodus.

Einrichtungsschritte im Subdomain-Modus

Subdomain-Modus erfordert DNS und Hosting-Unterstützung. Die genauen Bildschirme hängen von Ihrem Domain-Provider und Hosting-Unternehmen, aber die allgemeine Einrichtung ist:

  1. Öffnen Sie die DNS-Einstellungen Ihrer Domain.
  2. Fügen Sie einen Platzhalter DNS Datensatz für Ihre Domain hinzu.

Beispiel:

*.example.com
  1. Zeigen Sie den Platzhalter auf den gleichen Server oder das gleiche Hostingziel wie Ihre Haupt-SaaS-Website.
  2. Stellen Sie sicher, dass Ihr Hosting Platzhalter-Subdomains akzeptiert und führt sie zur gleichen Installation nach WordPress.
  3. Bestätigen Sie Ihre SSL-Zertifikat umfasst Mandant Subdomains. Viele Plattformen benötigen dafür ein Platzhalter SSL-Zertifikat.
  4. Einen Mandant in Booknetic SaaS erstellen oder bearbeiten und den Mandant inslugeinstellen.
  5. Testen Sie beispielsweise die Mandanten-Subdomain in einem Browser:
aurora-wellness.example.com
  1. Wenn die Seite nicht geladen wird, überprüfen Sie DNS und Hosting-Routing, bevor Sie dieBooknetic-Einstellungen ändern.

Die wichtigste Subdomainanforderung: Platzhalter DNS

Der Subdomain-Modus funktioniert nicht, nur weil der Mandant inBookneticexistiert.

Ihre Domain muss einen Platzhalter DNS Datensatz haben. In einfachen Worten bedeutet Platzhalter DNS:

"Senden Sie jede Mandanten-Subdomain unter meiner Domain auf diese gleiche SaaS-Website."

Ohne Platzhalter DNS, Links wie tenant1.example.comin der Regel mit einer 404-Seite, Browser-Fehler oder Hosting Standard-Seite scheitern.

Beispiel fehlende Mandant URL zeigt eine Seite nicht gefunden Bildschirm

Häufiger Fehler: Mandanteneite zeigt 404 im Subdomain-Modus

Wenn eine Mandanten-Subdomain eine 404-Seite zeigt oder nicht öffnet, überprüfen Sie zuerst diese Elemente:

  1. Wildcard DNS existiert — bestätigen*.example.comwird in Ihrem DNS-Anbieter erstellt.
  2. Wildcard DNS zeigt auf den richtigen Server — es muss auf das gleiche Ziel wie IhreSaaS WordPress Website verweisen.
  3. Hosting akzeptiert Platzhalter Subdomains — einige Hosts benötigen Sie, um Platzhalter Subdomains separat zu aktivieren.
  4. SSL deckt Subdomains ab — ohne SSL-Abdeckung kann der Browser anstelle der Buchungsseite eine Sicherheitswarnung anzeigen.
  5. Der Mandanten-Slug entspricht der URL — wenn der Mandanten-Slugaurora-wellness, Prüfungaurora-wellness.example.comKeine andere Schreibweise.

Wenn Sie DNS-Datensätze nicht bequem prüfen, bitten Sie Ihren Hosting-Provider zu bestätigen, dass Platzhalter-Subdomains auf Ihre WordPress Installation weitergeleitet werden.

Häufiger Fehler: Verzeichnis Mandanten-Links funktionieren nicht

Wennexample.com/tenant1/nicht korrekt geladen, überprüfen Sie diese Elemente:

  1. Gehen Sie in WordPress zu Settings → Permalinks.
  2. Stellen Sie sicher, dass die Einstellung nicht Plain.
  3. Speichern Sie den Permalinks-Bildschirm einmal, um die Regeln zu aktualisieren.
  4. Bestätigen Sie, dass der Mandanten-Slugrichtig ist.
  5. Bestätigen Sie, dass die Booknetic SaaS Booking page unter SaaS Settings → Pages ausgewählt ist.
  6. Testen Sie den Mandant link erneut in einem privaten/incognito Browserfenster.

Die häufigste Ursache ist ein Permalink-Konfigurationsproblem.

Wo Mandant ihre Buchungs-URL finden

Tenantsfinden ihren Buchungslink in der Regel im eigenen Panel unter Billing→Share Page.

Für den URL-Workflow vonBillingundShare Pageverwendeter Mandant-Panelbereich

Von diesem Bildschirm kann ein Mandant:

  • Kopieren Sie die Booking page URL.
  • Senden Sie den Seitenlink per E-Mail.
  • EinenQR-Code herunterladen oder teilen.
  • Kopieren Sie eineniframeembed Code für ihre eigene Website.

Ändert sich die Mandant-URL später, sollten Mandant alle kopierten Links,QR-Codes, E-Mail-Vorlagen undiframe-Einbetten, die sie bereits freigegeben haben, aktualisieren.

Kann ich den Routing-Modus später ändern?

Planen Sie Ihren Routing-Modus, bevor Sie wann immer möglich starten.

Der Wechsel von Verzeichnis-URLs zu Subdomain-URLs oder umgekehrt kann Links beeinflussen, die Mandant und Kunden bereits verwenden. Dies kann Folgendes umfassen:

  • Buchungslinks auf Websites und Social Media geteilt.
  • QRCodes gedruckt oder online gepostet.
  • Email Vorlagen und Workflow-Nachrichten.
  • Iframe eingebettet auf Mandant-Websites.
  • Lesezeichen von Kunden gespeichert.

Wenn Ihre Plattform bereits live ist, behandeln Sie eine Änderung im Routing-Modus wie ein kleines Migrationsprojekt. Testen Sie es zuerst auf einer Staging-Site, bereiten Sie bei Bedarf Umleitungen vor und sagen Sie Mandant n, welche Links sie aktualisieren sollten.

Da das Subdomain-Routing von DNS und Hosting abhängt, bestätigen Sie den unterstützten Schaltvorgang mit Ihrem Supportkontakt nach Booknetic SaaS, bevor Sie eine Live-Plattform wechseln.

Kann ich später den Slug eines Mandanten ändern?

Sie können einen Mandanten-Slugaktualisieren müssen, wenn ein Unternehmen seinen Namen ändert oder wenn der ursprünglicheslugeinen Tippfehler hat.

Bevor Sie es ändern, denken Sie daran, dass die öffentliche Buchungs-URL des Mandanten sich ebenfalls ändert.

Beispiel:

Old: https://example.com/aurora-wellness/
New: https://example.com/aurora-studio/

Nach Änderung einesslugbitten Sie den Mandant zu aktualisieren:

  • Website-Buttons.
  • Social Media Profil Links.
  • QRCodes.
  • Email Unterschriften.
  • Iframe eingebettet.
  • Alle gespeicherten Links in Kundennachrichten.

Best Practices, bevor Sie Mandant einladen

Bevor Sie Ihre SaaS-Plattform öffentlich starten:

  1. Wählen Sie Ihren Mandant URL Stil.
  2. Konfigurieren Sie die Buchungsseite in SaaS Settings.
  3. Wenn Sie Verzeichnismodus verwenden, bestätigen Sie, dass WordPress Permalinks nicht auf Plain gesetzt sind.
  4. Wenn Sie Subdomain-Modus verwenden, bestätigen Sie Platzhalter DNS, Hosting Routing und SSL arbeiten.
  5. Erstellen Sie einen Testmandanten.
  6. Öffnen Sie die Mandant-URL in einem Browser.
  7. Vervollständigen Sie eine Testbuchung auf der öffentlichen Seite.
  8. Kopieren Sie die Mandant-URL von Billing→Share Page und bestätigen es entspricht dem URL-Stil, den Sie veröffentlichen wollen.

Tun Sie dies, bevor Mandant beginnen, Links mit echten Kunden zu teilen.

Schnelle Fehlersuche Checkliste

Problem

Höchstwahrscheinliche Ursache

Was zu überprüfen ist

example.com/tenant1/zeigt 404

WordPress permalinks oder falscher Mandanten-Slug

Settings → Permalinks; Mandanten-Slug; SaaS Booking page

tenant1.example.comnicht geöffnet

Platzhalter DNS fehlt

DNS-Aufzeichnung für*.example.com

Subdomain öffnet die Standardseite des Hostings

Das Hosting führt keine Platzhalter-Subdomänen nach WordPress aus

Hosting Control Panel / Hosting Support

Browser zeigt SSL-Warnung auf Mandanten-Subdomain

SSL-Zertifikat umfasst keine Platzhalter-Subdomains

SSL Zertifikat / Hosting SSL Einstellungen

Mandantenieht einen alten Link nach Slug-Änderung

Link wurde vor der Änderung kopiert

Shared Links,QRCodes, E-Mails undiframes aktualisieren

Kurze Empfehlung

Wenn Sie nicht sicher sind, welche Option Sie wählen sollen, beginnen Sie mit Verzeichnismodus.

Es ist einfacher einzurichten, einfacher zu unterstützen und funktioniert gut für die meistenSaaS-Plattformen. Wählen Sie den Subdomain-Modus nur, wenn Sie einen klaren Branding-Bedarf haben und Ihr DNS/Hosting-Setup bereit ist.