Website-Chatbot

Website Chatbot

Video-Tutorial

Website Chatbot

Auf der Tutorials-Seite ansehen →

Der Website-Chatbot stellt Ihren KI-Assistenten auf jeder Website als kleine Chat-Blase bereit, die Besucher öffnen und nutzen können. Sie konfigurieren ihn vollständig in QAnswer und fügen anschließend ein einziges Code-Snippet in Ihre Website ein.

Öffnen Sie den Assistenten, wechseln Sie zum Tab Bereitstellen und wählen Sie die Karte „Website-Chatbot“. Die geöffnete Seite ist eine fünfstufige Installationsanleitung; arbeiten Sie die Schritte von oben nach unten ab.

Hinweis
Die Karte „Website-Chatbot“ wird nur für Assistenten mit dem Aufgabentyp „Chat“ angeboten.

Schritt 1 — Anpassen

Der erste Schritt ist zweigeteilt: Die Karte „Widget-Einstellungen“ links enthält die Optionen, die „Widget-Vorschau“ rechts zeigt das Ergebnis live, während Sie sie ändern.

Schritt 1 der Installationsanleitung mit den Widget-Einstellungen links und einer Live-Widget-Vorschau rechts

Die obere Hälfte der Einstellungskarte bestimmt Aussehen und Verhalten des Widgets:

  • Widget-Titeldie Überschrift oben im geöffneten Widget. Bleibt das Feld leer, wird der Name des Assistenten verwendet.
  • Erste Nachrichtdie Begrüßung, mit der der Assistent startet, bevor der Besucher etwas eingibt.
  • DesignAutomatisch, Hell oder Dunkel. „Automatisch“ folgt der Systemeinstellung des Besuchers.
  • Beim ersten Besuch ist das Widget…„Minimiert“ zeigt nur die Blase, „Geöffnet“ klappt den Chat sofort auf.
  • Position auf dem Bildschirmin welcher Ecke das Widget sitzt — unten rechts, unten links, oben rechts oder oben links.
  • Export von Unterhaltungen erlaubenfügt ein Bedienelement hinzu, mit dem Besucher ihre Unterhaltung herunterladen können.

Weiter unten auf derselben Karte finden Sie die feineren Gestaltungsoptionen:

Die untere Hälfte der Karte „Widget-Einstellungen“ mit Positionsabstand, Akzentfarbe und CSS-Schrifteigenschaft
  • Positionsabstandder Abstand in Pixeln zwischen Widget und Bildschirmrändern in X- und Y-Richtung — nützlich, wenn das Widget sonst etwas auf Ihrer Website verdecken würde.
  • Akzentfarbedie Primär- und Sekundärfarbe des Widgets, damit es zu Ihrer Marke passt.
  • „Powered by“-Text anzeigendeaktivieren Sie das Kontrollkästchen, um den QAnswer-Hinweis am unteren Rand des Widgets zu entfernen.
  • CSS-Eigenschaft „font“eine erweiterte Option, mit der Sie eine rohe CSS-Schriftdeklaration übergeben, damit das Widget zur Typografie Ihrer Website passt.
Warnung
Diese Einstellungen gelten für alle Widget-Integrationen dieses Assistenten, auch für Drittanbieter-Integrationen wie WordPress oder Wix. Klicken Sie auf „Speichern“ in der Ecke der Karte „Widget-Einstellungen“, um Ihre Änderungen zu übernehmen — die Vorschau aktualisiert sich sofort, gespeichert wird jedoch erst beim Speichern.

Schritt 2 — Testen

Bevor Sie Ihre echte Website anfassen, können Sie sich das Widget darauf ansehen. Geben Sie die Adresse der Seite ein, auf der Sie es ausprobieren möchten:

Schritt 2, Testen, mit dem Chip „Simulieren“, einem Feld für die Website-URL und den Aktionen „Kopieren“ und „Demo öffnen“
  • „Demo öffnen“ öffnet diese Seite in einem neuen Tab, mit Ihrem Widget darüber gelegt.
  • „Kopieren“ kopiert den Demo-Link, damit Sie ihn zur Prüfung an Kolleginnen und Kollegen senden können.
Hinweis
Dies ist ausschließlich eine Simulation zur Vorschau — auf der eingegebenen Website wird nichts installiert, und der Demo-Link ist keine Möglichkeit, das Widget bereitzustellen. Nutzen Sie dafür das Snippet aus Schritt 4.

Schritt 3 — Zugriff wählen

Ein Widget auf einer öffentlichen Website muss für Personen erreichbar sein, die nicht bei QAnswer angemeldet sind. Dieser Schritt legt fest, wer das ist. Es gibt zwei Karten, und Sie nutzen entweder die eine oder die andere:

