White-Label-Domain und Branding Einrichten

White-Label-Einrichtung

Drei Dinge verwandeln Ihre Organisation in eine vollständig gebrandete Plattform: eine eigene Domain, Ihr Branding und Ihr eigener SMTP-Server. Domain und SMTP sind Pflichtfeld für ein Produktiv-Setup; das Branding lässt sich jederzeit anpassen.

1. Eigene Domain

Ihre Kunden melden sich auf Ihrer eigenen Domain an (z. B. chat.your-agency.com). Der Einrichtungsassistent unter Konto → White-Label-Einrichtung führt Sie durch die Schritte:

Domain eingeben: Eine Subdomain wie chat.your-agency.com wird empfohlen.
DNS-Eintrag erstellen bei Ihrem DNS-Anbieter:
Typ Name Wert TTL
CNAME chat.your-agency.com connect.webchatagent.com 300
Klicken Sie auf DNS jetzt prüfen. Sobald der Eintrag propagiert ist (meist wenige Minuten, bis zu 24 Stunden je nach Anbieter), wird die Domain als Verifiziert markiert.

Typ	Name	Wert	TTL
CNAME	`chat.your-agency.com`	`connect.webchatagent.com`	300

Das TLS-Zertifikat für Ihre Domain wird beim ersten Aufruf automatisch ausgestellt, ein Zertifikats-Upload ist nicht erforderlich.

Die Domain muss direkt auf connect.webchatagent.com verweisen (nur DNS). Wenn Sie Cloudflare für Ihre Zone nutzen, setzen Sie den Eintrag auf "Nur DNS" (graue Wolke), nicht "Proxied".

Nach der Verifizierung erscheint die Domain unter Einstellungen → Konto mit einem grünen Badge und Ihre Plattform ist unter https://chat.your-agency.com erreichbar.

2. Branding

Unter Einstellungen → Konto → Branding legen Sie fest, wie die Plattform für Ihre Kunden aussieht:

Feld	Verwendet in
Plattform-Name	Browser-Titel, Dashboard-Header, alle E-Mails
Logo	Dashboard-Seitenleiste, Login-Seite, E-Mail-Header
Favicon	Browser-Tab
Primary Color	Buttons, Links, Akzente im gesamten Dashboard
Powered-by-Text & URL	Optionale Hinweiszeile im Chat-Widget
E-Mail-Footer-Text	Footer jeder E-Mail an Ihre Kunden
Impressum- & Datenschutz-URLs	Rechtliche Links in E-Mails, verweisen Sie hier auf Seiten Ihrer eigenen Website

Änderungen gelten nach dem Speichern plattformweit.

3. SMTP (eigener E-Mail-Server)

Alle E-Mails an Ihre Kunden, wie Einladungen, Passwort-Zurücksetzungen und Benachrichtigungen, werden über Ihren SMTP-Server mit Ihrer Absender-Adresse verschickt. Dies ist zwingend erforderlich: Ohne funktionierende SMTP-Konfiguration werden keine E-Mails für Ihre Organisation gesendet (die Plattform greift nie auf ihren eigenen Absender zurück, da dies die Plattform-Identität preisgeben und SPF/DKIM verletzen würde).

Konfigurieren Sie den Server unter Einstellungen → Konto → E-Mail / SMTP:

Feld	Beispiel
SMTP-Host	`smtp.your-domain.com`
Port	`587` (Standard)
TLS/SSL	abhängig von Ihrem Server
Benutzername / Passwort	Ihre SMTP-Zugangsdaten
Absendername	`Ihre Marke`
Absenderadresse	`noreply@your-domain.com`

Nutzen Sie Test-E-Mail senden, um die Konfiguration vor der Einladung von Kunden zu prüfen.

Stellen Sie sicher, dass die SPF/DKIM-Einträge für Ihre Absender-Domain Ihren SMTP-Anbieter enthalten, andernfalls landen Ihre Einladungen möglicherweise im Spam.

4. Widget-Einbindung unter Ihrer Marke

Das über Ihre Domain bereitgestellte Widget-Skript verwendet markenneutrale Element-Tags. Geben Sie Ihren Endkunden Snippets mit <chat-widget> (schwebend) oder <chat-agent-inline> (inline), geladen von Ihrer White-Label-Domain:

<script src="https://chat.your-agency.com/widget/chat-widget.js" async></script>
<chat-widget chatbot-id="THEIR_CHATBOT_ID"></chat-widget>

Dasselbe gilt für Session-Kontextdaten: Neben dem neutralen Attribut context-data akzeptiert das Widget die markenneutralen JavaScript-Namen window.chatWidgetContext (globale Variable, kann vor dem Laden des Skripts gesetzt werden) und das Event chat-widget:context. Für die Cookie-Einwilligung funktioniert das neutrale Event chat-widget:consent parallel zum gebrandeten Event. Dokumentieren Sie diese neutralen Bezeichnungen für Ihre Endkunden, deren Seiten müssen die Plattform zu keinem Zeitpunkt referenzieren.