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
Hat die Organisation des Assistenten das Expose-Add-on nicht, öffnet sich diese Anleitung nur lesend: Oben erscheint der Hinweis „Expose-Add-on erforderlich“, und alle Schritte sind ausgegraut. Siehe Das Expose-Add-on.
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-Titel — die Überschrift oben im geöffneten Widget. Bleibt das Feld leer, wird der Name des Assistenten verwendet.
  • Erste Nachricht — die Begrüßung, mit der der Assistent startet, bevor der Besucher etwas eingibt.
  • Design — Automatisch, 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 Bildschirm — in welcher Ecke das Widget sitzt — unten rechts, unten links, oben rechts oder oben links.
  • Export von Unterhaltungen erlauben — fü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
  • Positionsabstand — der 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.
  • Akzentfarbe — die Primär- und Sekundärfarbe des Widgets, damit es zu Ihrer Marke passt.
  • „Powered by“-Text anzeigen — deaktivieren 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, wie sie hineinkommen:

Schritt 3, Zugriff wählen, mit den Optionen Öffentlich, Nur mit API-Schlüssel und Erweitert: Schlüssel im lokalen Speicher
  • Öffentlich — alle, die Ihre Website laden, können das Widget nutzen, ohne API-Schlüssel. Das ist die übliche Wahl für eine öffentliche Website.
  • Nur mit API-Schlüssel — der Assistent bleibt privat, und das Snippet enthält einen API-Schlüssel, mit dem das Widget hineinkommt.
  • Erweitert: Schlüssel im lokalen Speicher — es wird kein API-Schlüssel erzeugt oder in das Snippet geschrieben: Ihre Seite übergibt dem Widget den Schlüssel zur Laufzeit. Der Status lautet dann „Bereit: Der Code unten enthält keinen API-Schlüssel; Ihre Seite stellt ihn zur Laufzeit bereit.“
Hinweis
Eine Option Angemeldete Nutzer gibt es hier nicht, da Besucher Ihrer Website nicht bei QAnswer angemeldet sind. Hat eine andere Oberfläche den Assistenten bereits auf Angemeldete Nutzer gesetzt, wird die Option trotzdem angezeigt, mit dem Vermerk „Funktioniert hier nicht“: Wählen Sie dann eine andere.

Ist Nur mit API-Schlüssel ausgewählt, erscheinen die Schlüssel-Einstellungen direkt unter der Option:

  • „Vorhandenen API-Schlüssel verwenden“ listet die Schlüssel des Assistenten, die hier verwendet werden können; abgelaufene Schlüssel und Read-and-write-Schlüssel werden ausgelassen. Die Auswahl erscheint nur, wenn Sie Schreibzugriff auf den Assistenten haben und ein solcher Schlüssel existiert.
  • Für einen neuen Schlüssel geben Sie unter „Name des API-Schlüssels“ einen Namen ein und klicken auf „Schlüssel generieren“.
  • Der gewählte Schlüssel wird dann maskiert angezeigt, mit einer Kopierschaltfläche; „Anderen Schlüssel verwenden“ bringt die Auswahl zurück. QAnswer merkt sich den Schlüssel in Ihrem Browser und wählt ihn beim nächsten Öffnen der Anleitung wieder aus.

Ein Wechsel zu Öffentlich oder Angemeldete Nutzer legt den Schlüssel beiseite, da dann keiner nötig ist; er kehrt zurück, wenn Sie wieder Nur mit API-Schlüssel wählen.

Hinweis
Unter den Optionen zeigt eine Statusmeldung, ob die Integration bereit ist, etwa „Bereit: Alle können diese Integration nutzen, kein API-Schlüssel nötig.“, oder was noch fehlt, etwa „Noch nicht bereit: Wählen oder erstellen Sie oben einen API-Schlüssel.“
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
  • Script — ein einzelnes '<script>'-Tag, das das Widget von QAnswer lädt. Die einfachste Variante und für nahezu jede Website die richtige.
  • Script Content — der Inline-Inhalt dieses Skripts, für Plattformen, auf denen Sie JavaScript hinzufügen können, aber kein Script-Tag mit src-Attribut.
  • IFrame — eine '<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 die Statusmeldung in Schritt 3 nicht Bereit meldet, 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.

Der Schritt Export mit dem Script-Snippet, das das Paar botName / Support Bot enthält, gefolgt vom Schritt für erlaubte Domains und dem Schritt zum Anpassen zusätzlicher Daten, in dem dieses Paar eingetragen wird

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.