Como identificar usuários vindos de um anúncio Click to Chat WhatsApp publicado no Facebook

Como parte da v2.33 da API WhatsApp Business, as empresas terão acesso ao recurso In-Thread-Context para anúncios Click to WhatsApp. Com o In-Thread Context, um consumidor pode facilmente fazer referência ao anúncio em que clicou e uma empresa pode entender facilmente quais mensagens de clientes vêm de quais anúncios publicados no Facebook.

Quando um usuário clica em um anúncio Click to WhatsApp e envia uma mensagem para a empresa, a empresa anunciante recebe uma notificação de mensagem incluindo a propriedade referral, que fornece contexto adicional sobre o anúncio que originou aquela mensagem.

Para analisar essas informações diretamente no Blip, alguns passos são necessários:

Primeiro, você precisa configurar no fluxo do seu bot-contato inteligente para que sejam gerados registros de eventos das mensagens originadas a partir de um anúncio Click to WhatsApp.

Nas configurações do bloco de início de fluxo do seu bot-contato inteligente, vá na guia Ações e adicione uma ação de saída do tipo Executar script.

Em Variáveis de Entrada adicione a variável input.message

Clique na opção Script e na janela do builder.js que se abrir adicione o script abaixo:

function run(inputMessage) {

    let inputMessageFormatted = JSON.parse(inputMessage);

    let metadata = inputMessageFormatted.metadata;




    if (metadata && metadata['#wa.referral.headline']) {

        return JSON.stringify({

            headline: metadata['#wa.referral.headline'],

            body: metadata['#wa.referral.body'],

            source_type: metadata['#wa.referral.source_type'],

            source_id: metadata['#wa.referral.source_id'],

            source_url: metadata['#wa.referral.source_url'],

            media_id: metadata['#wa.referral.image.id']

        });

    }

    else {

        return JSON.stringify(inputMessageFormatted);

    }

}

Observação: a mensagem que contém os metadados referente ao In-Thread Context possui as seguintes propriedades:

• #wa.referral.headline (Título usado no anúncio que gerou a mensagem)
• #wa.referral.body (Corpo do anúncio que gerou a mensagem)
• #wa.referral.source_type (O tipo de origem do anúncio. Atualmente, os valores suportados são ad e post)
• #wa.referral.source_id (ID do Facebook para um anúncio ou postagem)
• #wa.referral.source_url (O url que leva ao anúncio. Abrir este url leva você ao anúncio visualizado pelo seu usuário)
• #wa.referral.image.id ou #wa.referral.video.id (Opcional. A imagem ou vídeo que o usuário viu e clicou. Este objeto estará ausente se a configuração do aplicativo skip_referral_media_download for definida como true)

Lembre-se: você é livre para escrever o script e definir as configurações seguintes como quiser. Portanto, uma dica é sempre usar o “Testar” (botão situado no canto superior direito do Builder) e observar os logs dessas mensagens 😉

Feche a janela do builder.js e ainda nas configurações de ações do bloco defina a variável metadata no campo Salvar Retorno.

Volte na tela anterior e adicione mais uma ação de saída do tipo Registro de Eventos.

Defina o valor referral no campo Categoria e o valor {{metadata}} (variável definida no retorno da ação de execução do script nos passos anteriores) no campo Ação.

Na mesma interface anterior mais abaixo, em Condição para Registro de Eventos adicione uma condição de registro. Essa configuração é importante para evitar algum problema no acesso da variável, que pode ter sido preenchido corretamente ou não, dependendo dos metadados da mensagem e de como isso foi tratado no script.

Preencha os campos como mostra a imagem abaixo:

Prontinho, a configuração do seu contato inteligente está pronta! 😍

Agora vamos criar um relatório personalizado que fará a leitura dos eventos que foram configurados nos passos anteriores.

No menu superior, acesse a guia Análise e no menu à esquerda escolha a opção Relatórios personalizados.

Na tela apresentada clique em Criar relatório, defina um nome para seu relatório e escolha um gráfico de sua preferência através da opção Adicionar Gráfico.

No modal apresentado, defina um título para seu gráfico. No campo Dimensão escolha a opção Eventos Personalizados, no campo Categoria escolha a opção referral e clique em Adicionar.

Agora você já poderá visualizar e analisar os dados no seu relatório.

Lembre-se: só será possível gerar relatórios desse tipo se algum usuário já tiver passado pelo fluxo configurado.

Para mais informações, acesse a discussão sobre o assunto em nossa comunidade ou os vídeos no nosso canal. 😃