Freigeben über


Live-Chat-Widgets mithilfe von Daten-Tags anpassen

Sie können Live-Chat-Widgets anpassen, indem Sie Daten-Tags im Widget-Skript verwenden. Sie können die folgenden Tags im Chat-Widget-Skript verwenden, das Sie aus Ihrer Admin-App, z. B. dem Copilot Service Admin Center, kopieren. Weitere Informationen: Chat-Widget in Ihre Website oder Ihr Portal einbetten

Attributname BESCHREIBUNG Beispiel
data-hide-chat-button Wenn Sie Ihr Chat-Widget implementieren, können Sie eine Chat-Schaltfläche hinzufügen, die sich an Ihrer mobilen App-Erfahrung orientiert, anstatt die Standard-Chat-Schaltfläche zu verwenden. Verwenden Sie in solchen Fällen dieses Daten-Tag, um die standardmäßige Schaltfläche "Chat öffnen" 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-chat-button="true"></script>
data-hide-minimize-button Wenn Sie Ihr Chat-Widget implementieren, können Sie die Schaltfläche "Minimieren" im Standard-Chat deaktivieren. Verwenden Sie dieses Daten-Tag, um die Standardschaltflä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 Sammlung von Telemetriedaten für alle Widgets aktiviert. Legen Sie den Wert dieses Datentags auf true fest, wenn Sie die Sammlung von Telemetriedaten deaktivieren möchten. Weitere Informationen: Telemetrie des Livechat-Widgets <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 Sie das Chat-Widget im mobilen Modus. Das Chat-Widget hat keine Kopfzeile, wenn es auf einem Mobilgerät verwendet wird. Weitere Informationen: Anpassen des Live-Chat-Widgets für mobile Apps <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-Widget-Designs zu überschreiben. Diese Außerkraftsetzung hat Vorrang vor allen Farbschemaeinstellungen in der Admin-App. Hier ist ein Beispiel, bei dem die Farbe des Widget-Designs in Blau geändert 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-color-override="#0000FF"></script>
data-font-family-override Die Standardschriftfamilie ist Segoe UI. Verwenden Sie dieses Daten-Tag, um die Standardschriftfamilie mit einer anderen nativ unterstützten Schriftart zu überschreiben. Beispiel 1: So überschreiben Sie die Standardschriftart der Segoe-Benutzeroberfläche und legen die Schriftfamilie auf Arial 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-font-family-override="Arial, Segoe UI"></script>

Beispiel 2: So fügen Sie eine benutzerdefinierte Schriftfamilie wie Monotype Corsiva hinzu:
<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 das Chat-Widget in einem neuen Fenster zu öffnen. Sie können dieses Tag auf oder false (trueStandardwert) setzen. Standardmäßig wird das Chat-Widget im selben Browserfenster geöffnet. Wenn diese Option auf festgelegt ist, wird das Chat-Widget in einem neuen Browserfenster geöffnet, wenn diese Option trueausgewä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 auf stackedfest. <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, um das Chat-Widget so zu aktivieren, dass das Browserfenster im eingebetteten Modus automatisch ausgefüllt 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-enable-lcw-autofill="true"></script>
data-custom-close-button-text Verwenden Sie dieses Daten-Tag, um die Schaltfläche "Schließen" des Chat-Widgets anzupassen. Die Eingabe ist eine Textzeichenfolge, die anstelle der standardmäßigen "X"-Schaltfläche zum Schließen 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 nach der Anmeldung automatisch einen magischen Code an den Benutzer 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 (Standardwert) oder falsesetzen. Wenn diese Einstellung auf falsefestgelegt ist, wird der Code nach der Anmeldung automatisch im Hintergrund über den Client gesendet. Wenn diese Option aktiviert ist true, wird dem Benutzer nach der Anmeldung ein magischer Code angezeigt, mit dem er manuell in den Chat eintreten kann. Weitere Informationen finden Sie im Abschnitt Zusätzliche Einstellungen für Browser in diesem Artikel. In diesem Beispiel wird der Magic 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>

Zusätzliche Einstellungen für Browser

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

Chromium-basierte Browser

  1. Geben Sie in Microsoft Edge "edge://flags/#third-party-storage-partitioning" in die Adressleiste ein. Geben Sie in Google Chrome "chrome://flags/#third-party-storage-partitioning" in die Adressleiste ein.
  2. Legen Sie auf der angezeigten Seite das Flag für die Speicherpartitionierung von Drittanbietern auf Deaktiviert fest.

Firefox

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

Safari

Wählen Sie im Dialogfeld "Einstellungen" die Option "Feature Flags" aus, und heben Sie die Auswahl für "BroadcastChannel Origin Partitioning" auf.

Nächste Schritte

Entwickeln Sie ein benutzerdefiniertes Live-Chat-Widget

Proaktiv chatten starten
Telemetrie des Live-Chat-Widgets
Live-Chat-Widgets für mobile Apps anpassen
Livechat SDK Referenz