Este artigo também está disponível em:

Rastreando a Conversão - N8N

Rastreando suas Vendas com N8N

Este artigo explica como configurar o rastreamento de conversões do VTurb e integrar essa funcionalidade com a plataforma de automação N8N.

Este artigo é para quem utiliza uma plataforma de vendas sem integração direta com o VTurb. Se sua plataforma já estiver disponível na nossa lista de integrações, use o artigo específico dela — a configuração é mais simples e você não precisa do N8N.

O fluxo da integração funciona da seguinte forma: VTurb → Checkout → Plataforma de vendas → N8N → VTurb. O VTurb gera um parâmetro de rastreamento, sua plataforma de vendas mantém esse parâmetro durante a compra e o N8N envia os dados da venda de volta para o VTurb.

Se preferir, você pode acompanhar o passo a passo através do vídeo abaixo:

Configure o rastreamento de conversões no VTurb

Acesse Conversões → Rastreamento de Conversões e procure pela sua plataforma de vendas. Caso ela ainda não esteja cadastrada, clique em Adicionar plataforma.

Informe o Nome da plataforma e selecione N8N como ferramenta de integração. Em seguida, clique em Adicionar plataforma.

Tela de adição da plataforma

Na etapa Parâmetros, selecione um parâmetro de rastreamento que não esteja sendo utilizado nas suas fontes de tráfego.

Seleção do parâmetro de rastreamento

Se você escolher um parâmetro que já esteja sendo usado nos seus anúncios, o VTurb poderá sobrescrever esse valor.

Depois, clique no campo URL do Webhook para copiar a URL gerada pelo VTurb.

URL do Webhook

Importe o template no N8N

Para facilitar a configuração, disponibilizamos um workflow pronto com os módulos necessários. Baixe o template do fluxo.

No N8N, crie um novo workflow, clique no menu de três pontos ao lado do nome do workflow e acesse Import → From file. Selecione o arquivo que você acabou de baixar.

Importando o template no N8N

O workflow importado já possui os dois módulos necessários para realizar a integração.

Configure o webhook da sua plataforma de vendas

Abra o módulo Enviar conversão para o VTurb e, no campo URL, cole a URL do webhook que você copiou no VTurb.

Módulo Enviar conversão para o VTurb

No canto superior direito, clique em Publish para ativar o workflow. Depois, abra o módulo Webhook da plataforma de vendas e copie a Production URL.

Production URL do webhook

Utilize sempre a Production URL. A Test URL funciona apenas enquanto o workflow está sendo executado em modo de teste.

Acesse as configurações de webhook da sua plataforma de vendas, cole a Production URL do N8N e selecione somente o evento de compra aprovada. Isso evita que pedidos pendentes, cancelamentos ou reembolsos sejam contabilizados como conversões. Depois, salve a configuração.

Mapeie os dados da venda no N8N

Agora vamos verificar se a plataforma está enviando corretamente os dados da venda para o N8N.

Faça uma compra de teste passando pela sua própria página: dê play no vídeo, clique no botão de compra e finalize a compra. Quando o checkout abrir, confira a barra de endereço — o parâmetro de rastreamento escolhido anteriormente deve aparecer na URL com um valor iniciado por v3_.

Se o parâmetro não aparecer no checkout, pare por aqui: esse ajuste precisa ser feito na sua página, e continuar a configuração do N8N não vai resolver o problema. Entre em contato com nosso time pelo Chat para receber ajuda.

Depois que a compra de teste for enviada, no N8N acesse Executions e abra a execução correspondente à compra. No lado esquerdo, localize os dados enviados pela sua plataforma de vendas.

Abra o módulo Enviar conversão para o VTurb e substitua os campos indicados como SUBSTITUIR pelos dados recebidos no webhook.

Dados recebidos e campos do VTurb

No GIF abaixo, mostramos como localizar os dados recebidos pelo webhook e inseri-los nos respectivos campos do JSON:

Preenchendo as variáveis no módulo JSON do N8N

Cada plataforma de vendas utiliza nomes diferentes para os mesmos dados, então o mapeamento deve ser feito com base na execução da sua própria compra de teste:

Campo	O que informar
`conversion_key`	O parâmetro de rastreamento escolhido anteriormente. O valor deve começar com `v3_`.
`order_amount_cents`	Valor da venda em centavos. Exemplo: se a plataforma enviar `97.00`, informe `9700`.
`currency`	Moeda da venda utilizando o código de três letras, como `BRL`, `USD` ou `EUR`.
`product_name`	Nome do produto vendido.
`order_created_at`	Data e hora em que o pagamento foi aprovado.

Os campos category e order_ip já vêm preenchidos no template e não precisam ser alterados.

Cada plataforma de pagamento possui variáveis com nomes diferentes. Não siga um exemplo pronto de outra plataforma — use os dados recebidos na execução da sua própria compra de teste para identificar os campos corretos.

Depois de preencher os campos, salve o workflow, reexecute a execução de teste e verifique se a conversão foi enviada corretamente para o VTurb.

Se travar nessa etapa, copie os dados exibidos na execução do N8N e fale com nosso time pelo Chat — podemos ajudar a identificar quais campos devem ser utilizados.

Integração concluída ✅

Sua integração com o N8N foi configurada com sucesso. A partir de agora, as conversões das suas vendas poderão ser contabilizadas dentro do VTurb. No painel de rastreamento de conversões, o status da integração deverá mudar de Aguardando 1ª venda para Integrado.

Caso utilize pop-ups na sua página, pode ser necessária uma configuração adicional para garantir que os parâmetros de rastreamento sejam enviados corretamente. Entre em contato com nosso time pelo Chat para receber essa orientação.

Caso tenha dúvidas ou precise de suporte durante o processo, nossa equipe está à disposição para ajudar.

Atualizado em: 17/09/2026

Este artigo foi útil?

Obrigado!