Resumo

Este guia explica como configurar um chatbot em Wati para coletar parâmetros UTM (Urchin Tracking Module) e armazená-los como atributos de contato. Essa configuração ajuda você a rastrear de onde vêm leads e conversas, capturando automaticamente dados UTM durante as interações com o cliente.

Ao final desta configuração, seu chatbot irá:

Ativar automaticamente através de uma Ação de Palavra-chave
Coletar parâmetros UTM de mensagens recebidas
Armazenar os valores coletados em atributos de contato

Instruções

Adicionar parâmetros UTM ao script do widget de chat Wati

Adicione o script abaixo ao seu arquivo HTML após o script de importação.

Onde colocá-lo: Insira o seguinte código dentro da tag <body>, preferencialmente logo antes da tag </body> de fechamento.

Importante:

Certifique-se de que o script do widget de chat inclua os parâmetros UTM necessários para que o Wati possa capturá-los e rastreá-los corretamente.

Os parâmetros definidos na seção trackingData no script abaixo são valores de exemplo para referência e podem ser personalizados com base em sua configuração e nos parâmetros UTM que você deseja rastrear.

Antes de continuar, certifique-se de revisar o guia completo para adicionar um widget de chat ao seu site, incluindo o rastreamento UTM.

Aqui está o script de exemplo para sua referência:

<script>
  window.onload = function () {
    // Defina seus parâmetros de rastreamento.
    // Substitua estes pelos seus parâmetros UTM e personalizados reais.
    //
    // Você pode obter esses parâmetros de:
    // 1. Parâmetros da URL
    // 2. localStorage
    // 3. Cookies do navegador
    // 4. Valores estáticos de campanha

    var trackingData = {
      utm_source: "google",
      utm_medium: "cpc",
      utm_campaign: "spring_sale",
      pr_prod_strat: "e5_desc",
      pr_rec_id: "9c7af79a0",
      pr_rec_pid: "9827376955687",
      pr_ref_pid: "9827375939879",
      pr_seq: "uniform",
    };

    // Comprima e codifique os dados de rastreamento
    var compressedParams =
      CrossPlatformCompressor.encode(trackingData);

    // Inicialize o widget Wati WhatsApp
    WatiWidget.CreateWhatsappChatWidget({
      brandSetting: {
        // Seu número do WhatsApp
        phoneNumber: "18129934041",

        // Mensagem padrão com parâmetros de rastreamento codificados
        messageText: `Olá,\nTenho uma pergunta sobre https://test_website.\n\n[ContextId: ${compressedParams}]`,
      },
    });

    // Observação:
    // "ContextId" deve corresponder à palavra-chave configurada
    // no módulo de Automação do Wati.
  };
</script>

Criar um Chatbot para rastrear parâmetros UTM

Etapa 1: Criar um novo chatbot

Vá para Automação > Chatbot em seu ambiente Wati.
Clique em Adicionar Chatbot.

Digite um nome para o chatbot.
Clique em Adicionar.

Etapa 2: Adicionar o nó "Coletar UTM"

Dentro do construtor do chatbot, localize o tipo de nó Coletar UTM.
Adicione o nó Coletar UTM ao fluxo do chatbot.
Clique no nó recém-adicionado.

Uma janela pop-up aparecerá com um campo de entrada de palavra-chave.

Digite uma palavra-chave de sua escolha.

Importante: Salve esta palavra-chave, pois você precisará dela mais tarde ao configurar a regra de Palavra-chave.

Clique em Salvar.

Etapa 3: Adicionar o nó "Atualizar Atributo"

Localize o tipo de nó Atualizar Atributo.
Adicione o nó ao fluxo do chatbot.
Clique no nó recém-adicionado.

Uma janela pop-up aparecerá com campos para configuração de atributos.

Configurar os campos

Você deve configurar os seguintes 2 campos:

Campo	Valor
Campo esquerdo	`collect_result`
Campo direito	`@collect_result`

Dica: Você pode pesquisar usando a palavra-chave collect para localizar rapidamente esses valores.

Clique em Salvar.

