Personnaliser les widgets de conversation instantanée en direct à l’aide d’indicateurs de données

Vous pouvez personnaliser les widgets de chat en direct à l’aide de balises de données dans le script du widget. Vous pouvez utiliser les balises suivantes dans le script de widget de chat que vous copiez à partir de votre application d’administration, telle que le centre d’administration du service Copilot. Pour plus d’informations : Intégrer le widget de chat dans votre site web ou votre portail

Nom de l’attribut	Descriptif	Exemple :
data-hide-chat-button	Lorsque vous implémentez votre widget de chat, vous pouvez ajouter un bouton de chat qui s’aligne sur l’expérience de votre application mobile au lieu d’utiliser le bouton de chat par défaut. Dans ce cas, utilisez cette balise de données pour masquer le bouton d’ouverture de chat par défaut disponible dans le widget de chat en direct.	<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	Lorsque vous implémentez votre widget de chat, vous pouvez désactiver le bouton de réduction à l’intérieur du chat par défaut. Utilisez cette balise de données pour masquer le bouton de réduction de chat par défaut disponible dans le widget de chat en direct.	<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	Par défaut, la collecte de données de télémétrie est activée pour tous les widgets. Définissez la valeur de cette balise de données sur true si vous souhaitez désactiver la collecte de données de télémétrie. Pour plus d’informations : Télémétrie du widget de chat en direct	<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	Ouvrez le widget de chat en mode mobile. Le widget de chat n’a pas d’en-tête lorsqu’il est utilisé sur un appareil mobile. Pour plus d’informations : Personnaliser le widget de chat en direct pour les applications mobiles	<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	Utilisez cette balise de données pour remplacer la couleur par défaut du thème du widget de chat. Ce remplacement est prioritaire sur les paramètres de thème de couleur de l’application d’administration.	Voici un exemple où la couleur du thème du widget est remplacée par du bleu.<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	La famille de polices par défaut est Segoe UI. Utilisez cette balise de données pour remplacer la famille de polices par défaut par une autre police native prise en charge.	Exemple 1 : Pour remplacer la police d’interface utilisateur Segoe par défaut et définir la famille de polices sur 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> Exemple 2 : Pour ajouter une famille de polices personnalisée comme Monotype Corsiva : <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	Utilisez cette balise de données pour ouvrir le widget de chat dans une nouvelle fenêtre. Vous pouvez définir cette balise sur true ou false (valeur par défaut). Par défaut, le widget de chat s’ouvre dans la même fenêtre de navigateur. S’il est défini sur true, le widget de chat s’ouvre dans une nouvelle fenêtre de navigateur lorsqu’il est sélectionné.	<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	Utilisez cette balise de données pour afficher les actions suggérées verticalement. Par défaut, les actions suggérées sont affichées horizontalement. Pour afficher les actions suggérées verticalement, définissez la valeur de cette balise de données sur stacked.	<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	Utilisez cette balise de données pour permettre au widget de chat de remplir automatiquement la fenêtre du navigateur en mode intégré.	<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	Utilisez cette balise de données pour personnaliser le bouton de fermeture du widget de chat. L’entrée est une chaîne de texte qui apparaît à la place du bouton de fermeture « X » par défaut.	<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	Utilisez cette balise de données pour envoyer automatiquement un code magique à l’utilisateur après la connexion, soit dans le chat, soit en mode silencieux via le client. Cette fonction est similaire à l’authentification multifacteur et permet de prévenir les attaques de phishing. Vous pouvez définir cette balise sur true (valeur par défaut) ou false. Si la valeur est , falsele code est automatiquement envoyé via le client en mode silencieux, après la connexion. S’il est défini à true, un code magique s’affiche pour que l’utilisateur puisse entrer manuellement dans le chat, après s’être connecté. Pour plus d’informations, consultez la section Paramètres supplémentaires pour les navigateurs de cet article.	Dans cet exemple, le code magique est automatiquement transmis par le client après la connexion, sans qu’il soit nécessaire d’entrer l’utilisateur. <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>

Paramètres supplémentaires pour les navigateurs

Effectuez les étapes spécifiques au navigateur décrites ici pour passer automatiquement le code magique.

Navigateurs basés sur Chromium

1. Dans Microsoft Edge, entrez « edge://flags/#third-party-storage-partitioning » dans la barre d’adresse. Dans Google Chrome, entrez « chrome://flags/#third-party-storage-partitioning » dans la barre d’adresse.
2. Sur la page qui s’affiche, définissez l’indicateur Partitionnement du stockage tiers sur Désactivé.

Firefox

1. Dans Firefox, entrez « about :preferences#privacy » dans la barre d’adresse.
2. Sur la page qui s’affiche, sélectionnez Personnalisé, puis pour Cookies, sélectionnez Cookies de suivi intersites.

Safari

Dans la boîte de dialogue des paramètres, sélectionnez Feature Flags (Feature Flags) et désactivez la sélection pour BroadcastChannel Origin Partitioning (Partitionnement de l’origine BroadcastChannel).

Étapes suivantes

Développer un widget personnalisé de conversation instantanée en direct

Informations connexes

Démarrer le chat de manière proactive
Télémétrie du widget de chat en direct
Personnaliser les widgets de conversation instantanée pour les applications mobiles
Référence du SDK de conversation instantanée en direct