WhaTrack Docs
WhaTrack Docs
Voltar ao siteO que é o WhaTrackComo instalar o pixel do WhaTrackProteja suas campanhas com múltiplos pixelsComo o WhaTrack rastreia cliques no WhatsAppConfigurações do projetoConfigurações do perfilAPI JavaScript (wt.track)

Como instalar o pixel do WhaTrack

Passo a passo simples para adicionar o código de rastreamento do WhaTrack no seu site, landing page ou plataforma de vendas.

Como instalar o pixel do WhaTrack

A instalação é um único pedaço de código que você cola no seu site. Feito isso, o WhaTrack começa a rastrear automaticamente — sem precisar mexer em mais nada.

Passo 1: Copie seu código

No painel WhaTrack, acesse Projetos → selecione seu projeto → aba Pixel.

Você verá um botão Copiar código. Clique nele. O código já vem com o seu ID preenchido automaticamente.

Passo 2: Cole no seu site

O código precisa ser colado dentro da seção <head> do seu site — que é a parte "invisível" do site, onde ficam as configurações da página.

Não sabe o que é isso? Veja as instruções para a sua plataforma:

WordPress

  1. Instale o plugin gratuito WPCode (ou "Insert Headers and Footers").
  2. Vá em WPCode → Header & Footer.
  3. Cole o código na área Header.
  4. Salve.

Hotmart

  1. No painel, acesse Ferramentas → Pixels e Integrações.
  2. Clique em Adicionar pixel personalizado.
  3. Cole o código e salve.

Kiwify

  1. Acesse as configurações da sua página de vendas.
  2. Vá em Scripts adicionais → Header.
  3. Cole o código e salve.

Shopify

  1. Acesse Loja Online → Temas → Editar código.
  2. Abra o arquivo theme.liquid.
  3. Cole o código antes de </head>.
  4. Salve.

Qualquer outro site (HTML puro)

Cole o código antes do </head> em todas as páginas:

<head>
  <!-- seus outros códigos aqui -->

  <script
    src="https://cdn.whatrack.com/wt.js"
    data-project-id="SEU_PROJECT_ID"
    async
  ></script>
</head>

Configurando Rastreamento 100% First-Party (Proxy Reverso)

Por padrão, o pixel é carregado a partir de https://pixel.whatrack.com/wt.js. Embora isso funcione perfeitamente, o uso de um domínio externo (third-party) pode ser bloqueado por adblockers ou ter a persistência de cookies reduzida para apenas 1 a 7 dias por navegadores com políticas estritas de privacidade (como o Safari ITP).

Ao configurar um Proxy Reverso, você faz com que o script e os envios de eventos rodem sob o seu próprio domínio (ex: https://seu-site.com/wt.js), garantindo:

  • Imunidade contra adblockers: As requisições são feitas para o mesmo domínio do site.
  • Cookies duradouros: Identificação persistente por até 2 anos.
  • Melhor atribuição: Dados mais precisos enviados aos pixels do Meta e Google.

Após configurar o proxy no seu servidor, você altera a tag de instalação no seu site para carregar a partir do caminho relativo /wt.js (ou o domínio do seu site):

<script src="/wt.js" data-project-id="SEU_PROJECT_ID" async></script>

Abaixo estão os exemplos de configuração para cada servidor/provedor:

Nginx

Adicione ao bloco server do arquivo de configuração do seu site:

location /wt.js {
  proxy_pass https://pixel.whatrack.com/wt.js;
}
location /v1/events {
  proxy_pass https://pixel.whatrack.com/v1/events;
}

Next.js

No arquivo next.config.ts ou next.config.js:

const nextConfig = {
  rewrites: async () => [
    { source: '/wt.js', destination: 'https://pixel.whatrack.com/wt.js' },
    { source: '/v1/events', destination: 'https://pixel.whatrack.com/v1/events' },
  ]
}

Vercel

No arquivo vercel.json na raiz do seu projeto:

{
  "rewrites": [
    { "source": "/wt.js", "destination": "https://pixel.whatrack.com/wt.js" },
    { "source": "/v1/events", "destination": "https://pixel.whatrack.com/v1/events" }
  ]
}

Apache (.htaccess)

Adicione no início do seu arquivo .htaccess (garanta que o mod_proxy e mod_rewrite estejam ativos no servidor):

<IfModule mod_rewrite.c>
  RewriteEngine On
  RewriteRule ^wt.js$ https://pixel.whatrack.com/wt.js [P,L]
  RewriteRule ^v1/events$ https://pixel.whatrack.com/v1/events [P,L]
</IfModule>

Cloudflare Workers

Crie um Worker e configure a rota para interceptar /wt.js e /v1/events:

export default {
  async fetch(request) {
    const url = new URL(request.url)
    const target = url.pathname === '/wt.js'
      ? 'https://pixel.whatrack.com/wt.js'
      : 'https://pixel.whatrack.com/v1/events'
    return fetch(target, request)
  }
}

Caddy

No seu Caddyfile:

reverse_proxy /wt.js https://pixel.whatrack.com {
  header_up Host {upstream_host}
}
reverse_proxy /v1/events https://pixel.whatrack.com {
  header_up Host {upstream_host}
}

Passo 3: Confirme que funcionou

Volte ao painel WhaTrack → aba Pixel. Em até 5 minutos após visitar a página onde instalou o código, o status muda para Ativo com um indicador verde.

Se ainda aparecer como inativo após 10 minutos, confira se o código foi colado na seção correta (dentro do <head>, não no <body>).

Próximos passos

  • Configurar múltiplos pixels para proteção
  • Entender como o WhaTrack rastreia cliques no WhatsApp

Last updated on

O que é o WhaTrack

Entenda como o WhaTrack conecta seus anúncios do Meta Ads com as vendas fechadas no WhatsApp, e por que isso transforma os resultados das suas campanhas.

Proteja suas campanhas com múltiplos pixels

Como cadastrar pixels de backup no WhaTrack para que suas campanhas do Meta Ads continuem funcionando mesmo se uma conta for bloqueada ou restrita.

On this page

Como instalar o pixel do WhaTrackPasso 1: Copie seu códigoPasso 2: Cole no seu siteWordPressHotmartKiwifyShopifyQualquer outro site (HTML puro)Configurando Rastreamento 100% First-Party (Proxy Reverso)NginxNext.jsVercelApache (.htaccess)Cloudflare WorkersCaddyPasso 3: Confirme que funcionouPróximos passos