Wenn Sie vom eigenständigen Chat-Widget zum integrierten Chaterlebnis im Web Widget wechseln, werden Sie einige Änderungen im Endbenutzererlebnis und in den Schritten zur Widget-Konfiguration feststellen.

Die folgenden Funktionen haben im neuen Web Widget möglicherweise neue Optionen oder verhalten sich anders. Klicken Sie auf die Links, um eine Beschreibung der jeweiligen Änderungen zu erhalten.

  • Minimierte Chatschaltfläche als Launcher
  • Chat-Badge als Launcher
  • Anpassung des Erscheinungsbilds von Chat
  • Ziehbares Chatfenster
  • Chat-APIs
  • APIs für Cookie-Richtlinien
  • Einstellen der Endbenutzersprache

Minimierte Chatschaltfläche als Launcher

Die minimierte Chatschaltfläche erscheint sowohl bei Desktop-Installationen als auch auf Mobilgeräten. Beim Wechsel auf das integriertes Chaterlebnis kann sich das Erscheinungsbild, die Platzierung und der Beschriftungstext der Schaltfläche ändern.

Wenn Sie Änderungen am Launcher vornehmen möchten, die über die allgemeinen Konfigurationsoptionen in der Tabelle unten hinausgehen, haben Sie die Möglichkeit, mit den folgenden Web-Widget-APIs einen angepassten Launcher zu erstellen.

  • Blenden Sie beim Laden der Seite unseren Launcher mit hide aus und zeigen Sie stattdessen den angepassten Launcher an.

  • Wenn ein Besucher auf den angepassten Launcher klickt, sorgen Sie mit open und show dafür, dass das Web Widget erscheint.
  • Wenn ein Besucher das Web Widget minimiert oder schließt, sorgen Sie mit on close dafür, dass wieder der angepasste Launcher angezeigt wird.
  • Wenn der angepasste Launcher je nach Verfügbarkeit eines Chat-Agenten ein spezielles Symbol oder eine spezielle Beschriftung aufweisen soll, verwenden Sie on chat status, um Ereignisse wie Chat-Agent online/offline abzufangen und das Symbol bzw. die Beschriftung des Launchers dementsprechend zu ändern.
Tabelle 1.
Funktion Altes Chat-Widget Neues integriertes Widget (Standard) Konfigurationsoptionen
Erscheinungsbild (Desktop) Verwenden Sie die API launcher, um die Beschriftung des Launchers zu ändern.
Erscheinungsbild (mobil) Verwenden Sie die API labelVisible, um die Launcher-Beschriftung sichtbar zu machen (Desktop und mobil).
Platzierung des Launchers Verankert unten im Browserfenster Unverankert Verwenden Sie die APIs position setting und offset setting, um das Widget wie gewünscht zu platzieren.
Beschriftungstext Eigener Text Auswahl einer vordefinierten Zeichenfolge in der UI von Zendesk Support Verwenden Sie die API chatLabel, um den Beschriftungstext anzupassen.

Chat-Badge als Launcher

Der Launcher kann auch beim integrierten Chaterlebnis als Chat-Badge dargestellt werden, aber nur, wenn Chat der einzige im Web Widget aktivierte Kanal ist. Weitere Informationen finden Sie unter Starten von Chats über das Chat-Badge.

Anpassung des Erscheinungsbilds von Chat

Einige Anpassungsoptionen, die bisher im Chat-Dashboard in der Registerkarte „Erscheinungsbild“ erschienen, sind beim integrierten Chaterlebnis nicht mehr verfügbar. Dieser Schritt war erforderlich, um veraltete Designelemente zu entfernen und die Konfigurationsoptionen für Kunden einfacher zu gestalten.

Tabelle 2.
Funktion Altes Chat-Widget Neues integriertes Widget (Standard) Konfigurationsoptionen
Design Einfaches oder Classic-Design Nur einfaches Design Die verfügbaren Optionen sind unter Erweiterte Anpassung des Web Widgets beschrieben.
Fenstergröße Anpassbar Nur Standardgröße Die verfügbaren Optionen sind unter Erweiterte Anpassung des Web Widgets beschrieben.
Mobiles Widget Popout oder Overlay Nur Overlay Die verfügbaren Optionen sind unter Erweiterte Anpassung des Web Widgets beschrieben.
Nachrichtenstil Sprechblasen oder einfache Zeilen Nur einfache Zeilen Die verfügbaren Optionen sind unter Erweiterte Anpassung des Web Widgets beschrieben.

