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

# White-Label-Einrichtung

> Branding, Domain, Währung, Rechtstexte, E-Mails, Aufbewahrung und Bot-Schutz für deine White-Label-Plattform konfigurieren

Unter **Whitelabel Admin → Settings** richtest du Marke und Service für deine Kunden ein. Wähle einen Bereich in der Einstellungsleiste, bearbeite die Felder und klicke auf **Save**. Branding-Felder können die Plattformvorgaben übernehmen; Domain-Verifizierung und E-Mail-Versand erfordern eine eigene Einrichtung.

<Note>
  Die Einstellungen sind in fünf Gruppen organisiert: **General**, **Workspace**, **Legal**, **Communications** und **Advanced**. Diese Anleitung führt durch alle Bereiche.
</Note>

## Allgemein

### Branding

Lege den **App name** fest, den deine Kunden im Produkt sehen. Ein leeres Feld übernimmt den Plattformnamen. Ergänze **Support email** und deine Markenfarben: Primärfarbe, Akzentfarbe, neutrales Grau und die Kopffarbe für Transaktions-E-Mails. Die Farben gelten für deine White-Label-Verwaltung und die Kundenoberfläche.

Öffne **Whitelabel Admin → Settings → Branding**. Trage **App name** und **Support email** ein, wähle die Markenfarben und klicke auf **Save**.

<Frame caption="Branding — App-Name, Support-Adresse und Farbwahl">
  <img src="https://mintcdn.com/ouraicall/bijtnxODi_f3mm69/images/guide-ui/white-label-branding.png?fit=max&auto=format&n=bijtnxODi_f3mm69&q=85&s=2a0d20d5961517dbb6dcdacf491dccfc" alt="Branding — App-Name, Support-Adresse und Farbwahl" width="2230" height="512" data-path="images/guide-ui/white-label-branding.png" />
</Frame>

### Logo und Favicon

Öffne **Settings → Logo & favicon**. Über **Upload logo**, **Upload dark logo** und **Upload favicon** hinterlegst du die Dateien für die jeweiligen Darstellungen. Uploads und Löschungen werden sofort angewendet. Entferne eine Datei, um wieder das entsprechende Plattformlogo zu verwenden.

<Frame caption="Logo & favicon — separate Uploads für helles Logo, dunkles Logo und Favicon">
  <img src="https://mintcdn.com/ouraicall/bijtnxODi_f3mm69/images/guide-ui/white-label-logos.png?fit=max&auto=format&n=bijtnxODi_f3mm69&q=85&s=4ab70aa7b7c9229fcc72d9358f362832" alt="Logo & favicon — separate Uploads für helles Logo, dunkles Logo und Favicon" width="1978" height="263" data-path="images/guide-ui/white-label-logos.png" />
</Frame>

## Workspace

### Währung

Wähle die **Anzeigewährung**, die Kunden im Checkout und im Produkt sehen. Preise werden intern weiterhin in EUR gespeichert. Für die Anzeige rechnet Famulor sie mit einem von der Plattform verwalteten Wechselkurs um.

### Domains

Verbinde die eigene Domain, über die Kunden die App, Anmeldung, öffentliche API (`/api/v1`) und [MCP](/de/mcp/overview) verwenden.

Öffne **Whitelabel Admin → Settings → Domains**, trage den Hostnamen unter **Custom domain** ein und wähle **Add domain**. Die Aufnahme zeigt das Formular vor dem Hinzufügen einer Domain; die DNS-Einträge folgen im nächsten Schritt.

<Frame caption="Domains — Hostname hinzufügen, danach DNS-Einträge veröffentlichen und prüfen">
  <img src="https://mintcdn.com/ouraicall/bijtnxODi_f3mm69/images/guide-ui/white-label-domains.png?fit=max&auto=format&n=bijtnxODi_f3mm69&q=85&s=d83dc8c13dae54a21d3c73a0194990d8" alt="Domains — Hostname hinzufügen, danach DNS-Einträge veröffentlichen und prüfen" width="2228" height="330" data-path="images/guide-ui/white-label-domains.png" />
</Frame>

