branchly®
Demo buchen

Anleitungen

Individuelles Styling von Benutzeroberflächen via CSS

  • Web Components: Unsere Benutzeroberflächen sind als Web Components aufgebaut. Web Components sind ein Standard wiederverwendbarer Custom Elements – mit vollständig vom restlichen Code gekapselter Funktionalität –, die du flexibel in deinen Web-Apps nutzen kannst. Weitere Details findest du in der MDN-Dokumentation zu Web Components.
  • Style-Vererbung: Diese Benutzeroberflächen können bestimmte Stilelemente der eingebetteten Seite erben, wie beispielsweise font-size und font-family. Dies stellt sicher, dass sich die Oberfläche harmonisch in das Design der Host-Seite einfügt. Style-Vererbung greift nur für Bereiche, die deine eigenen Inhalte darstellen. Für branchly-eigene Komponenten werden Stile (mit Ausnahme von font-family) nicht vererbt.
  • Anpassung mit CSS: Um das Aussehen unserer Oberflächen nach deinen Vorstellungen anzupassen, kannst du eigene CSS-Stile auf die unten aufgelisteten vordefinierten Container-Selektoren der jeweiligen Oberfläche anwenden.
  • Anwenden eigener Stile: Du kannst deine CSS-Regeln entweder in ein <style>-Tag direkt im HTML-Dokument einfügen oder in einer externen .css-Datei hinterlegen. Beim Definieren der Stile kann die !important-Deklaration erforderlich sein, um Standardstile zu überschreiben. Beispielsweise sorgt font-size: 0.7rem !important; dafür, dass deine Größenangabe Vorrang vor den bestehenden Regeln hat.

Textfarbe für Elemente mit weißem Hintergrund

Einige Elemente (Fragevorschlags-Bubbles, Reset-Buttons) besitzen einen festen weißen Hintergrund. Ihre Textfarbe passt sich zur Sicherstellung der Lesbarkeit automatisch an: Ist dein konfiguriertes font_color auf weißem Hintergrund zu hell, wird automatisch eine gut lesbare Fallback-Farbe genutzt. Dadurch bleibt Text unabhängig von deiner Farbwahl stets lesbar. Um dieses Verhalten zu überschreiben, adressiere die spezifische Klasse des Elements (z. B. .suggested-question { color: deine-farbe !important; }).

Stile bereits beim Einbinden festlegen

Du kannst Stile und Anpassungen bereits bei der Einbindung des Containers auf deiner Website mitgeben. Mehr zu dieser Option erfährst du hier.

Chat (Chat Embed)

#branchly-chat-embed-container {
}

.embed-title {
  /* alias: .welcome-heading */
}

.welcome-heading {
  /* alias: .embed-title */
}

.welcome-heading-container {
}

.home-button {
  /* alias: .reset-button */
}

.reset-button {
  /* alias: .home-button */
}

.next-nodes-container {
}

.next-node {
}

.assistant-name {
}

.assistant-message {
}

.user-name {
}

.user-message {
}

.chat-container {
}

.chat-button {
}

.chat-input {
}

.chat-input::-webkit-input-placeholder {
  /* WebKit-Browser */
}

.chat-input:-moz-placeholder {
  /* Mozilla Firefox 4 bis 18 */
}

.chat-input::-moz-placeholder {
  /* Mozilla Firefox 19+ */
}

.chat-input:-ms-input-placeholder {
  /* Internet Explorer 10 */
}

.suggested-questions-container {
}

.suggested-question {
}

.carousel-button-left {
}

.carousel-button-right {
}

Chat-Widget

#branchly-chat-widget-container {
}

.chat-widget-container {
}

.widget-header-container {
}

.widget-interaction-container {
}

.close-widget-button {
}

.welcome-message {
  /* alias: .welcome-heading */
}

.welcome-heading {
  /* alias: .welcome-message */
}

.widget-welcome-message-container {
  /* alias: .welcome-heading-container */
}

.welcome-heading-container {
  /* alias: .widget-welcome-message-container */
}

.chat-bubble-container {
}

.next-nodes-container {
}

.next-node {
}

.assistant-name {
}

.assistant-message {
}

.user-name {
}

.user-message {
}

.chat-container {
}

.chat-button {
}

.chat-input {
}

