Condividi tramite


Personalizzare i widget live chat utilizzando i tag di dati

Puoi personalizzare i widget della chat dal vivo utilizzando i tag dati nello script del widget. È possibile utilizzare i seguenti tag nello script del widget di chat copiato dall'app di amministrazione, ad esempio l'interfaccia di amministrazione del servizio Copilot. Ulteriori informazioni: Incorporare il widget di chat nel sito web o nel portale

Nome dell'attributo Descrizione Esempio
data-hide-chat-button Quando implementi il widget di chat, puoi aggiungere un pulsante di chat che si allinea con l'esperienza dell'app per dispositivi mobili invece di utilizzare il pulsante di chat predefinito. In questi casi, utilizza questo tag dati per nascondere il pulsante di apertura della chat predefinito disponibile nel widget della chat dal vivo. <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 Quando implementi il widget della chat, puoi disabilitare il pulsante di riduzione a icona all'interno della chat predefinita. Utilizza questo tag dati per nascondere il pulsante di riduzione a icona predefinito della chat disponibile nel widget della chat dal vivo. <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 Per impostazione predefinita, la raccolta dei dati di telemetria è attivata per tutti i widget. Impostare il valore di questo tag dati su true se si vuole disabilitare la raccolta dei dati di telemetria. Ulteriori informazioni: Telemetria del widget di chat dal vivo <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 Apri il widget della chat in modalità mobile. Il widget di chat non ha un'intestazione quando viene utilizzato su un dispositivo mobile. Ulteriori informazioni: Personalizzare il widget della chat dal vivo per le app per dispositivi mobili <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 Utilizza questo tag dati per sostituire il colore predefinito del tema del widget di chat. Questa sostituzione ha la priorità su qualsiasi impostazione del tema colore nell'app di amministrazione. Ecco un esempio, in cui il colore del tema del widget viene cambiato in blu.<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 famiglia di caratteri predefinita è Segoe UI. Utilizza questo tag dati per sostituire la famiglia di caratteri predefinita con un altro carattere nativo supportato. Esempio 1: per sostituire il tipo di carattere predefinito dell'interfaccia utente Segoe e impostare la famiglia di caratteri su 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>

Esempio 2: Per aggiungere una famiglia di caratteri personalizzata come 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 Utilizza questo tag dati per aprire il widget di chat in una nuova finestra. È possibile impostare questo tag su true o false (valore predefinito). Per impostazione predefinita, il widget di chat si apre nella stessa finestra del browser. Se impostato su true, il widget di chat si apre in una nuova finestra del browser quando selezionato. <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 Utilizzare questo tag dati per visualizzare verticalmente le azioni suggerite. Per impostazione predefinita, le azioni suggerite vengono visualizzate orizzontalmente. Per visualizzare verticalmente le azioni suggerite, impostate il valore di questo tag dati su 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 Utilizzare questo tag dati per abilitare il widget di chat a riempire automaticamente la finestra del browser in modalità incorporata. <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 Utilizza questo tag dati per personalizzare il pulsante di chiusura del widget della chat. L'input è una stringa di testo che appare al posto del pulsante di chiusura predefinito "X". <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 Utilizza questo tag dati per inviare automaticamente un codice magico all'utente dopo l'accesso, nella chat o in modo invisibile all'utente tramite il client. Questa funzione è simile all'autenticazione a più fattori e aiuta a prevenire gli attacchi di phishing. È possibile impostare questo tag su true (valore predefinito) o false. Se impostato su false, il codice viene inviato automaticamente tramite il client in modo invisibile all'utente, dopo l'accesso. Se impostato su true, all'utente viene mostrato un codice magico per accedere manualmente alla chat, dopo l'accesso. Per ulteriori informazioni, vedere la sezione Impostazioni aggiuntive per i browser in questo articolo. In questo esempio, il codice magico viene passato automaticamente attraverso il client dopo l'accesso, senza bisogno dell'input dell'utente.
<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>

Impostazioni aggiuntive per i browser

Esegui i passaggi specifici del browser descritti qui per passare automaticamente il codice magico.

Browser basati su Chromium

  1. In Microsoft Edge immettere "edge://flags/#third-party-storage-partitioning" nella barra degli indirizzi. In Google Chrome, inserisci "chrome://flags/#third-party-storage-partitioning" nella barra degli indirizzi.
  2. Nella pagina visualizzata, impostare il flag Partizionamento archiviazione di terze parti su Disabilitato.

Firefox

  1. In Firefox, inserisci "about:preferences#privacy" nella barra degli indirizzi.
  2. Nella pagina visualizzata, selezionare Personalizzato e per Cookie, selezionare Cookie di tracciamento cross-site.

Safari

Nella finestra di dialogo delle impostazioni selezionare Flag funzionalità e deselezionare Partizionamento origine BroadcastChannel.

Passaggi successivi

Sviluppare un widget di live chat personalizzato

Avvia la chat in modo proattivo
Telemetria del widget di chat dal vivo
Personalizzare widget live chat per app per dispositivi mobili
Riferimento SDK Live Chat