Partilhar via

Personalizar widgets de chat em direto através de etiquetas de dados

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

Nome do atributo Descrição Exemplo
data-hide-chat-button Ao implementar seu widget de bate-papo, você pode adicionar um botão de bate-papo que se alinha com sua experiência de aplicativo móvel em vez de usar o botão de bate-papo padrão. Nesses casos, use essa tag de dados para ocultar o botão de bate-papo aberto padrão disponível no widget de bate-papo 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 bate-papo padrão. Use essa tag de dados para ocultar o botão padrão minimizar bate-papo disponível no widget de bate-papo 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 está ativada para todos os widgets. Defina o valor dessa marca de dados como true se quiser desabilitar a coleta de dados de telemetria. Para obter 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 bate-papo 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 marca 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 cor 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 marca 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 interface do usuário Segoe 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 personalizada 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 esta tag de dados para abrir o widget de bate-papo em uma nova janela. Você pode definir essa tag como true ou false (valor padrão). Por padrão, o widget de bate-papo é 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 marca 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 esta 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 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 esta tag de dados para enviar automaticamente um código mágico para o usuário após o login, seja no chat ou silenciosamente através do cliente. Esta função é semelhante à autenticação multifator e ajuda a prevenir ataques de phishing. Você pode definir essa tag como true (valor padrão) ou false. Se definido como false, o código é enviado automaticamente através do 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 o login, sem precisar da 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 no Chromium

  1. No Microsoft Edge, digite "edge://flags/#third-party-storage-partitioning" na barra de endereço. 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 Desativado.

Firefox

  1. No Firefox, digite "about:preferences#privacy" na barra de endereço.
  2. Na página apresentada, selecione Personalizar e, em Cookies, selecione Cookies de rastreio entre sites.

Safári

Na caixa de diálogo de configurações, selecione Feature Flags e desmarque a seleção para BroadcastChannel Origin Partitioning.

Próximos passos

Desenvolver um widget de chat em direto personalizado

Inicie o bate-papo proativamente
Telemetria do widget de chat ao vivo
Personalizar widgets de chat em direto para aplicações móveis
Referência SDK do chat em direto

  • Last updated on