.chat-input::-webkit-input-placeholder {
  /* WebKit-Browser */
}

.chat-input:-moz-placeholder {
  /* Mozilla Firefox 4 bis 18 */
}

.chat-input::-moz-placeholder {
  /* Mozilla Firefox 19+ */
}

.chat-input:-ms-input-placeholder {
  /* Internet Explorer 10 */
}

.chat-entry-suggestions-container {
}

.suggested-question {
}

.close-suggested-questions-container-button {
}

.reset-button {
}

.carousel-button-left {
}

.carousel-button-right {
}
#branchly-embed-container {
}

.embed-title {
  /* alias: .welcome-heading */
}

.welcome-heading {
  /* alias: .embed-title */
}

.welcome-heading-container {
}

.next-nodes-container {
}

.next-node {
}

.search-container {
}

.search-button {
}

.home-button {
}

.content-container {
}

.selected-node {
}

.selected-nodes-container {
}

.search-input {
}

.search-input::-webkit-input-placeholder {
  /* WebKit-Browser */
}

.search-input:-moz-placeholder {
  /* Mozilla Firefox 4 bis 18 */
}

.search-input::-moz-placeholder {
  /* Mozilla Firefox 19+ */
}

.search-input:-ms-input-placeholder {
  /* Internet Explorer 10 */
}

Search (Search Interface)

#branchly-search-interface-container {
}

.search-app-container {
}

.search-entry-point {
}

.branchly-heading-bubble {
}

.branchly-search-bubble {
}

.heading-message-container {
  /* alias: .welcome-heading-container */
}

.welcome-heading-container {
  /* alias: .heading-message-container */
}

.searchbar-container {
}

.searchbar {
}

.searchbar-form {
}

.searchbar-submit-button {
}

.reset-search-button {
  /* alias: .reset-button */
}

.reset-button {
  /* alias: .reset-search-button */
}

.ai-message-container {
}

.ai-message {
}

.search-results-container {
}

.search-result-card {
}

.search-result-card-image {
}

.search-result-card-content {
}

.search-result-card-accordion-content {
}

.suggested-questions-container {
}

.suggested-questions {
}

.suggested-question {
}

.welcome-heading {
}

Search Interface – Praktische Styling-Beispiele

Styling des Einstiegs-Buttons:

Standardmäßig zeigt der Einstiegs-Button (aktiviert über das Attribut data-view-mode="search-button") ein Lupen-Icon zusammen mit dem Text "Search... | ⌘ + K" bzw. "Search... | Strg + K" an. Der zweite Teil des Textes signalisiert den Tastatur-Shortcut zum Öffnen der Oberfläche unter macOS oder Windows.

Wenn du nur das Lupen-Icon ohne den Begleittext anzeigen möchtest, kannst du dies mit folgenden CSS-Regeln umsetzen:

.search-entry-point {
    border: none; /* Entfernt den Rahmen */
    padding: 10px; /* Passt das Padding an; trage hier deinen gewünschten Wert ein */
    svg {
      margin: 0; /* Entfernt den Standard-Icon-Abstand */
    }
  }

  .search-entry-point span {
    display: none; /* Blendet das Element mit dem Text aus */
  }

Das Ergebnis sieht wie folgt aus:

Selbstverständlich kannst du unterschiedliche Stile für verschiedene Endgeräte definieren. Nutze dazu @media-Queries wie im folgenden Beispiel:

/* Nur das Lupen-Icon auf kleineren Bildschirmen anzeigen */

@media (max-width: 768px) { /* Setze hier deinen eigenen Breakpoint */
  .search-entry-point {
    border: none; /* Entfernt den Rahmen */
    padding: 10px; /* Passt das Padding an; trage hier deinen gewünschten Wert ein */
    svg {
      margin: 0;
      font-size: 30px; /* Passt die Icon-Größe an; trage hier deinen gewünschten Wert ein */
    }
  }

  .search-entry-point span {
    display: none; /* Blendet das Element mit dem Text aus */
  }
}

Chat-Widget – Praktische Styling-Beispiele

Widget um 120px nach oben verschieben:

