> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ouraicalling.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Mandanten & Whitelabel

> Die Rollenhierarchie, White-Label-Workspaces und Identitätswechsel

Die Plattform ist von Grund auf mandantenfähig: Agenturen und Reseller („Mandanten") betreiben ihre eigene Markeninstanz auf ihrer eigenen Domain – mit eigenen Benutzern, Plänen und Preisen.

## Rollenhierarchie

```text theme={null}
Platform admin (the operator)
├── Tenants (white-label customers: own domain & branding)
│   └── Tenant users (the tenant's end customers)
└── Direct users (no tenant; use the main domain)
```

* **Ein Login für alle** – die Rolle entscheidet, was ein Benutzer sieht.
* **Plattform-Admins** verwalten alle Benutzer, Mandanten, Plattformpläne und den Modellkatalog unter `/admin`.
* **Mandanten-Admins** (Owner/Admin eines Mandanten) bekommen einen eigenen Mandanten-Admin-Bereich: ein Dashboard mit Mandanten-KPIs, den Anrufverlauf aller eigenen Benutzer, Benutzerverwaltung, Prompt-Vorlagen, Pläne, Abrechnung, Datenmigration und Branding-Einstellungen.

## Whitelabel

Der Workspace eines Mandanten läuft komplett unter der eigenen Identität:

* **Domain** – die App, der Login, die API (`/api/v1`) und sogar der [MCP-Endpoint](/api/mcp) laufen unter der Domain des Mandanten.
* **Branding** – Logo, Favicon, Farben und App-Name; wird auf die App, den Browser-Tab, Login- und Registrierungsseiten sowie OAuth-Consent-Screens angewendet. Mandanten-Domains nutzen ihr eigenes Favicon und fallen auf das Plattform-Favicon zurück, wenn keines konfiguriert ist.
* **Support-E-Mail** – wird den Benutzern des Mandanten angezeigt.
* **Pläne & Preise** – Mandanten legen ihre eigenen Pläne und Preise fest; siehe [Pläne & Limits](/admin/plans-and-limits) und [Stripe Connect](/admin/stripe).

Die Whitelabel-Verwaltung ist an einen Plattformplan-Toggle (`whitelabel_enabled`), ein gebuchtes Plattform-Add-on (`feature_key=whitelabel`), Domain/Connect-Bestandsschutz oder einen Override auf Ebene des Admin-Workspaces gekoppelt. Mandanten-Wiederverkaufspläne können Whitelabel weder gewähren noch weiterverkaufen.

Reseller, die ihre Endkunden programmatisch statt über die Tenant-Admin-UI verwalten wollen – eigene Admin-Konsole, automatisiertes Onboarding, Guthaben-Aufladungen aus dem eigenen Billing – nutzen dafür die [White-Label-API](/de/admin/whitelabel-api) (REST + MCP).

### Verifizierung eigener Domains

Füge den vollständigen Hostnamen unter **Mandanten-Admin → Einstellungen** hinzu, zum Beispiel `app.famulor.io`. Die Plattform hängt ihn dann an ihr Routing an und prüft zwei unabhängige Voraussetzungen:

1. **Eigentümerschaft** – falls eine Prüfung verlangt wird, veröffentliche den exakten TXT-Eintrag, der auf der Einstellungsseite angezeigt wird.
2. **DNS & TLS** – veröffentliche für eine Apex-Domain den empfohlenen A-Eintrag bzw. für eine Subdomain einen CNAME. Die Seite liest die aktuelle DNS-Konfiguration live aus und aktiviert die Domain erst, wenn das Routing stimmt und TLS ausgestellt werden kann.

Nutze **DNS prüfen**, nachdem du Änderungen vorgenommen hast. Die DNS-Propagierung kann etwas dauern. Der Status wird nie aus einer gespeicherten Checkbox abgeleitet: Die Plattform prüft die Live-Konfiguration jedes Mal neu und synchronisiert `custom_domain_verified` nur, wenn beide Prüfungen erfolgreich sind. Entfernst du die Domain, wird sie getrennt und das hostbasierte Mandanten-Routing sofort deaktiviert.

Derselbe Ablauf steht auch über `GET`, `POST` und `DELETE /api/v1/custom-domain` zur Verfügung – mit `POST /api/v1/custom-domain/verify` für eine erneute Prüfung – sowie über die entsprechenden MCP-Tools.

## Kostenlose Konten

Mandanten können **kostenlose Registrierungen** erlauben, mit konfigurierbaren Standardlimits (z. B. 1 Assistent, 5 Kampagnen, 1 Nummer) und einem Preis pro Minute für Pay-as-you-go-Nutzung. Denselben Mechanismus gibt es auf Plattformebene auch für direkte Benutzer. Eine Registrierung auf einer Mandanten-Domain legt automatisch die Mandanten-Mitgliedschaft mit diesen Standardwerten an.

## Identitätswechsel („Benutzeransicht")

Admins können sich **als** Benutzer einloggen, um genau das zu sehen, was dieser sieht – der zentrale Support-Workflow:

* Plattform-Admins können sich als jeder Benutzer ausgeben; Mandanten-Admins nur als Benutzer des eigenen Mandanten.
* Ein Banner zeigt durchgehend „Du bist angemeldet als X – zurück zum Admin" an.
* Jeder Identitätswechsel wird **lückenlos protokolliert**.

## Prompt-Vorlagen

Plattform-Admins verwalten **globale** Vorlagen unter `/admin/prompt-templates` (Sichtbarkeit: alle Workspaces oder nur Plattform-Root-Workspaces). Mandanten-Admins pflegen Workspace-Vorlagen unter `/tenant-admin/prompt-templates` – sichtbar für Mitglieder dieses Workspaces und für Reseller-Kunden-Workspaces.

Endbenutzer öffnen **Vorlage auswählen** beim Erstellen eines Assistenten oder auf der System-Prompt-Karte (Prompt-Modus), filtern nach Sprache/Thema/Branch, sehen sich eine Vorschau an und wenden die Vorlage an (wird bei Auswahl direkt in `system_prompt` und optional `first_message` übernommen). Gleiche Liste: `GET /api/v1/prompt-templates` und MCP `list_prompt_templates`.

## Datenmigration

Mandanten-Admins können Ressourcen (Assistenten, Tools, Wissensdatenbanken, Nummern) **von einem Benutzer zu einem anderen** innerhalb des Mandanten übertragen – nützlich, wenn eine Agentur auf einem Staging-Benutzer aufbaut und dann an den Kundenaccount übergibt. Plattform-Admins können das global tun.