<Steps>
  <Step title="Hostname hinzufügen">
    Trage den vollständigen Hostnamen ein, zum Beispiel `app.deine-marke.de`.
  </Step>

  <Step title="DNS-Einträge veröffentlichen">
    Veröffentliche zuerst den angezeigten TXT-Eintrag als Eigentumsnachweis und anschließend den empfohlenen A- oder CNAME-Eintrag für das Routing.
  </Step>

  <Step title="Verifizieren">
    Warte auf die DNS-Verteilung und wähle **Check DNS**. Die Domain wird aktiv, sobald Eigentumsnachweis, Routing und Zertifikatsprüfung erfolgreich sind.
  </Step>
</Steps>

Das Entfernen der Domain deaktiviert Anmeldung und Branding auf diesem Hostnamen. Derselbe Ablauf ist über `GET`, `POST` und `DELETE /api/v1/custom-domain`, `POST /api/v1/custom-domain/verify` sowie die zugehörigen MCP-Tools verfügbar. Das [White-Label-Programm](/de/admin/tenants-and-whitelabel) erklärt, welche Funktionen nach der Verifizierung verfügbar sind. Bot-Schutz benötigt beispielsweise eine verifizierte eigene Domain.

## Rechtliches

### Dokumentationslink

Die optionale **Docs URL** erscheint als Info-Symbol neben **Create key** unter **Settings → API & MCP**. Damit verweist du Kunden auf deine eigene API-Dokumentation anstelle der Famulor-Dokumentation.

### Rechtliche Seiten

**Privacy Policy URL** und **Terms of Service URL** werden auf den Anmelde- und Registrierungsseiten verlinkt. Leere Felder übernehmen die Plattformvorgaben.

## Kommunikation

### Eigener SMTP-Server

Versende Transaktions-E-Mails über deinen eigenen E-Mail-Anbieter. Konfiguriere Host, Port, Benutzername, Passwort, Verschlüsselung (zum Beispiel TLS), **From name** und **From address**. Prüfe die Verbindung mit **Send test email**. Nach dem Speichern wird das Passwort nicht erneut angezeigt; sichtbar ist nur, ob eines hinterlegt wurde.

Öffne **Whitelabel Admin → Settings → SMTP** und hinterlege Mailserver und Absender. Speichere die Konfiguration und prüfe die Zustellung mit **Send test email**.

<Frame caption="SMTP — noch nicht konfigurierte Server- und Absenderfelder">
  <img src="https://mintcdn.com/ouraicall/bijtnxODi_f3mm69/images/guide-ui/white-label-smtp.png?fit=max&auto=format&n=bijtnxODi_f3mm69&q=85&s=3d2a8e536ab7ada9ae502612dc50fd8c" alt="SMTP — noch nicht konfigurierte Server- und Absenderfelder" width="2228" height="829" data-path="images/guide-ui/white-label-smtp.png" />
</Frame>

### E-Mail-Vorlage

Diese Vorlage steuert die Willkommens-E-Mail unmittelbar nach der Registrierung. Leere Felder verwenden die Standardtexte. Als Kontaktadresse dient standardmäßig die Support-Adresse aus **Branding**.

### E-Mail-Benachrichtigungen

Öffne **Settings → Email notifications**, schalte die gewünschten Benachrichtigungen ein oder aus und wähle **Save**. Standardmäßig sind sie aktiviert. Die folgenden Namen entsprechen den Schaltern in der englischen Oberfläche:

<Frame caption="Email notifications — Schalter für Kundenkonto- und Aktivitäts-E-Mails">
  <img src="https://mintcdn.com/ouraicall/bijtnxODi_f3mm69/images/guide-ui/white-label-email-notifications.png?fit=max&auto=format&n=bijtnxODi_f3mm69&q=85&s=2965270cb8d5d509768c9322a2f13cf9" alt="Email notifications — Schalter für Kundenkonto- und Aktivitäts-E-Mails" width="1980" height="1111" data-path="images/guide-ui/white-label-email-notifications.png" />
</Frame>