Wenn das Widget Elemente am unteren Bildschirmrand überlagert (z. B. ein Cookie-Banner oder einen Sticky Footer), kannst du das gesamte Widget per CSS nach oben versetzen. Das folgende Beispiel hebt alle UI-Elemente des Widgets – den Einstiegs-Bubble, die vorgeschlagenen Fragen, das geöffnete Chat-Panel und den Schließen-Button – um 120px an, sowohl auf dem Desktop als auch auf mobilen Geräten. Auf Smartphones behält das geöffnete Panel seine standardmäßige Vollbild-Position bei, sodass dort lediglich der Einstiegs-Bubble und die Fragevorschläge angehoben werden.

Füge die Regeln in ein <style>-Tag auf deiner Seite oder in deine externe .css-Datei ein:

/*
 * Verschiebt das Chat-Widget um 120px nach oben – auf Desktop und Mobile:
 * - Einstiegs-Bubble und vorgeschlagene Fragen (bei geschlossenem Widget)
 * - geöffnetes Chat-Panel und Schließen-Button
 *
 * Auf Mobile behält das geöffnete Panel seine standardmäßige Vollbild-Position;
 * dort werden nur der Einstiegs-Bubble und die vorgeschlagenen Fragen angehoben.
 */

/*
 * Widget-Container, verankert in der unteren rechten Ecke. Das Anheben
 * dieses Containers verschiebt das geöffnete Panel auf dem Desktop sowie
 * den Einstiegs-Bubble + Fragevorschläge auf Mobile. Verwende margin-bottom
 * (nicht transform/translate), damit die interne Positionierung des Widgets
 * intakt bleibt.
 */
#branchly-chat-widget-container {
  margin-bottom: 120px !important;
}

/*
 * Nur Desktop und Tablet: Unterhalb von 471px schaltet das Widget auf
 * sein mobiles Layout um. Auf großen Bildschirmen sind der Einstiegs-Bubble,
 * das Popup für Fragevorschläge und der Schließen-Button unabhängig vom
 * Container verankert, weshalb jedes Element um 120px angehoben werden muss.
 */
@media (min-width: 471px) {
  /*
   * Einstiegs-Bubble (wird bei geschlossenem Widget angezeigt). Die :not()-Bedingung
   * lässt den Willkommens-Bubble im geöffneten Panel unberührt – da dieselbe
   * Klasse für beide genutzt wird, behalte diesen Selektor beim Kopieren bei.
   */
  .chat-bubble-container:not(.widget-interaction-container *) {
    margin-bottom: 120px !important;
  }

  /* Popup für Fragevorschläge mit den Frage-Buttons */
  .chat-entry-suggestions-container {
    margin-bottom: 120px !important;
  }

  /* Schließen-Button des geöffneten Chat-Panels */
  .close-widget-button {
    margin-bottom: 120px !important;
  }

  /*
   * Hält das geöffnete Panel auf niedrigen Bildschirmen nach dem Anheben im Viewport.
   * 170px = standardmäßiger Abstand des Widgets von 50px zum unteren Rand + 120px Verschiebung.
   * Passe diesen Wert zusammen mit dem Verschiebungswert oben an.
   * Auf ausreichend hohen Bildschirmen hat diese Regel keine Auswirkung.
   */
  .chat-widget-container {
    max-height: calc(100svh - 170px) !important;
  }
}

/*
 * Nur Mobile: Auf Smartphones würde das geöffnete Panel die 120px-Verschiebung
 * des Containers erben. Dies fixiert es wieder am unteren Bildschirmrand
 * in Standard-Vollbildgröße, sodass mobil nur der Einstiegs-Bubble und
 * die vorgeschlagenen Fragen angehoben werden.
 */
@media (max-width: 470px) {
  .chat-widget-container {
    position: fixed !important;
    bottom: 0 !important;
    left: 0 !important;
    width: 100svw !important;
    height: 100svh !important;
  }
}

Um das Widget um einen anderen Abstand zu verschieben, ersetze die 120px-Werte. Beachte, dass die 170px in der max-height-Regel die Summe aus dem Standardabstand des Widgets von 50px zum unteren Bildschirmrand und der Verschiebung von 120px darstellen – passe diesen Wert entsprechend an.

Widget auf der linken Seite positionieren:

Standardmäßig ist das Branchly Chat-Widget in der unteren rechten Ecke der Website verankert. Um es stattdessen in der unteren linken Ecke zu positionieren, müssen sowohl der geschlossene Zustand (Chat-Bubble und Fragevorschläge) als auch der geöffnete Zustand (Chat-Fenster und Schließen-Button) angepasst werden.