Concluir a configuração do fluxo do chatbot

Antes de salvar o chatbot, certifique-se de que a seguinte configuração esteja completa:

O nó CollectUTM está definido como a etapa inicial.
O nó CollectUTM está conectado ao nó Update Attribute.

Após confirmar a configuração:

Clique em Salvar para salvar o chatbot.

Etapa 4: Criar uma nova regra de Palavra-chave

Adicionar a regra de palavra-chave para acionar o chatbot

Vá para Automação > Regras.
Clique em + Criar Regras.

Selecionar um gatilho

Escolha o evento que deve iniciar a automação.

Para mensagens do WhatsApp, selecione Nova mensagem do WhatsApp recebida.

O gatilho determina quando o Wati deve avaliar a regra.

Adicionar um filtro de palavra-chave

Em seguida, defina as palavras-chave que devem ativar a regra.

Em Filtros, selecione Mensagem de entrada corresponde à(s) palavra(s)-chave.
Escolha Contém como o método de correspondência.
Adicione a palavra-chave que criamos anteriormente neste guia: collectUTM.

Importante: A palavra-chave deve corresponder à palavra-chave configurada no nó CollectUTM. A correspondência de palavras-chave não diferencia maiúsculas de minúsculas.

Adicionar uma ação (resposta automatizada)

Agora, defina o que deve acontecer quando a palavra-chave for detectada.

Vá para a seção Ações.
Escolha Iniciar chatbot como a ação.
Selecione o chatbot que você acabou de criar anteriormente.

Ativar e salvar a regra

Assim que sua configuração estiver completa:

Digite o nome para sua regra (se ainda não o fez).
Ligue a regra Ligado.
Clique em Salvar alterações.

Resultado

Sua configuração de coleta de UTM está completa. Quando a palavra-chave configurada for acionada, o chatbot irá:

Coletar parâmetros UTM da conversa
Armazenar os dados coletados no atributo de contato
Permitir que você use os dados UTM capturados para fins de rastreamento e relatório

Perguntas Frequentes (FAQs)

Visão Geral

1. O que faz esta configuração de UTM em Wati?

Esta configuração permite que o Wati colete parâmetros UTM (Urchin Tracking Module) de conversas, armazene-os como atributos de contato e use os dados para fins de rastreamento e relatório.

2. O que acontece após a conclusão da configuração de coleta de UTM?

Após a conclusão da configuração, o chatbot pode:

Ativar automaticamente através de uma Ação de Palavra-chave
Coletar parâmetros UTM de mensagens recebidas
Armazenar os valores UTM coletados em atributos de contato

Configuração do Script do Widget de Chat

3. Onde o script do widget de chat Wati deve ser adicionado no arquivo HTML?

O script do widget de chat Wati deve ser adicionado dentro da tag <body>, preferencialmente logo antes da tag </body> de fechamento.

4. Por que os parâmetros UTM devem ser incluídos no script do widget de chat?

Os parâmetros UTM devem ser incluídos no script do widget de chat para que o Wati possa capturá-los e rastreá-los corretamente.

5. Os parâmetros na seção trackingData podem ser personalizados?

Sim. Os parâmetros definidos na seção trackingData são valores de exemplo e podem ser personalizados com base em sua configuração e nos parâmetros UTM que você deseja rastrear.

6. O que o valor ContextId no script representa?

O valor ContextId no script deve corresponder à palavra-chave configurada no módulo de Automação do Wati.

Configuração do Chatbot

7. Qual configuração de fluxo de chatbot é necessária antes de salvar o chatbot?

Antes de salvar o chatbot:

O nó CollectUTM deve ser configurado como a etapa inicial.
O nó CollectUTM deve ser conectado ao nó Update Attribute.

Configuração da Regra de Palavra-chave

8. A correspondência de palavras-chave diferencia maiúsculas de minúsculas na configuração da Regra de Palavra-chave?

Não. A correspondência de palavras-chave na configuração da Regra de Palavra-chave não diferencia maiúsculas de minúsculas.

Como capturar e armazenar parâmetros UTM no Wati