Client Portal einrichten: Aktivierung und Zugangslink

Drei Dinge einrichten: Portal aktivieren (Schalter), API-Schlüssel finden (für den Zugangslink) und optional CORS-Domain bei Iframe-Integration. Danach kommen Kunden hinein.

Admin-Rolle erforderlich

Nur Benutzer mit der Rolle Admin. Settings → Company Settings.

Wann verwenden Sie dies?

• Erstmalige Aktivierung des Portals für Ihr Büro
• Einen neuen Zugangslink generieren, um ihn mit Kunden zu teilen
• Iframe-Integration auf Ihrer eigenen Website einrichten

---

Schritt 1: Portal aktivieren

1. Settings → Company Settings in der Seitenleiste.
2. Tab Client Portal Settings.
3. Schalter is_active auf EIN.
4. Save → sofortige Wirkung.

Deaktivieren wirkt sofort

Schalter aus → Kunden haben sofort keinen Zugriff. Konten werden nicht gelöscht, sie funktionieren wieder, sobald das Portal reaktiviert wird.

---

Schritt 2: Der Zugangslink

Das Portal läuft auf einer eigenen Domain. Kunden loggen sich ein über:

https://[portaaldomein]/auth/signin?id=[UW_API_SLEUTEL]

Der id-Parameter (oder company_id) = Ihr API-Schlüssel = zu welchem Büro der Kunde gehört.

Ohne gültigen Parameter wird der Kunde auf eine Informationsseite weitergeleitet, die erklärt, dass er den Link seines Maklers benötigt.

Ihren API-Schlüssel finden

1. Settings → Company Settings → API Keys.
2. Kopieren Sie Ihren API-Schlüssel.

Derselbe Schlüssel wie für API-Integrationen. Bewahren Sie ihn sicher auf, behandeln Sie ihn wie ein Passwort.

Teilen Sie den Link, nicht den Schlüssel separat

Teilen Sie die vollständige URL (mit id-Parameter). Die separate Weitergabe des Schlüssels gewährt ebenfalls API-Zugriff.

---

Schritt 3: Portal auf Ihrer Website

Direkter Link

Platzieren Sie die vollständige URL als Schaltfläche/Link auf Ihrer Website. Der Kunde klickt → Anmeldeseite. Am einfachsten.

E-Mail-Einladung

Bei der Erstellung eines Portalkontos aus dem CRM erhält der Kunde automatisch eine E-Mail mit Anmeldedaten und Link. Manuelles Teilen ist nicht erforderlich.

Selbstregistrierung

Der Kunde besucht die Portal-URL → kann sich selbst über die Anmeldeseite registrieren. Verifizierungscode per E-Mail. Vorhandene Kontakt-E-Mail? Automatisch verknüpft. Andernfalls: neuer Lead wird erstellt.

---

Optional: CORS-Domain

Möchten Sie das Portal in einem Iframe auf Ihrer eigenen Website laden oder ein eigenes Widget, das mit der Tesoro API kommuniziert? Fügen Sie Ihre Domain als CORS-Domain hinzu.

1. Settings → Company Settings, erster Tab Company Settings.
2. CORS Domain Name ausfüllen, vollständig mit https://, z. B. https://www.uwkantoor.com.
3. Save.

Die meisten Büros benötigen dies nicht. Bei Unsicherheit: überspringen.

---

Was Kunden nach der Aktivierung sehen

• Immobilien, die über einen Deal dem verknüpften Kontakt angeboten wurden
• Termine aus dem CRM
• Profilverwaltung + Spracheinstellung

Browser-Titel = Ihr Company Name (aus den allgemeinen Einstellungen).

---

Aktivierungs-Checkliste

Schritt	Ort
Client Portal Settings = EIN	Settings → Company Settings → Client Portal Settings
API-Schlüssel erstellt	Settings → Company Settings → API Keys
Company Name ausgefüllt	Settings → Company Settings
E-Mail-Einstellungen konfiguriert	Settings → Company Settings → Email Settings
Mindestens 1 Immobilie einem Deal zugewiesen	Properties + Deals

Keine Verifizierungs-E-Mail erhalten?

Prüfen Sie Settings → Company Settings → Email Settings. Verifizierungs- und Passwort-E-Mails werden über den transaktionalen E-Mail-Service versendet. Bitten Sie den Kunden auch, den Spam-Ordner zu prüfen.

---

Nächster Schritt

Portalnutzer verwaltenKonten erstellen + Unterschied zwischen CRM-Route und Selbstregistrierung.