Füge die folgenden CSS-Regeln in ein <style>-Tag auf deiner Website oder in deine externe .css-Datei ein:

/* ========================================================
   Branchly Chat-Widget – Linksbündige Ausrichtung (Universal)
   ======================================================== */

/* Desktop & Tablets (>= 768px) */
@media (min-width: 768px) {
  /* 1. Geschlossener Zustand: Chat-Bubble-Button */
  body #chat-bubble-button,
  body .chat-bubble-container {
    position: fixed !important;
    inset: auto auto 20px 20px !important;
    left: 20px !important;
    right: auto !important;
    transform: none !important;
  }

  /* 2. Geschlossener Zustand: Fragevorschläge-Popup */
  body .chat-entry-suggestions-container {
    left: 20px !important;
    right: auto !important;
    align-items: flex-start !important;
    transform: none !important;
  }

  /* 3. Geöffneter Zustand: Chat-Fenster-Container */
  body #branchly-chat-widget-container {
    left: 20px !important;
    right: auto !important;
  }

  /* 4. Geöffneter Zustand: Schließen-Button (X) */
  body .close-widget-button {
    left: 20px !important;
    right: auto !important;
    bottom: 20px !important;
  }
}

/* Mobile Bildschirme (< 768px) */
@media (max-width: 767px) {
  /* Geschlossener Zustand: Bubble auf der linken Seite */
  body #chat-bubble-button,
  body .chat-bubble-container {
    position: fixed !important;
    inset: auto auto 80px 16px !important;
    left: 16px !important;
    right: auto !important;
    bottom: 80px !important; /* Bei Bedarf anpassen, falls mobile Navigationsleisten vorhanden sind */
    margin-left: 0 !important;
    margin-right: auto !important;
    transform: none !important;
  }

  /* Geschlossener Zustand: Fragevorschläge auf der linken Seite */
  body .chat-entry-suggestions-container {
    position: fixed !important;
    left: 16px !important;
    right: auto !important;
    bottom: 95px !important;
    align-items: flex-start !important;
    transform: none !important;
  }

  /* HINWEIS: Auf Smartphones (<= 470px) öffnet sich das Chat-Fenster
     standardmäßig im Vollbildmodus (100svw/100svh). Wende daher auf kleinen
     Bildschirmen keinen left-Offset auf #branchly-chat-widget-container an,
     um ein horizontales Überlaufen zu verhindern. */
}

Funktionsweise der 4 Selektoren:

Zustand Element / Selektor Funktion & Verhalten
Geschlossen body #chat-bubble-button, body .chat-bubble-container Positioniert den ungeöffneten Chat-Bubble-Button in der unteren linken Ecke.
Geschlossen body .chat-entry-suggestions-container Richtet die Fragevorschlags-Pills über dem Bubble linksbündig (flex-start) aus.
Geöffnet body #branchly-chat-widget-container Root-Container des geöffneten Chat-Fensters. Standardmäßig auf right: 50px !important gesetzt. Muss auf left: 20px !important; right: auto !important; gesetzt werden, damit das Fenster beim Öffnen nicht nach rechts springt.
Geöffnet body .close-widget-button Kreisförmiger Schließen-Button (X), der auf dem Desktop bei geöffnetem Chat angezeigt wird. Muss bündig mit dem Bubble positioniert werden.

Hinweise zur Plattform-Integration:

  • Shopify: Platziere den <style>-Block in layout/theme.liquid direkt unter dem Branchly-Embed-Script vor dem schließenden </body>-Tag. (Vermeide die Option „Custom CSS“ im Theme-Customizer, wenn das Script direkt in theme.liquid eingebunden ist).
  • WordPress / WooCommerce: Füge die CSS-Regeln über Design > Customizer > Zusätzliches CSS oder in die style.css deines Child-Themes ein.
  • Webflow: Platziere den Code unter Project Settings > Custom Code > Footer Code.
  • Custom React / HTML: Binde das CSS in deine globalen Styles ein. Die body-Spezifität und !important stellen sicher, dass Standardstile (z. B. aus Emotion) zuverlässig überschrieben werden.

Jetzt branchly erleben!

Termin vereinbaren