Instalar o botão de WhatsApp no seu site

O botão de WhatsApp do WiseData Tools é um pequeno código que você cola no seu site. Ele exibe o botão flutuante no canto da tela e, quando o visitante clica e preenche os dados, captura o lead (nome, e-mail e telefone) junto com os parâmetros de campanha (UTMs, gclid, fbclid, entre outros) antes de encaminhar a pessoa para a sua conversa no WhatsApp. Tudo isso aparece na sua lista de leads e, se você configurar, também é enviado em tempo real para o seu webhook.

A instalação leva menos de 2 minutos. O ponto mais importante — e o que mais gera dúvida — é o domínio: o botão só funciona nos endereços que você liberar. Este artigo explica os dois passos (instalar o código e cadastrar o domínio) e mostra como evitar o erro mais comum.

Antes de começar: crie o botão

Na página Botão de WhatsApp, clique em Adicionar Botão e preencha o formulário:

• Nome — um rótulo para você identificar o botão (ex: "Site XPTO").

• URL do site — o domínio onde o botão vai aparecer. Digite sem https:// e sem www. (ex: exemplo.com). Este é o campo que autoriza o botão a funcionar — leia a seção "Por que o botão não funciona" abaixo.

• WhatsApp (DDI + DDD) — o número que vai receber as conversas.

• Idioma — o idioma dos textos exibidos no botão.

• Informações a coletar — Nome e E-mail são opcionais; o Telefone é sempre coletado.

• URL do webhook (opcional) — endereço para onde os leads serão enviados em tempo real.

• Domínios adicionais (opcional) — outros domínios ou subdomínios onde o mesmo botão deve aparecer (ex: blog.seusite.com.br).

• Mensagem padrão (opcional) — texto que já vem preenchido na conversa do WhatsApp.

Clique em Adicionar para salvar. O botão aparecerá na sua lista.

Passo 1 — Copie o código de instalação

Na lista de botões, clique em Obter URL do botão (ou Ver código). Uma janela abrirá com um trecho parecido com este:

<script type="text/javascript" src="..." base_URL="..." uuid_cli="..." uuid="..."></script>

Esse código já vem personalizado com o identificador do seu botão. Clique em Copiar código — não altere nada, apenas copie e cole.

Passo 2 — Cole antes do fechamento do </body>

Abra o HTML do seu site e cole o código imediatamente antes da tag </body>. É o lugar onde os scripts de rastreamento devem ficar para carregar corretamente.

• Para exibir o botão em todo o site, cole o código uma única vez no arquivo/template principal (geralmente o rodapé).

• Para exibir apenas em páginas específicas, cole o código individualmente em cada uma delas.

Dicas por plataforma

• WordPress — cole no rodapé pelo tema (footer.php) ou use um plugin como "Insert Headers and Footers" / WPCode.

• Google Tag Manager — crie uma tag de HTML personalizado com o código e dispare em "All Pages".

• Shopify — em Temas → Editar código, cole antes de </body> no arquivo theme.liquid.

• Wix / Squarespace — use a opção de inserir código personalizado no rodapé (Custom Code / Code Injection).

• Site em HTML puro — cole diretamente antes de </body> na(s) página(s) desejada(s).

Passo 3 — Salve, publique e teste

Salve as alterações, publique o site e recarregue a página no domínio real (não na tela de edição do construtor). O botão aparecerá no canto inferior. Preencha um lead de teste e confira se ele chega na sua lista de leads.

⚠️ Por que o botão pode não funcionar (leia com atenção)

Por segurança, o botão é vinculado ao domínio que você cadastrou. Quando alguém preenche o botão, o WiseData Tools compara o endereço da página com os domínios liberados. Se o domínio não bater exatamente, o lead não é capturado — mesmo que o botão apareça na tela.

1. O domínio precisa estar cadastrado corretamente

O endereço da página onde o botão está precisa ser exatamente o que você informou no campo URL do site (ou em Domínios adicionais). Regras práticas:

• Cadastre o domínio sem https:// e sem www. — ex: exemplo.com. As versões www.exemplo.com e https://exemplo.com são reconhecidas automaticamente.

• Subdomínios contam como domínios diferentes. Se você cadastrou exemplo.com, o botão não funcionará em blog.exemplo.com ou loja.exemplo.com. Para esses casos, adicione cada um em Domínios adicionais.

• Digite apenas o domínio, sem caminho de página. Use exemplo.com, não exemplo.com/contato.

2. URLs de preview de page builders NÃO funcionam

Este é o erro mais comum. Muitos construtores de site (page builders) oferecem um endereço temporário de pré-visualização antes de você conectar o seu domínio próprio. Como esse endereço não é o domínio que você cadastrou, o botão não captura leads nele. Exemplos de endereços de preview que não vão funcionar:

• Webflow — seu-site.webflow.io

• Wix — usuario.wixsite.com/seu-site

• Framer — seu-site.framer.website

• Vercel / Netlify — seu-site.vercel.app, seu-site.netlify.app

• WordPress — ambientes de staging ou seu-site.wordpress.com

• Qualquer tela de edição/pré-visualização do próprio construtor.

O que fazer: teste sempre no domínio final publicado (o seu domínio próprio, ex: exemplo.com). Se você realmente precisa que o botão funcione também num endereço de preview, cadastre esse endereço exato em Domínios adicionais — mas o recomendado é usar o domínio de produção.

3. Outras causas comuns

• Botão inativo — verifique se o status do botão está "Ativo" na sua lista.

• Página na lista de exclusão — em "Configurações de exibição" você pode definir URLs onde o botão não deve aparecer. Confira se a página de teste não está nessa lista.

• Cache — depois de publicar, limpe o cache do site (e do navegador) e recarregue a página.

• Código incompleto — confirme que o trecho foi colado inteiro, sem cortes, e antes do </body>.

Resumindo: crie o botão informando o domínio correto (sem www. e sem https://), copie o código, cole antes do </body> e teste no domínio real publicado. O botão só captura leads nos domínios que você liberar — endereços de preview de page builders (Webflow, Wix, Framer, Vercel etc.) não funcionam. Para subdomínios ou domínios extras, use o campo Domínios adicionais.