betool betool

Dokumentation

Web-Chat-Widget

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

Web-Chat-Widget

Das Chat-Widget ist ein JS-Skript, das Sie auf Ihrer Website (Marketing, Support, App) einbetten. Es öffnet eine Konversationsblase, die von einer Ihrer betool-Pipelines betrieben wird.

Funktionen

  • Ein einziges Script-Tag, das Sie in Ihren <head> einfügen. Keine npm-Abhängigkeit.
  • Öffentliches Token — jederzeit über den Adminbereich widerrufbar. Kein Secret auf Client-Seite.
  • Persistente Unterhaltungen — Benutzer setzen zwischen Besuchen dort fort, wo sie aufgehört haben.
  • Multi-Pipeline — eine Website kann mehrere Widgets bereitstellen (Vorverkauf, Support, Dokumentation).

Einrichtung

  1. Administration → Chat-Widgets → Neues Widget.
  2. Geben Sie ihm einen Namen und wählen Sie die Ziel-Pipeline.
  3. Kopieren Sie das erzeugte Snippet:
<script
  src="https://platform.betool.ai/widget/v1/widget.js"
  async
></script>
<script>
  window.addEventListener('load', () => {
    window.BetoolChat.init({
      token: 'pub_wdg_xxxxxxxxxxxxxxxx',
    })
  })
</script>

Das Widget erscheint standardmäßig in der unteren rechten Ecke.

Anpassung

Im Widget-Adminbereich:

  • Erscheinungsbild — Akzentfarbe, Position, Beschriftungen.
  • Verhalten — automatisches Öffnen nach X Sekunden, Willkommensnachricht.
  • Geltungsbereich — Beschränkung der erlaubten Domains (CORS).

Sicherheit

Das token ist konzeptionell öffentlich: Es begrenzt den Geltungsbereich auf ein einzelnes Widget. Wenn es jemand von einer nicht autorisierten Domain verwendet, wird die Anfrage serverseitig abgelehnt. Um ein kompromittiertes Widget zu widerrufen: Administration → Chat-Widgets → Widerrufen.

Einschränkungen

  • Noch kein Co-Browsing (der Agent kann die Seite des Benutzers nicht sehen).
  • Das Widget verarbeitet keine großen Anhänge (>10 MB). Nutzen Sie dafür eine E-Mail-Pipeline.