Das Web-Chat-Widget

Das Web-Chat-Widget

Das Web-Chat-Widget ist eine Chat-Sprechblase, die Sie mit einem einzigen <script>-Tag auf jeder Webseite einbinden. Besucher chatten mit Ihrer KI; übernimmt ein Mensch, erscheinen dessen Antworten in derselben Sprechblase — live.

Einbinden auf Ihrer Website

Fügen Sie das Snippet direkt vor Ihrem schließenden </body>-Tag ein:

<script src="https://blz.actionbridge.io/support/widget.js" data-key="wk_your_key_here"></script>

Das Widget lädt in einem eigenen Frame und kommt deshalb weder den Styles noch den Skripten Ihrer Website in die Quere.

Optionen

Attribut Wofür es steht
data-key Erforderlich. Der Widget-Key Ihres desk, aus den Settings.
data-position right (Standard) oder left — in welcher Ecke die Sprechblase sitzt.
data-offset Abstand zur Ecke in Pixeln (Standard 20).
data-lang Legt die Sprache des Widgets fest, z. B. ja. Lassen Sie es weg, sieht jeder Besucher seine eigene Browsersprache.

Zeigt Ihre Seite in derselben Ecke ein reCAPTCHA-Abzeichen, rückt das Widget automatisch darüber, sodass sich beides nicht überlappt.

Welche Sprache das Widget spricht

Ohne weitere Angabe folgt das Widget der Browsersprache des jeweiligen Besuchers. Ein japanischer Besucher einer englischen Website bekommt die japanische Sprechblase; dafür ist nichts einzurichten, und verschiedene Besucher derselben Seite können verschiedene Sprachen sehen.

Um stattdessen eine Sprache festzulegen — bei einer Website, die einen einzigen Markt bedient, ganz gleich wer sie liest —, ergänzen Sie data-lang:

<script src="https://blz.actionbridge.io/support/widget.js" data-key="wk_your_key_here" data-lang="ja"></script>

In 11 Sprachen übersetzt: Englisch, Japanisch, Koreanisch, Chinesisch (vereinfacht und traditionell), Spanisch, Französisch, Deutsch, Portugiesisch, Arabisch und Russisch. Arabisch wird von rechts nach links dargestellt, und Chinesisch richtet sich nach der Schrift des Besuchers — traditionell für Taiwan, Hongkong und Macau, sonst vereinfacht. Jede andere Sprache fällt auf Englisch zurück, statt eine halb übersetzte Sprechblase zu zeigen — data-lang="it" liefert Ihnen also Englisch.

Dasselbe gilt für das gehostete Webformular: Ergänzen Sie ?lang=ja in seiner Adresse, um die Sprache festzulegen, oder lassen Sie es weg, damit es dem Besucher folgt.

Ihre Markenfarbe

Solange Sie keine wählen, erscheint der Chat in unserem Türkis. Wählen Sie Ihre eigene Farbe, wird sie für den Kopfbereich des Chats, seine Schaltflächen und die Nachrichten Ihres Kunden verwendet, für die Schließen-Schaltfläche (✕) am Launcher, solange der Chat geöffnet ist, und für Ihr gehostetes Webformular.

  1. Öffnen Sie die Settings Ihres desk. Suchen Sie im Abschnitt Web chat (Web-Chat) nach Brand colour (Markenfarbe), direkt unter Chat bubble icon (Sprechblasen-Icon).
  2. Wählen Sie eine Farbe und klicken Sie auf Save colour (Farbe speichern).
  3. Anders überlegt? Reset to default (auf Standard zurücksetzen) holt unser Türkis zurück.

Ihre Farbe erscheint innerhalb von etwa 5 Minuten auf Ihrer Website, und Sie müssen nichts neu einfügen. Wie beim Icon können nur desk-Administratoren und der Eigentümer sie ändern.

Ein eigenes Sprechblasen-Icon verwenden

Standardmäßig ist der Launcher auf Ihrer Website unsere türkisfarbene Sprechblase mit einem Sprechblasen-Symbol (💬). Sie können sie durch Ihr eigenes PNG ersetzen, damit das Widget zu Ihrer Website passt. Das Bild, das Sie hochladen, wird zur gesamten Schaltfläche: Es füllt den kompletten 56-Pixel-Launcher aus, und wir zeichnen unseren türkisfarbenen Kreis nicht mehr dahinter.

  1. Öffnen Sie die Settings Ihres desk. Gehen Sie in den Abschnitt Web chat (Web-Chat) und suchen Sie Chat bubble icon (Sprechblasen-Icon).
  2. Klicken Sie auf Upload PNG (PNG hochladen) und wählen Sie Ihre Datei. Die Vorschau-Sprechblase neben der Schaltfläche zeigt genau, wie der Launcher aussehen wird.
  3. Anders überlegt? Reset to default (auf Standard zurücksetzen) holt unser Sprechblasen-Symbol zurück.
Bild Was funktioniert
Format PNG
Empfohlene Größe Quadratisch, mindestens 112×112 Pixel
Angezeigte Größe Füllt den gesamten Launcher, 56×56 Pixel
Form Vom Bild selbst bestimmt — ein transparenter Hintergrund wird dringend empfohlen
Dateigröße Maximal 256 KB

Der Launcher wird mit 56×56 Pixeln gezeichnet; eine Quelldatei mit 112×112 Pixeln (oder mehr) hält Ihr Zeichen deshalb auch auf hochauflösenden Bildschirmen scharf. Einen dezenten Schatten fügen wir hinzu, und er folgt der Kontur Ihrer Grafik — Sie müssen also keinen in das PNG einbauen.

Das Launcher-Icon ist ein Bild, daher färbt Ihre Markenfarbe es nicht um — Besucher sehen genau das Icon, das Sie hochladen. Weil unser Kreis nicht mehr hinter Ihrem Bild gezeichnet wird, ist bei einem transparenten PNG die Farbe, die Besucher sehen, die Farbe Ihrer eigenen Grafik.

Was der Besucher sieht

  1. Er öffnet die Sprechblase und hinterlässt Namen, E-Mail-Adresse und eine erste Nachricht.
  2. Die KI antwortet aus Ihrem Wissen, mit Quellenangaben, direkt im Chat — ohne auf jemanden aus Ihrem Team zu warten.
  3. Ein Mensch kann übernehmen — seine Antwort erscheint innerhalb weniger Sekunden im selben Chat.

Über die hinterlassene E-Mail-Adresse wird der Besucher beim nächsten Mal wiedererkannt — siehe Ihre Kundendatenbank.

Der Web-Chat ist einer von fünf Wegen zu Ihnen — siehe wie Kunden Sie erreichen und wie ein Ticket funktioniert, sobald ein Chat beginnt.

Veröffentlicht am 2026-09-22
Zuletzt aktualisiert am 2026-09-30
Version 3