Se você migar do widget de Chat independente para o Chat integrado no Web Widget, pode notar algumas mudanças na experiência do usuário final e no processo de configuração do seu próprio widget.

Os recursos a seguir podem apresentar novas opções ou operar de forma diferente no novo Web Widget. Clique nos links para acessar tabelas ou textos que descrevem as alterações de cada recurso:

  • Estilo do iniciador do botão de chat minimizado
  • Iniciador do quadro de chat
  • Personalizações na aparência do chat
  • Janela de chat arrastável
  • APIs de chat
  • APIs da lei de cookies
  • Configuração de idiomas

Iniciador do botão de chat minimizado

O iniciador do botão de chat minimizado aparece nas instalações para computador e nos dispositivos móveis. Migrar para a experiência do Chat integrado pode alterar a aparência, a posição e o texto do rótulo do iniciador.

Caso queira fazer alterações no iniciador do botão de chat minimizado, além das opções de configuração gerais listadas na tabela abaixo, você pode desenvolver um iniciador personalizado usando as APIs do Web Widget a seguir.

  • Durante o carregamento da página, use hide para ocultar nosso iniciador e exibir o iniciador personalizado

  • Quando um visitante clicar no iniciador personalizado, use o gatilho open e show para fazer com que o Web Widget apareça
  • Quando um visitante clicar para minimizar/fechar o Web Widget, use o gatilho on close para fazer com que o iniciador personalizado seja exibido novamente
  • Para tornar o iniciador personalizado dinâmico, fazendo com que ele exiba um ícone ou rótulo especial quando o agente para chat estiver disponível, use o gatilho on chat status para capturar eventos (como chat online/offline) e modificar o ícone/rótulo do iniciador de maneira correspondente
Tabela 1.
Recurso Widget de chat antigo Novo widget integrado (padrão) Opções de configuração
Aparência (computador) Use a API launcher para personalizar o rótulo do iniciador.
Aparência (dispositivos móveis) Use a API labelVisible para fazer com que o rótulo fique visível nos iniciadores para computador e dispositivos móveis.
Posição do iniciador Fixado na parte inferior da janela do navegador. Flutuante. Use as APIs position setting e offset setting para posicionar o widget da melhor maneira.
Texto do rótulo Entrada de texto personalizada. Texto selecionado a partir das cadeias de caracteres predefinidas na interface de usuário do Support. Use a API chatLabel para personalizar o texto do rótulo.

Iniciador do quadro de chat

O design do iniciador do quadro de chat ainda está disponível no Chat integrado, caso o Chat seja o único canal ativo no Web Widget. Consulte Inicialização de chats a partir do quadro de chat.

Personalizações na aparência do chat

Várias opções de personalização que anteriormente estavam disponíveis na aba Aparência do painel do Chat não estarão mais no Chat integrado. Elas foram substituídas intencionalmente para remover elementos de design desatualizados e para simplificar as opções de configuração para o cliente.

Tabela 2.
Recurso Widget de chat antigo Novo widget integrado (padrão) Opções de configuração
Tema Opções Simples ou Clássica Somente tema Simples Consulte Personalização avançada do Web Widget para encontrar opções.
Tamanho da janela Personalizável Somente tamanho Padrão Consulte Personalização avançada do Web Widget para encontrar opções.
Widget móvel Pop-out ou sobreposição Somente sobreposição Consulte Personalização avançada do Web Widget para encontrar opções.
Estilo da mensagem Bolha de diálogo ou linhas simples Somente linhas simples Consulte Personalização avançada do Web Widget para encontrar opções.

Janela de chat arrastável

Os usuários podem arrastar a janela de chat independente pela página da web. No entanto, o Web Widget não pode ser arrastado. Em vez disso, o recurso Pop-out está disponível.

Tabela 3.
Recurso Widget de chat antigo Novo widget integrado (padrão)
Mobilidade da janela de chat Arrastável pelo usuário final A opção Pop-out abre o widget em uma nova janela do navegador

APIs de Chat

A maioria das APIs $zopim.livechat foi transferida para o Web Widget, ou seja, você pode continuar personalizando a experiência no Chat e encaminhando chats como já fazia.

Se você já estiver usando as APIs $zopim.livechat, nós criamos um alias da sintaxe da $zopim.livechat legada, ou seja, ela continuará funcionando sem que os códigos sejam atualizados.

A Zendesk descontinuará a sintaxe antiga em algum momento. Porém, isso não deve acontecer por no mínimo 12 meses. Quando ela for descontinuada, seguiremos o procedimento padrão de fim da vida útil, notificando e avisando amplamente os clientes para mitigar os impactos.

As APIs de Chat legadas que não terão suporte no Web Widget estão listadas aqui, incluindo observações sobre por que decidimos não dar suporte a elas daqui para frente.

Esta tabela descreve as APIs de Chat que já estão indisponíveis, os motivos pelos quais elas não têm mais suporte e as alternativas de substituição.

Tabela 4.
Recurso Motivos Opções de configuração
setNotes e appendNotes Apresentaram risco de segurança aos clientes.
  • Use tags
  • Crie observações para o usuário no back-end usando APIs REST
  • Crie um aplicativo de Chat personalizado usando a estrutura de aplicativos para configurar e extrair observações sobre o cliente a partir do banco de dados interno. Isso é mais comum para clientes Enterprise.

APIs da lei de cookies

O widget de Chat independente legado fornecia duas APIs relacionadas a cookies, setDefaultImplicitConsent e comply.

Nós mapeamos a API de configuração dos cookies do Chat integrado para $zopim.livechat.cookieLaw.setDefaultImplicitConsent(). Isso significa que, se anteriormente você usava setDefaultImplicitConsent para desativar cookies, a opção continuará funcionando sem a necessidade de modificar o código. Para ativar novamente o uso de cookies (ou seja, o uso do Chat), precisaremos adicionar código para ligar para a API updateSettings, permitindo os cookies quando o usuário aceita o uso. Você pode encontrar uma amostra de código, que exemplifica como isso funcionaria, na documentação do desenvolvedor. Basta clicar aqui.

Se você estiver usando $zopim.livechat.cookieLaw.comply(), isso não será mapeado e os cookies não serão desativados com o Chat integrado.

Configuração de idiomas

A detecção e configuração de idiomas para usuários finais muda ao migrar do widget de Chat para o Web Widget.

Tabela 5.
Recurso Widget de chat antigo Novo widget integrado (padrão) Opções de configuração
Configuração de idioma Detecção automática com base no conteúdo da página e no parâmetro de idioma no cabeçalho da página, ou configuração manual para um idioma específico. O idioma é definido automaticamente de acordo com as configurações do navegador do usuário. Use a API setLocale para substituir as configurações do navegador do visitante.
Powered by Zendesk