Documentação

Como ligar o botão de WhatsApp na página

Atualizado em 19 de novembro de 2026

Como funciona

O número de WhatsApp não fica no HTML da página: quem escolhe o número é a plataforma, na hora do clique. Por isso o número que estiver escrito no botão não importa.

Quando o visitante toca no botão:

  1. O botão leva para o endereço da plataforma /wa/<página>, não direto para o WhatsApp.
  2. A plataforma sorteia um dos números vinculados à página, respeitando a % de cada um.
  3. Gera um código único de 6 letras e números (ex.: QGSLFD) e grava o lead.
  4. Abre o WhatsApp do número sorteado com a mensagem já escrita e o código entre parênteses.

O código na mensagem liga a conversa ao lead: quando o cliente compra, você acha o código em Rastrear e envia a conversão em Disparar.

Passo a passo no painel

São quatro passos, e os três primeiros são feitos só uma vez por página.

  1. Cadastre os números em Números → Cadastrar número. Preencha Identificação (ex.: "WhatsApp Vendas") e Número de telefone com DDD, ex.: (11) 98765-4321.
    • Número brasileiro pode ir sem o 55. Número de outro país precisa do código do país na frente, senão recebe o 55.
  2. Vincule os números à página em Páginas Hospedadas → botão Números no card da página. Marque os números, defina a % de cada um (ou use Distribuir igualmente) e clique em Salvar vínculos.
    • A % funciona como peso: não precisa somar 100. 60 e 40 dá o mesmo resultado que 3 e 2.
    • Se todos ficarem em 0, o sorteio é igual entre eles.
  3. Ajuste a mensagem no botão Mensagem do card e clique em Salvar mensagem.
    • Mantenha a variável {codigo}. Se você tirar, a plataforma acrescenta o código no fim mesmo assim.
    • Também valem {pagina} (o endereço da página) e {oferta} (o título do arquivo), que aparecem certas na pré-visualização e chegam iguais ao WhatsApp.
    • Se você nunca salvar a mensagem, vale o texto que já aparece pré-preenchido na janela.
  4. Marque o botão no HTML da página, como explicado na próxima seção.

Como marcar o botão no HTML

Basta uma das duas formas abaixo. A página pode ter quantos botões quiser: todos são ligados e todos sorteiam o número.

Forma 1: link de WhatsApp (automático). Todo link <a> que aponta para o WhatsApp é ligado sem você fazer nada. O número escrito nele é ignorado.

<a href="https://wa.me/5511999999999">Falar no WhatsApp</a>
<a href="https://api.whatsapp.com/send?phone=5511999999999">Quero comprar</a>

Endereços reconhecidos: wa.me, api.whatsapp.com, whatsapp:// e chat.whatsapp.com. Link para web.whatsapp.com não é reconhecido: troque por wa.me.

Forma 2: marcador (qualquer elemento). Para <button>, <div>, imagem ou link com href="#", coloque um destes marcadores no elemento:

<button data-whatsapp>Falar no WhatsApp</button>
<a href="#" class="btn-verde central-whatsapp">Quero comprar</a>
<div id="central-whatsapp">Chamar agora</div>
Um elemento marcado não pode ter um onclick próprio que abra o WhatsApp. Se tiver, apague o onclick: senão abrem dois WhatsApps, e o do onclick vai sem código.

Botões que aparecem depois do carregamento (após o vídeo, criados por script ou que ganham o link mais tarde) também são ligados sozinhos.

Como testar

Um teste de um minuto confirma que o botão está ligado.

  1. Abra a página pelo Link completo, para você testar (botão Link e parâmetros no card). Sem esse link a página dá 404, por causa do filtro de tráfego.
  2. No computador, passe o mouse sobre o botão: se for um link, o endereço no canto da tela deve ter o seu domínio e /wa/, não wa.me.
  3. Toque no botão: o WhatsApp deve abrir com a sua mensagem e um código de 6 caracteres entre parênteses.
  4. Em Rastrear, o lead aparece com esse mesmo código.

O teste cria um lead de verdade em Rastrear; é esperado, e ele não é enviado ao Meta a menos que você o dispare.

Problemas comuns

Quase todo problema vem de um botão que a plataforma não reconheceu: ele abre o WhatsApp direto, sem código e sem gravar o lead.

O que acontecePor quêComo resolver
Abre o WhatsApp do número escrito no HTML, sem códigoO botão não foi reconhecido: link para web.whatsapp.com, ou o WhatsApp é aberto por script (onclick, window.open)Troque o link por wa.me, ou ponha data-whatsapp no elemento e apague o script
Abrem dois WhatsAppsO elemento marcado tem um onclick próprio que também abre o WhatsAppApague o onclick
O botão está dentro de um quadro de outro serviço (iframe, widget)Conteúdo de outro site não é alteradoUse um botão próprio da página
Aparece "Nenhum número de WhatsApp vinculado a esta página"A página não tem números vinculadosVincule no botão Números do card
O botão dá erro 404Quem clicou chegou sem o código do anúncio (filtro de tráfego)Normal para quem não veio do anúncio; para testar, use o link completo
Cai no número errado de outro paísNúmero sem código do país recebe o 55Cadastre com o código do país na frente

O que fica gravado em cada clique

Cada clique no botão vira um lead em Rastrear, com estes dados:

DadoDe onde vem
Código do leadGerado no clique; é o que vai na mensagem
Número que recebeuO número sorteado entre os vinculados
Campanha, conjunto e anúncio (ID e nome), posicionamento, rede (Facebook ou Instagram)O código de parâmetros colado no anúncio
UTMsO link do anúncio
fbclid, fbc e fbpO clique no anúncio e os cookies do pixel do Meta na página
IP e navegadorO aparelho de quem clicou
Endereço da páginaA página onde o botão foi tocado, sem o código do filtro

No Disparar, ao enviar a compra pelo código do lead, a plataforma manda ao Meta o fbc, o fbp, o IP, o navegador e o endereço da página. São esses dados que deixam o Meta ligar a compra ao anúncio.

O telefone do cliente não é capturado: quem envia a mensagem é ele, e ela chega direto no WhatsApp. Os dados de campanha só aparecem se o anúncio tiver o código de parâmetros (botão Link e parâmetros no card).