Theming: optisch in Ihre Website einfügen

Jede Olotalk-Oberfläche rendert in einem Shadow Root; das Stylesheet Ihrer Seite erreicht ihr Inneres deshalb nicht. Das ist Absicht: So bleiben Zitate, das Grounding-Badge und die Zustände „Antwort / keine Antwort“ intakt – unabhängig davon, wie die Oberfläche gestaltet ist. Sie können ändern, wie sie aussieht; Sie können nicht ändern, was sie sagt.

Zum Anpassen definieren Sie eine kleine Menge CSS Custom Properties. Diese überqueren die Grenze des Shadow DOM. Platzieren Sie sie irgendwo im Vererbungsbaum der Oberfläche – :root ist am einfachsten – und der Assistant übernimmt sie.

:root {
  --olotalk-font-family: 'Inter', system-ui, sans-serif;
  --olotalk-accent: #4f46e5;
  --olotalk-surface: #ffffff;
  --olotalk-text: #111827;
  --olotalk-radius: 10px;
}

Das ist die ganze Integration. Kein JavaScript, kein Konfigurationsobjekt, kein Rebuild. Das funktioniert für jede Platzierung – sowohl die Corner bubble als auch der Inline-Assistant lesen dieselben Tokens.

Wenn Sie nichts setzen, sieht die Oberfläche exakt so aus, wie sie ausgeliefert wird. Jeder Token fällt auf seinen eingebauten Wert zurück; das Hinzufügen dieses Blocks verursacht also nie ein Restyling, das Sie nicht ausdrücklich wollten. Es ändert nur das, was Sie explizit setzen.


  1. 1
    --olotalk-font-familyGesamter Text
  2. 2
    --olotalk-accentLinks, Senden, Fokus
  3. 3
    --olotalk-surfacePanel-Hintergrund
  4. 4
    --olotalk-textNachrichtentext
  5. 5
    --olotalk-radiusEcken von Buttons und Inputs
  6. 6
    --olotalk-borderTrenner und Kanten

Tokens

TokenSteuert
--olotalk-font-familySchriftfamilie für sämtlichen Text. Der wirksamste Token: Wenn die Schrift zu Ihrer Website passt, wirkt die Oberfläche sofort „wie Ihre eigene“.
--olotalk-font-sizeBasis-Schriftgröße.
--olotalk-line-heightBasis-Zeilenhöhe.
--olotalk-accentAkzent- / Primärfarbe – Links, Senden, Fokus.
--olotalk-textPrimäre Textfarbe.
--olotalk-mutedSekundärer Text – Zeitstempel, Beschriftungen, Platzhalter.
--olotalk-surfaceHaupt-Hintergrund des Panels.
--olotalk-surface-altSekundärer Hintergrund – Header, Hover-Zeilen, Chips.
--olotalk-borderFarbe von Trennern und Rahmen.
--olotalk-radiusEckenradius für Buttons, Inputs und Chips.
--olotalk-radius-panelEckenradius des äußeren Panels.
--olotalk-shadowSchatten des Panels.

Setzen Sie nur die Tokens, die Ihnen wichtig sind. Ein gängiges Minimal-Set ist --olotalk-font-family, --olotalk-accent und --olotalk-surface – genug, damit sich die Oberfläche auf den meisten Websites nativ anfühlt.

Abdeckung

Der Chat-Assistant liest nur die Tokens, die er tatsächlich zeichnet. Wenn Sie einen Token setzen, den er ignoriert, geht nichts kaputt – er bleibt einfach wirkungslos.

  • Chat-Assistant (floating und embedded) liest alle Tokens außer --olotalk-font-size; die Textgrößen leitet er aus seiner eigenen Typografie-Skala ab, die von --olotalk-font-family und --olotalk-line-height gesteuert wird.

Was Sie absichtlich nicht themen können

Spacing und Layout. Es gibt keine Tokens für Padding, Gaps oder Elementgrößen. Wenn ein eingebettetes Widget alle Styles der Host-Seite erben würde, würde es auf Seiten mit ungewöhnlichem CSS unweigerlich kaputt aussehen; deshalb behält die Oberfläche ihren eigenen inneren Rhythmus und gibt nur das Erscheinungsbild frei. Das ist eine bewusste Grenze und keine fehlende Funktion.

Die Vertrauensebene. Zitate, Quellenliste, Grounding-Badge und das ehrliche „I don’t have that“ sind strukturell. Tokens dürfen Farbe, Typografie und Radius ändern; sie können diese Elemente nicht verstecken oder entfernen.


Priorität

Wenn ein Wert an mehreren Stellen gesetzt ist, gewinnt der spezifischste:

--olotalk-* Token
in Ihrem Stylesheet
overrides
Dashboard-Erscheinungsbild
pro Assistant konfiguriert
overrides
eingebauter Standardwert
was ausgeliefert wird

Ein --olotalk-*-Token in Ihrem Stylesheet überschreibt denselben Wert, der im Olotalk-Dashboard konfiguriert wurde; dieser überschreibt wiederum den eingebauten Default. Das CSS-Token gewinnt, weil es die lokalste Ausdrucksform Ihrer Absicht ist.


Dark Mode

Tokens sind dafür da, den Assistant in Ihre Website einzupassen, nicht für den Wechsel zwischen hell und dunkel. Damit der Chat-Assistant im Dark Mode rendert, verwenden Sie seine theme-Option (theme: 'dark') – das ist eine eigene Achse neben den Tokens. Anschließend können Sie mit Tokens die dunkle Palette weiter auf Ihre Marke abstimmen.


Beispiel: ein eingebetteter Chat, der zu Ihrer Website passt

Sie betten den Chat inline ein (siehe Embed-Referenz → Embedded mode) und möchten, dass er wie ein Bestandteil der Seite wirkt statt wie ein angeflanschter Assistant? Kombinieren Sie das Embed mit einigen Tokens:

<div id="chat" style="height: 560px;"></div>

<style>
  :root {
    --olotalk-font-family: var(--site-font, 'Inter', sans-serif);
    --olotalk-accent: #0d9488;
    --olotalk-surface: #fbfbf9;
    --olotalk-surface-alt: #f0efe9;
    --olotalk-border: #e4e2da;
    --olotalk-text: #1c1b19;
    --olotalk-radius: 8px;
    --olotalk-radius-panel: 12px;
  }
</style>

<script>
  window.OlotalkConfig = {
    assistantId: 'ast_oltk_7Kd2mQxRv9TbNhLpW3Zsy',
    mode: 'inline',
    mount: '#chat',
  };
</script>
<script src="https://cdn.jsdelivr.net/npm/@olotalk/assistant-loader@0/dist/loader.iife.js" async></script>

Verwenden Sie eine Variable, die Ihre Website bereits definiert (--site-font im Beispiel oben), und der Assistant übernimmt Ihre Typografie automatisch.