Website-Einbettung

Ein einziges script-Tag bringt das Chatfenster auf die Website – dazu die Methoden und Sprachregeln, die auf der Seite aufgerufen werden können.

Im Folgenden steht {API} für die Serviceadresse; Sie finden sie im Backend auf der Seite „Integration“.

<script src="{API}/static/aics-widget.js" data-key="pk_xxx" data-api="{API}" async></script>
  • data-key ist der öffentliche Key; kopieren Sie ihn im Backend auf der Seite „Integration“.
  • Registrieren Sie auf der Seite „Integration“ die Websites, auf denen das Widget eingebettet werden darf (z. B. https://shop.example.com). Andere Websites können das Widget auch dann nicht verwenden, wenn sie Ihren öffentlichen Key kennen. Tragen Sie dies unbedingt vor dem Livegang ein.
  • Optional: data-theme="dark" für eine dunkle Darstellung.
  • Optional: data-language="de": Wenn Ihre Website mehrsprachig ist, übergeben Sie die Sprache der aktuellen Seite; der Support verwendet dann standardmäßig diese Sprache (Besucher können weiterhin wechseln). Die unterstützten Sprachcodes finden Sie in der Übersicht über die Open API.
  • Optional: data-language="auto": Die Sprache aus <html lang> der Seite wird als Standardsprache verwendet. Wenn die Seite später die Sprache wechselt (durch Ändern des lang-Attributs; bei Single-Page-Anwendungen auch ohne Neuladen), wechselt das Supportfenster automatisch mit.

Auf der Seite können Sie Folgendes aufrufen:

MethodeFunktion
AICS.open() / AICS.close() / AICS.toggle()Öffnet, schließt oder schaltet das Supportfenster um – z. B. für eine Schaltfläche „Support kontaktieren“
AICS.identify(userToken)Teilt dem Support nach der Kundenanmeldung mit, um welchen Kunden es sich handelt (siehe Angemeldete Kunden identifizieren)
AICS.setLanguage(code)Wird aufgerufen, wenn die Website die Sprache wechselt; das Supportfenster und nachfolgende Antworten wechseln mit, z. B. AICS.setLanguage("ja"); akzeptiert auch Schreibweisen wie zh-Hans und pt-BR
AICS.reset()Wird beim Abmelden des Kunden aufgerufen: entfernt das Supportfenster und verwirft die aktuelle Sitzung; beim erneuten Laden des Skripts entsteht ein neues anonymes Fenster, und die nächste Person sieht nicht die Unterhaltung der vorherigen

Sprache

  • Das Supportfenster zeigt die Sprache passend zum Standort des Besuchers (IP) an – einschließlich Oberflächentexte und Begrüßungstexte. Wenn data-language gesetzt ist, hat die Sprache der Seite Vorrang. Lässt sich der Standort nicht ermitteln, wird die im Backend festgelegte „Standardsprache“ verwendet.
  • Die AI antwortet in der Sprache, die der Kunde verwendet. Wenn sich die Sprache des Kundenbeitrags nicht erkennen lässt (z. B. bei Emojis oder Bestellnummern), wird die oben ermittelte Sprache verwendet.
  • Der Kunde kann über das Sprachmenü im Kopfbereich des Fensters wechseln oder die AI direkt bitten: „Bitte antworte auf Englisch.“ Danach verwendet die AI durchgehend diese Sprache, auch wenn der Kunde in einer anderen Sprache schreibt.
  • Ein Sprachwechsel der Website (über AICS.setLanguage oder durch Ändern von <html lang> bei data-language="auto") gilt ebenfalls als Auswahl des Kunden; bei den oben genannten Möglichkeiten zählt jeweils die letzte Auswahl. Die beim Öffnen der Seite übergebene Standardsprache überschreibt jedoch keine Sprache, die der Kunde bereits ausgewählt hat.
  • Im Backend unter „Bot-Einstellungen → Sprache“ können Sie die Erkennung per IP deaktivieren, die Standardsprache ändern und festlegen, welche Sprachen angeboten werden.
  • Wenn die Anwendung hinter einem Reverse-Proxy oder CDN betrieben wird, müssen Sie serverseitig TRUSTED_PROXIES oder COUNTRY_HEADER konfigurieren; andernfalls lässt sich die echte IP des Besuchers nicht ermitteln.

War diese Seite hilfreich?

Zuletzt aktualisiert: