Freigeben über


Passen Sie Live-Chat-Widgets mithilfe von Daten-Tags an

Live-Chat-Widgets können mithilfe von Daten-Tags im Widget-Skript angepasst werden. Sie können die folgenden Tags im Chat-Widget-Skript verwenden, das Sie aus Ihrer Admin-App kopieren, z. B. Customer Service-Admin Center. Weitere Informationen: Einbetten des Chat-Widget in Ihre Website oder Ihr Portal

Attribute name Beschreibung des Dataflows Beispiel
data-hide-chat-button Wenn Sie Ihren Chat Widget implementieren, können Sie eine Chat-Schaltfläche hinzufügen, die zu Ihrer mobilen App-Erfahrung passt, anstatt die Standard-Chat-Schaltfläche zu verwenden. In diesem Fall können Sie dieses Datentag verwenden, um die standardmäßige Schaltfläche zum Öffnen des Chats zu verbergen, die im Live-Chat Widget verfügbar ist. <script id="Microsoft_Omnichannel_LCWidget" src="<valid-src>" data-app-id="<valid-app-id>" data-org-id="<valid-org-id>" data-org-url="<valid-org-url>" data-hide-chat-button="true"></script>
data-hide-minimize-button Wenn Sie Ihr Chat-Widget implementieren, können Sie die Schaltfläche „Minimieren“ im Standardchat deaktivieren. Verwenden Sie dieses Daten-Tag, um die standardmäßige Schaltfläche zum Minimieren des Chats auszublenden, die im Live-Chat-Widget verfügbar ist. <script id="Microsoft_Omnichannel_LCWidget" src="<valid-src>" data-app-id="<valid-app-id>" data-org-id="<valid-org-id>" data-org-url="<valid-org-url>" data-hide-minimize-button="true"></script>
data-disable-telemetry Standardmäßig ist die Telemetriedatenerfassung für alle Widgets aktiviert. Setzen Sie den Wert dieses Daten-Tags auf true fest, wenn Sie die Telemetrie-Datenerfassung deaktivieren möchten. Weitere Informationen: Livechatwidget Telemetrie <script id="Microsoft_Omnichannel_LCWidget" src="<valid-src>" data-app-id="<valid-app-id>" data-org-id="<valid-org-id>" data-org-url="<valid-org-url>" data-disable-telemetry="true"></script>
data-render-mobile Öffnen des Chat-Widgets im mobilen Modus. Der Chat Widget hat keinen Header, wenn er auf einem mobilen Gerät verwendet wird. Mehr Informationen: Live-Chat Widget für mobile Apps anpassen <script id="Microsoft_Omnichannel_LCWidget" src="<valid-src>" data-app-id="<valid-app-id>" data-org-id="<valid-org-id>" data-org-url="<valid-org-url>" data-render-mobile="true" ></script>
data-color-override Verwenden Sie dieses Daten-Tag, um die Standardfarbe des Chat-Designs Widget zu überschreiben. Diese Überschreibung hat Vorrang vor allen Farbdesigneinstellungen in der Admin-App. In diesem Beispiel wird die Themenfarbe des Chatwidgets auf blau geändert.<script id="Microsoft_Omnichannel_LCWidget" src="<valid-src>" data-app-id="<valid-app-id>" data-org-id="<valid-org-id>" data-org-url="<valid-org-url>" data-color-override="#0000FF"></script>
data-font-family-override Die Standard-Schriftfamilie ist Segoe UI. Verwenden Sie dieses Daten-Tag, um die Standardschriftartenfamilie mit einer anderen unterstützten nativen Schriftart zu überschreiben. Beispiel 1: Überschreiben der Standardschriftart Segoe UI und Festlegen der Schriftartfamilie auf Arial:
<script id="Microsoft_Omnichannel_LCWidget" src="<valid-src>" data-app-id="<valid-app-id>" data-org-id="<valid-org-id>" data-org-url="<valid-org-url>" data-font-family-override="Arial, Segoe UI"></script>

