Compartilhar via


Personalizar widgets de chat ao vivo usando marcas de dados

Você pode personalizar widgets de chat ao vivo usando tags de dados no script do widget. Você pode usar as seguintes tags no script do widget de chat que você copia do seu aplicativo de administração, como o centro de administração do Copilot Service. Para obter mais informações: Inserir widget de chat em seu site ou portal

Nome do atributo Descrição Exemplo
data-hide-chat-button Ao implementar seu widget de chat, você pode adicionar um botão de chat que se alinhe à sua experiência de aplicativo móvel em vez de usar o botão de chat padrão. Nesses casos, use essa tag de dados para ocultar o botão de abertura de chat padrão disponível no widget de chat ao 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 Ao implementar seu widget de chat, você pode desativar o botão minimizar dentro do chat padrão. Use essa tag de dados para ocultar o botão de minimização de chat padrão disponível no widget de chat ao 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 Por padrão, a coleta de dados de telemetria é ativada para todos os widgets. Defina o valor dessa marca de dados como true se quiser desabilitar a coleta de dados de telemetria. Mais informações: Telemetria do widget de chat ao 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 Abra o widget de chat no modo móvel. O widget de chat não tem um cabeçalho quando usado em um dispositivo móvel. Para obter mais informações: Personalizar widget de chat ao vivo para aplicativos móveis <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 Use essa tag de dados para substituir a cor padrão do tema do widget de chat. Essa substituição tem prioridade sobre qualquer configuração de tema de cores no aplicativo de administração. Aqui está um exemplo, onde a cor do tema do widget é alterada para azul.<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 A família de fontes padrão é Segoe UI. Use essa tag de dados para substituir a família de fontes padrão por outra fonte nativa suportada. Exemplo 1: Para substituir a fonte padrão da Segoe UI e definir a família de fontes como 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>

Exemplo 2: Para adicionar uma família de fontes personalizadas, como 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 Use essa tag de dados para abrir o widget de chat em uma nova janela. Você pode definir essa tag como true ou false (valor padrão). Por padrão, o widget de chat é aberto na mesma janela do navegador. Se definido como true, o widget de chat será aberto em uma nova janela do navegador quando selecionado. <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 Use essa tag de dados para exibir as ações sugeridas verticalmente. Por padrão, as ações sugeridas são exibidas horizontalmente. Para exibir as ações sugeridas verticalmente, defina o valor dessa marca de dados como 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 Use essa tag de dados para permitir que o widget de chat preencha automaticamente a janela do navegador no modo incorporado. <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 Use essa tag de dados para personalizar o botão Fechar do widget de chat. A entrada é uma cadeia de caracteres de texto que aparece no lugar do botão de fechamento 'X' padrão. <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 Use essa tag de dados para enviar automaticamente um código mágico ao usuário após o login, seja no chat ou silenciosamente pelo cliente. Essa função é semelhante à autenticação multifator e ajuda a evitar ataques de phishing. Você pode definir essa tag como true (valor padrão) ou false. Se definido como false, o código será enviado automaticamente pelo cliente silenciosamente, após o login. Se definido como true, um código mágico é exibido para o usuário entrar manualmente no bate-papo, após o login. Consulte a seção Configurações adicionais para navegadores neste artigo para obter mais informações. Neste exemplo, o código mágico é passado automaticamente pelo cliente após a entrada, sem a necessidade de entrada do usuário.
<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>

Configurações adicionais para navegadores

Execute as etapas específicas do navegador descritas aqui para passar automaticamente o código mágico.

Navegadores baseados em Chromium

  1. No Microsoft Edge, digite "edge://flags/#third-party-storage-partitioning" na barra de endereços. No Google Chrome, digite "chrome://flags/#third-party-storage-partitioning" na barra de endereço.
  2. Na página exibida, defina o sinalizador Particionamento de Armazenamento de Terceiros como Desabilitado.

Raposa de fogo

  1. No Firefox, digite "about:preferences#privacy" na barra de endereço.
  2. Na página exibida, selecione Personalizado e, para Cookies, selecione Cookies de rastreamento entre sites.

Safári

Na caixa de diálogo de configurações, selecione Sinalizadores de Recurso e desmarque a seleção para Particionamento de Origem do BroadcastChannel.

Próximas etapas

Desenvolver um widget de chat ao vivo personalizado

Iniciar bate-papo de forma proativa
Telemetria do widget de chat ao vivo
Personalizar o widgets de chat ao vivo para aplicativos móveis
Referência de SDK do chat ao vivo