betool

Dokumentation

Web-Chat-Widget

Auf jeder Website mit einem einzigen JS-Skript einbettbares Chat-Widget.

Das Chat-Widget ist ein JS-Skript, das Sie auf Ihrer Website (Marketing, Support, App) einbetten. Es öffnet ein Konversationsfenster, das von einer Ihrer betool-Pipelines betrieben wird; die Antworten des Agenten erscheinen fortlaufend (Streaming).

Funktionen

  • Ein Snippet, das Sie in Ihre Seite einfügen. Keine npm-Abhängigkeit; das Widget lebt in einem Shadow DOM, sodass das CSS Ihrer Website es nicht verzerrt (und umgekehrt).
  • Öffentliches Token — jederzeit im Editor neu erzeugbar. Kein Secret auf Client-Seite.
  • Kontinuität pro Tab — die Konversationskennung wird im sessionStorage gehalten: Ein Neuladen der Seite setzt den Verlauf fort, das Schließen des Tabs beendet ihn. Das Widget setzt kein Cookie.
  • 8 Sprachen — die Oberfläche des Widgets folgt der Browsersprache des Besuchers.
  • Missbrauchsschutz standardmäßig aktiv — 20 Nachrichten pro Minute und IP, 10 neue Sitzungen pro Minute und IP, höchstens 4 000 Zeichen pro Nachricht (einstellbar; 0 deaktiviert einen Schutz). Eine globale Obergrenze pro Widget (das 20-Fache des Limits pro IP) blockiert auch Fluten, die über mehrere IPs verteilt sind.

Einrichtung

  1. Konfigurieren Sie im Editor des Modells den Knoten Start mit einem Empfänger Chat (Web-Widget).
  2. Beim Speichern erzeugt betool das öffentliche Token und zeigt das Einbettungs-Snippet an, bereit zum Kopieren:
<script src="https://platform.betool.ai/widget/v1/widget.js"></script>
<script>
  BetoolChat.init({ token: "<token-public-du-widget>" });
</script>
  1. Fügen Sie dieses Snippet in das <body>-Tag Ihrer Website ein. Das Widget erscheint automatisch, standardmäßig unten rechts.

Anpassung

In der Konfiguration des Empfängers:

  • Erscheinungsbild — angezeigter Titel, Primärfarbe, Position (vier Ecken), Form des Launchers (Reiter oder Blase) und seine Beschriftung.
  • Texte — Willkommensnachricht, Platzhaltertext des Eingabefelds, Statustext (oder übersetzte „Online“-Anzeige).
  • Darstellung — Markdown-Rendering der Antworten (standardmäßig aktiviert).
  • Seitenkontext — übermittelt mit jeder Nachricht Origin und Pfad der aktuellen Seite (niemals den Query-String). Standardmäßig aktiviert, deaktivierbar.
  • Geltungsbereich — Beschränkung der erlaubten Origins.

Sicherheit

Das token ist konzeptionell öffentlich: Es erlaubt nur, mit dem Modell zu sprechen, das diesen Empfänger trägt. Wenn Sie erlaubte Origins auflisten, wird eine Anfrage von einem anderen Origin serverseitig abgelehnt (403); eine leere Liste (oder *) erzwingt keine Einschränkung — nur für die Entwicklung gedacht. Um ein kompromittiertes Token zu widerrufen: Schaltfläche neu erzeugen neben der öffentlichen URL, in der Konfiguration des Empfängers (alle bereits produktiv eingesetzten Snippets funktionieren dann nicht mehr).

Einschränkungen

  • Kein Co-Browsing: Der Agent sieht die Seite des Benutzers nicht, nur deren Origin und Pfad (wenn der Seitenkontext aktiviert ist).
  • Kein Versand von Anhängen aus dem Widget. Um Dateien zu empfangen, nutzen Sie eine E-Mail- oder Webhook-Pipeline.
  • Keine Fortsetzung der Konversation von einem Besuch zum nächsten: Das Schließen des Tabs beendet den Verlauf.