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
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
undshow
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.
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.
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.
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.
Funktion | Gründe | Konfigurationsoptionen |
---|---|---|
setNotes und appendNotes
|
Sicherheitsrisiko für Kunden |
|
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.
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. |