WhatsApp — botão e tracking

O plugin oferece 2 funcionalidades de WhatsApp:

1. Tracking automático de qualquer clique em link wa.me ou api.whatsapp.com no site
2. Botão configurável — flutuante na página ou via shortcode [smart2_whatsapp]

Tracking automático

Ativado por padrão. Quando um visitante clica em qualquer link de WhatsApp na página, o plugin:

1. Detecta o clique via listener JS (capture phase) que casa qualquer <a href> contra:

   ^https?:\/\/(?:wa\.me|api\.whatsapp\.com)\b

2. Envia evento pro WordPress via navigator.sendBeacon (com fallback XHR) — não bloqueia a navegação.
3. Dispara em paralelo:
   • Evento Meta CAPI Contact (se habilitado)
   • Evento GA4 whatsapp_click (se habilitado)
   • Se o visitante já submeteu algum form antes (tem cookie smart2_visitor com email/telefone), também registra uma atividade na conversa dele no CRM

O que é registrado

Dado	Origem
whatsapp_destination	Número de destino extraído de wa.me/{phone} ou ?phone={phone}
button_label	Texto do link clicado (até 80 chars)
page_url	URL da página onde o clique aconteceu
click_source	whatsapp_button
utm_*, click_ids	UTMs e click IDs do cookie de atribuição

Visitante anônimo vs identificado

• Anônimo (nunca submeteu form no site): clique é registrado em Meta CAPI/GA4 mas não cria contato no CRM (não tem email/telefone pra associar).
• Identificado: quem já enviou um formulário ganha o cookie smart2_visitor por 30 dias. Desde a 2.12 ele é cifrado e guarda só o número do contato no CRM — e-mail e telefone não ficam mais no navegador. O clique vai pro CRM com esse número e vira uma atividade na conversa do contato.

Para ligar ou desligar: Configurações → app.smart CRM → seção WhatsApp → Rastrear cliques.

Limite de cliques (anti-flood)

Rate limit por IP: 3 cliques a cada 5 segundos. Acima disso, eventos extras são descartados. Evita poluição se um bot ficar disparando cliques.

Botão configurável

O plugin também pode renderizar um botão de WhatsApp no site — útil pra quem não quer instalar um plugin adicional só pra isso.

Modo flutuante

Botão circular fixo num canto da tela, sempre visível.

Configurar:

1. Configurações → app.smart CRM → seção WhatsApp.
2. Marque Botão de WhatsApp e Mostrar flutuante.
3. Preencha:
   • Número — formato livre, o plugin tira o que não é dígito: +55 11 99999-9999 ou 5511999999999
   • Mensagem padrão — já vem escrita na conversa: Olá! Vim pelo site e gostaria de mais informações.
   • Texto do botão
   • Cor — em hexadecimal. #25D366 é o verde oficial do WhatsApp
   • Posição — em qual canto da tela
4. Salve.

O botão aparece em todas as páginas do site automaticamente (renderizado em wp_footer).

Modo shortcode

Pra colocar o botão em locais específicos (dentro de post, página, sidebar):

[smart2_whatsapp]

Usa os defaults configurados em Configurações → app.smart CRM.

Sobrescrevendo atributos caso a caso:

[smart2_whatsapp phone="+5511988887777" message="Olá! Quero saber sobre o plano X" label="Pedir orçamento" color="#0066FF"]

Atributos disponíveis:

Atributo	Default	Descrição
phone	Configurado nas settings	Número WhatsApp (qualquer formato)
message	Configurada nas settings	Mensagem pré-preenchida (URL-encoded)
label	”Fale conosco”	Texto exibido no botão
color	#25D366	Cor de fundo (hex 3 ou 6 caracteres)
style	default	Estilo do botão (default, outline, etc)

CSS / estilização

O botão usa estilos inline (sem CSS externo). Se quiser sobrescrever, adicione CSS específico no seu tema:

.smart2-wa-button {
  /* sobrescrever aparência */
}

A classe é .smart2-wa-button + variação .smart2-wa-{style}.

Combinando botão + tracking

O fluxo recomendado:

1. Botão flutuante ligado no canto inferior direito
2. Tracking ligado (default)
3. Meta CAPI + GA4 conectados (Meta CAPI, GA4)

Resultado: todo clique em WhatsApp dispara evento Contact no Pixel + whatsapp_click no GA4 + (se visitante já é lead) registra atividade no CRM. Você tem atribuição completa de cliques em WhatsApp como conversão.

Validação rápida

Após configurar:

1. Abra seu site em janela anônima (sem extensões/adblock).
2. Abra DevTools → Network (F12 → aba Network).
3. Clique no botão de WhatsApp (ou em qualquer link wa.me).
4. Procure por uma requisição POST pra admin-ajax.php?action=smart2_track_whatsapp — deve retornar 200.

Se aparecer 200 OK, o tracking está funcionando.

Renomear ou bloquear o evento

O clique em WhatsApp aparece na seção Eventos que este site envia como qualquer outra conversão, e leva os mesmos quatro controles: apelido, nome do evento na Meta, mandar ou não para a Meta, e não aceitar.

Dois usos comuns:

Trocar o nome do evento na Meta. Por padrão o clique vai como Contact. Se para o seu negócio ele vale mais como Lead, troque ali — e o nome escolhido vale tanto para o pixel do navegador quanto para o envio por servidor.

Parar de enviar sem desligar o rastreamento. “Não aceitar” barra o evento nos três destinos — CRM, Meta e Analytics — mas ele continua na lista, para você liberar depois.

Veja configuração.

Próximos passos

• Meta CAPI server-side — eventos Lead/Contact
• Google Analytics 4 — generate_lead + whatsapp_click
• UTMs e atribuição — origem do lead