| Benachrichtigung                   | Versandzeitpunkt                                                                                              |
| ---------------------------------- | ------------------------------------------------------------------------------------------------------------- |
| **Welcome email**                  | Ein neuer Kunde erstellt ein Konto                                                                            |
| **Low balance alert**              | Ein Anruf wird wegen unzureichender Workspace-Credits blockiert                                               |
| **Auto top-up receipt**            | Eine automatische Aufladung wird abgerechnet                                                                  |
| **Low chat credits**               | Chat- oder Messaging-Credits werden knapp                                                                     |
| **Chat auto top-up receipt**       | Eine automatische Aufladung von Chat-Credits wird abgerechnet                                                 |
| **Voice clone ready**              | Ein Voice-Cloning-Auftrag ist abgeschlossen                                                                   |
| **Phone number released**          | Eine Telefonnummer wird freigegeben                                                                           |
| **Import finished**                | Ein Datenimport ist abgeschlossen                                                                             |
| **Export finished**                | Ein Datenexport ist abgeschlossen                                                                             |
| **History activity**               | Neue Anruf-, Nachrichten- oder E-Mail-Aktivität; dieser Schalter steuert die Workspace-weite Benachrichtigung |
| **Integration reconnect required** | Eine Kalender- oder Terminverbindung muss erneut autorisiert werden                                           |
| **Mission paused**                 | Eine Milian Mission pausiert nach wiederholten Fehlern automatisch                                            |
| **Booking alerts**                 | Eine Buchung geht ein, 15 Minuten vor Beginn und zum Start (Push an das Workspace-Team in der Mobile App)     |

<Note>
  Zahlungsaufforderungen bei gesperrten Konten werden unabhängig von diesen Schaltern versendet. Sie sichern die Abrechnung ab und sind keine Marketing-Benachrichtigungen.
</Note>

### Registrierungs-Webhook

Der HTTP-Callback wird bei jeder Registrierung auf deiner Domain ausgelöst. Damit kannst du neue Kunden mit deinem CRM oder Onboarding-System synchronisieren.

## Erweitert

### Aufbewahrungsgrenzen

Lege den **minimalen und maximalen Zeitraum** fest, den Kunden unter **Settings → Data Retention** wählen dürfen: 1–24 Monate oder sofortige Löschung. Diese Grenzen sind unabhängig von der Standardaufbewahrung eines Plans. Du kannst sie pro Datenkanal festlegen: Anrufe, Leads, E-Mail, SMS, WhatsApp und weitere verbundene Messaging-Kanäle.

Öffne **Whitelabel Admin → Settings → Data retention**. Lege Minimum und Maximum je Kanal fest und wähle **Save**.

<Frame caption="Data retention — minimale und maximale Aufbewahrung für die Kundenauswahl">
  <img src="https://mintcdn.com/ouraicall/bijtnxODi_f3mm69/images/guide-ui/white-label-retention.png?fit=max&auto=format&n=bijtnxODi_f3mm69&q=85&s=c4d0cff49a30018019d5b16f1d3584a1" alt="Data retention — minimale und maximale Aufbewahrung für die Kundenauswahl" width="1980" height="428" data-path="images/guide-ui/white-label-retention.png" />
</Frame>

### Marketing-Integrationen

Richte GA4, Meta Pixel, Google Ads und Microsoft UET für deine verifizierte eigene Domain ein. Die vollständige Ereignisliste und Einrichtung findest du unter [Marketing-Integrationen](/de/settings/marketing).

### Eigene Skripte

Hier hinterlegst du HTML oder `<script>` für White-Label-Seiten: ein Feld für alle Seiten und eines nur für Anmeldung und Registrierung. Nutze diese Felder für Tags, die keine eigene Einstellung haben. Der Inhalt wird ungeprüft in den Browsern deiner Kunden ausgeführt.

### Bot-Schutz

Optional schützt eine Cloudflare-Turnstile-Abfrage das Registrierungsformular. Voraussetzung ist eine verifizierte eigene Domain.

## API und MCP

Die meisten Einstellungen bearbeitest du ausschließlich unter **Whitelabel Admin → Settings**: Branding, Logos, Rechtstexte, SMTP, E-Mail-Vorlage, Benachrichtigungen, Registrierungs-Webhook und eigene Skripte. Marketing-Integrationen lassen sich über `GET` / `PUT /api/v1/settings/marketing` sowie die MCP-Tools `get_marketing_integrations` und `update_marketing_integrations` lesen und ändern; siehe [Marketing-Integrationen](/de/settings/marketing). Für eigene Domains gibt es ebenfalls eine API, beschrieben im [White-Label-Programm](/de/admin/tenants-and-whitelabel).

Das [White-Label-Programm](/de/admin/tenants-and-whitelabel) erklärt die Trennung der Kunden-Workspaces. Die [White-Label-Plattform](/de/admin/dashboard) zeigt, wo die Einstellungen in deinem Reseller-Dashboard erscheinen.