Ziehbares Chatfenster

Benutzer konnten das eigenständige Chatfenster an die gewünschte Stelle auf der Webseite ziehen. Das Web Widget ist im Gegensatz dazu stationär, kann aber über die Popout-Option in einem eigenen Browserfenster angezeigt werden.

Tabelle 3.
Funktion Altes Chat-Widget Neues integriertes Widget (Standard)
Ziehbarkeit des Chatfensters Kann vom Endbenutzer an die gewünschte Stelle gezogen werden Bei Auswahl der Popout-Option erscheint das Widget in einem eigenen Browserfenster

Chat-APIs

Ein Großteil der $zopim.livechat-APIs wurden auf das Web Widget portiert. Sie können also weiterhin das Chaterlebnis wie gewohnt anpassen und Chats weiterleiten.

Wenn Sie die $zopim.livechat-APIs bereits verwenden, brauchen Sie keine Codeänderungen vorzunehmen. Dank Mapping funktioniert die $zopim.livechat-Syntax auch weiterhin.

Die Ablösung der alten Syntax ist zwar geplant, wird aber voraussichtlich in den nächsten 12 Monaten noch nicht stattfinden. Zum gegebenen Zeitpunkt werden wir dem üblichen End-of-Life-Verfahren folgen und Kunden frühzeitig informieren, damit sie ihrerseits die erforderlichen Maßnahmen treffen können.

Hier finden Sie eine Aufstellung der Legacy-Chat-APIs, die im Web Widget nicht mehr unterstützt werden, zusammen mit einer Begründung.

In der folgenden Tabelle sind die Chat-APIs aufgeführt, die ab sofort nicht mehr verfügbar sind, die Gründe, warum sie nicht mehr unterstützt werden, und die verfügbaren Alternativen.

Tabelle 4.
Funktion Gründe Konfigurationsoptionen
setNotes und appendNotes Sicherheitsrisiko für Kunden
  • Verwenden Sie stattdessen tags.
  • Verwenden Sie die REST-APIs, um Benutzernotizen auf Backend-Seite zu speichern.
  • Verwenden Sie das Apps-Framework, um eine angepasste Chat-App zu erstellen, die Kundennotizen in einer internen Datenbank speichert (und daraus abruft). Diese Alternative ist in erster Linie für Enterprise-Kunden relevant.

APIs für Cookie-Richtlinien

Das eigenständige Legacy-Chat-Widget hatte zwei APIs für Cookies: setDefaultImplicitConsent und comply.

Im integrierten Chaterlebnis haben wir die API zum Setzen von Cookies auf $zopim.livechat.cookieLaw.setDefaultImplicitConsent() gemappt. Wenn Sie also bisher Cookies mit setDefaultImplicitConsent deaktiviert haben, brauchen Sie Ihren Code nicht zu ändern. Um die Nutzung von Cookies (und damit die Nutzung von Chat) erneut zu aktivieren, müssen Sie Code hinzufügen, der die API updateSettings aufruft, um Cookies zuzulassen, nachdem der Benutzer deren Nutzung zugestimmt hat. Ein entsprechendes Codebeispiel finden Sie hier in der Dokumentation für Entwickler.

$zopim.livechat.cookieLaw.comply() wurde nicht gemappt und kann im integrierten Chaterlebnis nicht mehr zur Deaktivierung von Cookies verwendet werden.

Einstellen der Endbenutzersprache

Beim Wechsel vom Chat-Widget auf das Web Widget ändert sich die Art und Weise, wie die Endbenutzersprache erkannt und eingestellt wird.

Tabelle 5.
Funktion Altes Chat-Widget Neues integriertes Widget (Standard) Konfigurationsoptionen
Einstellen der Sprache Die Sprache wird ausgehend vom Seiteninhalt und Sprachparameter im Seitenkopfbereich automatisch erkannt bzw. manuell eingestellt. Die Sprache wird ausgehend von den Browsereinstellungen des Benutzer automatisch eingestellt. Mit der API setLocale können Sie die Browsereinstellungen übersteuern.
Powered by Zendesk