Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Para adicionar o script do canal WebChat no site, clique na aba Tags e depois no botão “Nova”. Escolha o tipo de tag para HTML personalizado, em HTML insira o script fornecido para o Canal WebChat no Conecta e como Acionamento deve ser selecionado o Initialization - All Pages. Depois, clique em Salvar.

...

  1. Abrir chat após navegação do usuário

Esse recurso permite a abertura do chatbot no site após determinado tempo de navegação do usuário no site. Para realizar a configuração, acesse primeiramente a aba Variáveis e clique no botão “Nova”, selecione o ícone de lápis superior e escolha Variável de camada de dados.

...

Após definição da variável, é necessário também criar um acionador por tempo. Selecione a aba referente, clique em “Novo” e na configuração do acionador escolha Timer. No campo intervalo, defina o tempo em milissegundos para a execução do componente. Em limite, determine quantas vezes o acionador deverá ser executado durante a navegação de um usuário e na etapa de condições, escolha conforme sua preferência.

...

Adicione uma nova tag e no campo HTML insira o código abaixo. Depois, na etapa de Acionadores, selecione o Timer criado.

Code Block
<script>
  if ({{Chat Foi Aberto}} !== 'true') {
    window.webchat.chatOpen(); 
  }
</script>

...

Por fim, escolha a tag criada anteriormente com o script para ativação do WebChat e adicione o seguinte código, antes do fechamento do </script> e salve a modificação.

Code Block
window.webchat('afterOpen', function() {
    window.dataLayer.push({ webchatHasOpen: 'true' });
});

...

Se assim configurado para seu site, após 10s de navegação na página o usuário receberá o ChatBot para interação.

  1. Enviar dados do site para o cadastro do contato

Aprenda a como configurar o uso e envio de dados para os campos adicionais do contato no Conecta Leucotron por meio do chat iniciado no canal WebChat.

Inicialmente, é necessário alterar o script de ativação do Webchat na aba de tags e inserir uma nova linha no código contendo o nome do campo adicional - campo deve ser criado antes. Exemplo:

Code Block
s.webchat('szf_pagina_atual', {{Page Path}});

...

Dessa forma ao enviar ou visualizar as modificações e o chat for iniciado, a informação da página será exibida no campo adicional do contato.

...

  1. Encaminhar dados do fluxo para o Tag Manager por meio do Evento WebChat

Este recurso oferece a funcionalidade de enviar eventos configurados no fluxo, bem como eventos automáticos, diretamente para o Google Tag Manager.

Para adicionar o componente "Evento Webchat" ao seu fluxo, siga os seguintes passos:

  1. Na aba fluxo de atendimento, navegue para a seção de edição.

  2. Em seguida, selecione o componente "Evento Webchat" disponível na lista de componentes.

  3. Insira as informações relevantes que você deseja que sejam enviadas para o Tag Manager na caixa de texto do componente.

  4. Posicione o evento no local desejado dentro do fluxo para que ele seja acionado conforme sua preferência.

Após essa configuração inicial, no Google Tag Manager modifique o script de ativação para capturar os eventos enviados pelo componente Evento Webchat:

Code Block
<script type="text/javascript">
    (function(s, z, c, h, a, t) {
        s.webchat = s.webchat || function() {
            (s.webchat.q = s.webchat.q || []).push(arguments);
        };
        t = z.createElement(c),
        a = z.getElementsByTagName(c)[0]; t.async = 1;
        t.src = 'https://domain.sz.chat/webchat/v2/webchat.js'; 
        a.parentNode.insertBefore(t, a);
        s.webchat('cid', '615daaae7a90be00117c5930');
        s.webchat('host', h);
    })(window, document, 'script', 'https://domain.sz.chat');
    
    window.dataLayer = window.dataLayer || [];
    
    window.addEventListener("message", function(event) {
        if(event.origin !== 'https://domain.sz.chat') return;
        
        if(event.data.action === 'chat-event'){
            window.dataLayer.push({
                event: event.data.action,
                message: event.data.message
            });
        }
    }, false);
    
    window.webchat('afterOpen', function(event) {
        window.dataLayer.push({ chat_status: 'aberto' });
    });
</script>

Detalhes do script

  1. Obrigatório: declaração da lista de objetos, contendo variáveis e eventos do Tag Manager.

    Code Block
    window.dataLayer = window.dataLayer || [];
  2. Capturar os eventos do fluxo e enviá-los para o Google Tag Manager.

    Code Block
    window.addEventListener("message", function(event) {
        if(event.origin !== 'https://hub.conecta.com.vc') return;//origem
    
        if(event.data.action === 'chat-event'){//ação do componente
            window.dataLayer.push({//envio dos eventos
                event: event.data.action,
                message: event.data.message
            });
        }
    }, false);

Eventos automáticos

No exemplo abaixo, o script está definido para capturar quando o chat for aberto:

Code Block
window.webchat('afterOpen', function(event) {
    window.dataLayer.push({ chat_status: 'aberto' });
});

Eventos

Após o carregamento do script, alguns eventos ficarão disponíveis e para capturar os eventos é necessário acessar o método de instância:

Code Block
window.webchat('nome-do-evento')

Exemplo:

Code Block
<script>
    window.webchat('onReady', function(event) {
      console.log('O chat está pronto');
    })

    window.webchat('afterClose', function(event) {
      console.log('O chat fechou');
    })
</script>

Nome do evento

Acionador

onReady

Quando o chat é carregado

beforeOpen

Antes de abrir o chat

onOpen

Ao abrir o chat

afterOpen

Após abrir o chat

beforeClose

Antes de fechar o chat

onClose

Ao fechar o chat

afterClose

Após fechar o chat

Parâmetros disponíveis antes do carregamento do chat via script

Code Block
s.webchat('host', h);
s.webchat('szf_custom_var', 'custom value');

Option

Type

Default

Description

debug

Boolean

false

Exibe informações de debug no console.

locale

String

pt-BR

Linguagem de exibição.

cid

String

null

ID do canal. Obrigatório por script ou por URL.

button_label

String

null

Texto que vai aparecer no balão do lado do botão do chat e que tem prioridade em relação a configuração do texto no canal (Disponível apenas no modo janela).

fid

String

null

ID do fluxo que o chat será iniciado, se vazio inicia no fluxo padrão.

z-index

Integer

2147483640

Altera a ordem de exibição do elemento na página.

szf_name

String

null

Definir nome do usuário do chat.

szf_email

String

null

Definir e-mail do usuário do chat.

szf_{CAMPO}

String

null

É possível definir qualquer campo adicional usando o prefixo szf_ + nome do campo em minúsculo, ex.: szf_telefone (Só é permitido utilizar letras e underlines, um campo adicional deve ser criado no Conecta com as mesmas características, removendo apenas o ‘szf_’).