Schritt 3, Zugriff wählen, mit den Karten „Offener Zugriff“ und „Geschützter Zugriff“ nebeneinander

Offener Zugriff

Macht den Assistenten öffentlich erreichbar, ganz ohne Zugangsdaten:

  • Für alle zugänglichjede Person, die Ihre Website lädt, kann das Widget nutzen. Das ist die übliche Wahl für eine öffentliche Website.
  • Nicht zugänglichniemand außerhalb von QAnswer kann darauf zugreifen. Solange dies ausgewählt ist, funktioniert das Widget nicht.
Hinweis
Andere Oberflächen des Assistenten bieten zusätzlich „Für alle angemeldeten Benutzer zugänglich“. Diese Option ist für das Widget bewusst ausgeblendet, da Besucher Ihrer Website nicht bei QAnswer angemeldet sind.

Geschützter Zugriff

Statt den Assistenten zu öffnen, können Sie einen API-Schlüssel erzeugen, den die Integration mit jeder Anfrage sendet:

  • Geben Sie dem Schlüssel einen Namen und klicken Sie auf „Schlüssel generieren“. Kopieren Sie den Schlüssel, sobald er erscheint — Sie sehen ihn nur dieses eine Mal.
  • „API-Schlüssel nur im lokalen Browserspeicher ablegen (erweitert)“ hält den Schlüssel aus dem Seitenquelltext heraus und legt ihn stattdessen im Browserspeicher des Besuchers ab.
Warnung
Der Zugriff ist eine Einstellung auf Assistentenebene. Eine Änderung hier wirkt sich auch auf die Chat-Oberfläche, die Suchoberfläche, die REST-API und jede Drittanbieter-Integration des Assistenten aus — nicht nur auf dieses Widget.
Hinweis
Dieser Schritt steuert ausschließlich den anonymen, öffentlichen Zugriff. Um den Assistenten mit bestimmten Benutzern, Teams oder Organisationen zu teilen, verwenden Sie stattdessen den Dialog „Teilen“ in der oberen Leiste des Assistenten.

Schritt 4 — Exportieren

Der letzte erforderliche Schritt liefert Ihnen den Code zum Einfügen in Ihre Website. Es gibt drei Varianten derselben Integration; wählen Sie die, die zum Aufbau Ihrer Website passt.

Das Script-Snippet, ein einzelnes Script-Tag, das auf den QAnswer-Widget-Loader verweist
  • Scriptein einzelnes '<script>'-Tag, das das Widget von QAnswer lädt. Die einfachste Variante und für nahezu jede Website die richtige.
  • Script Contentder Inline-Inhalt dieses Skripts, für Plattformen, auf denen Sie JavaScript hinzufügen können, aber kein Script-Tag mit src-Attribut.
  • IFrameeine '<iframe>'-Einbettung, für Umgebungen, in denen externe Skripte durch eine Content Security Policy blockiert werden.
Hinweis
Fügen Sie das Snippet unmittelbar vor dem schließenden '</body>'-Tag jeder Seite ein, auf der das Widget erscheinen soll. In Website-Editoren wie Confluence, Wix oder WordPress müssen Sie es unter Umständen in ein „Codeblock“- oder „HTML-Block“-Element setzen. Solange in Schritt 3 kein Zugriffstyp festgelegt oder kein API-Schlüssel erzeugt wurde, bleibt dieser Schritt ausgegraut.

Schritt 5 — Zusätzliche Daten anpassen (optional)

Ihre Website weiß oft Dinge über den Besucher, die der Assistent nicht kennt — wer er ist, welchen Tarif er nutzt, welche Seite er gerade liest. Mit zusätzlichen Daten geben Sie diese als Schlüssel-Wert-Paare an den Assistenten weiter. Tragen Sie einen Feldnamen und einen Beispielwert ein und fügen Sie mit der Schaltfläche + weitere Zeilen hinzu.

Schritt 5 mit dem Schlüssel-Wert-Paar botName / Support Bot und dem daraus erzeugten Snippet darüber

Ein hinzugefügtes Paar verändert das Snippet in Schritt 4, kopieren Sie den Code also erneut, nachdem Sie hier etwas geändert haben. Die eingetragenen Beispielwerte dienen nur dem Aufbau des Snippets — ersetzen Sie sie beim Einfügen durch echte Werte aus Ihrer eigenen Website.

Hinweis
Auf die eingespeisten Felder können Sie anschließend in den Anweisungen des Assistenten verweisen, um den Besucher etwa mit Namen zu begrüßen.