Beispiel 2: Eine benutzerdefinierte Schriftartfamilie wie Monotype Corsiva hinzufügen:
<script id="Microsoft_Omnichannel_LCWidget" src="<valid-src>" data-app-id="<valid-app-id>" data-org-id="<valid-org-id>" data-org-url="<valid-org-url>" data-font-family-override="Monotype Corsiva"></script>
data-open-in-window Verwenden Sie dieses Daten-Tag, um den Chat Widget in einem neuen Fenster zu öffnen. Sie können dieses Tag auf true oder false setzen (Standardwert). Standardmäßig wird das Chat-Widget im selben Browserfenster geöffnet. Wenn Sie den Wert auf true festlegen, wird das Chat-Widget in einem neuen Browserfenster geöffnet, wenn es ausgewählt ist. <script id="Microsoft_Omnichannel_LCWidget" src="<valid-src>" data-app-id="<valid-app-id>" data-org-id="<valid-org-id>" data-org-url="<valid-org-url>" data-open-in-window="true"></script>
data-suggested-action-layout Verwenden Sie dieses Daten-Tag, um die vorgeschlagenen Aktionen vertikal anzuzeigen. Standardmäßig werden die vorgeschlagenen Aktionen horizontal angezeigt. Um die vorgeschlagenen Aktionen vertikal anzuzeigen, legen Sie den Wert dieses Daten-Tags als stacked fest. <script id="Microsoft_Omnichannel_LCWidget" src="<valid-src>" data-app-id="<valid-app-id>" data-org-id="<valid-org-id>" data-org-url="<valid-org-url>" data-suggested-action-layout="stacked"></script>
data-enable-lcw-autofill Verwenden Sie dieses Daten-Tag, damit das Chat-Widget das Browser-Fenster im eingebetteten Modus automatisch füllt. <script id="Microsoft_Omnichannel_LCWidget" src="<valid-src>" data-app-id="<valid-app-id>" data-org-id="<valid-org-id>" data-org-url="<valid-org-url>" data-enable-lcw-autofill="true"></script>
data-custom-close-button-text Verwenden Sie dieses Daten-Tag, um die Schließen-Schaltfläche des Chats Widget anzupassen. Die Eingabe ist eine Textzeichenfolge, die anstelle der standardmäßigen X-Schließen-Schaltfläche angezeigt wird. <script id="Microsoft_Omnichannel_LCWidget" src="<valid-src>" data-app-id="<valid-app-id>" data-org-id="<valid-org-id>" data-org-url="<valid-org-url>" data-custom-close-button-text="End Chat"></script>
data-enable-sso-magic-code Verwenden Sie dieses Daten-Tag, um dem Benutzer nach der Anmeldung automatisch einen magischen Code zu senden, entweder im Chat oder im Hintergrund über den Client. Diese Funktion ähnelt der Multifaktor-Authentifizierung und hilft, Phishing-Angriffe zu verhindern. Sie können dieses Tag auf true oder false setzen (Standardwert). Ist dies auf false festgelegt, wird der Code nach der Anmeldung automatisch stillschweigend durch den Client gesendet. Ist dies auf true festgelegt, wird dem Benutzer nach der Anmeldung ein magischer Code angezeigt, den er manuell in den Chat eingeben kann. Weitere Informationen finden Sie im Abschnitt Weitere Einstellungen für Browser in diesem Artikel. In diesem Beispiel wird der magische Code nach der Anmeldung automatisch durch den Client geleitet, ohne dass eine Benutzereingabe erforderlich ist.
<script id="Microsoft_Omnichannel_LCWidget" src="<valid-src>" data-app-id="<valid-app-id>" data-org-id="<valid-org-id>" data-org-url="<valid-org-url>" data-enable-sso-magic-code="false"></script>

Weitere Einstellungen für Browser

Führen Sie die hier beschriebenen browserspezifischen Schritte aus, um den Magic-Code automatisch zu übergeben.

Chromium-basierte Browser

  1. Geben Sie bei Microsoft Edge „edge://flags/#third-party-storage-partitioning“ in die Adressleiste ein. Geben Sie bei Google Chrome „chrome://flags/#third-party-storage-partitioning“ in die Adressleiste ein.
  2. Setzen Sie auf der angezeigten Seite das Kennzeichen für Drittanbieter-Speicherpartitionierung auf Deaktiviert.

Firefox

  1. Geben Sie bei Firefox „about:preferences#privacy“ in die Adressleiste ein.
  2. Wählen Sie auf der angezeigten Seite Benutzerdefiniert und für Cookies die Option Siteübergreifende Tracking-Cookies.

Safari

Wählen Sie im Einstellungsdialog Feature-Kennzeichen aus und deaktivieren Sie die Auswahl für BroadcastChannel-Herkunftspartitionierung.

Nächste Schritte,

Entwickeln Sie ein benutzerdefiniertes Live-Chat-Widget

Siehe auch

Chat proaktiv starten
Livechatwidget Telemetrie
Live-Chat-Widgets für mobile Apps anpassen
Livechat SDK Referenz