> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xtracky.com/llms.txt
> Use this file to discover all available pages before exploring further.
# WhatsApp
> Rastreie cliques de anúncios que direcionam pro WhatsApp — atribua conversas ao criativo que gerou o clique.
Muitos funis do mercado brasileiro terminam num link `wa.me/…?text=…` — o cliente clica no anúncio, cai no WhatsApp, conversa com o vendedor, fecha a venda. Sem tracking, você **perde a atribuição** — o painel do TikTok não sabe que aquele clique virou venda.
O script `whatsapp.js` resolve isso propagando o `LeadId` no texto pré-preenchido da mensagem.
## Instalação
Cole no `` da landing/página que tem o botão WhatsApp:
```html theme={null}
```
## Como funciona
Ao carregar a página, o script:
1. Gera (ou recupera) o `LeadId` — igual ao V2
2. Encontra todos os links `` da página
3. Anexa o `LeadId` no parâmetro `text=` da URL
**Antes** (o que você escreve no HTML):
```html theme={null}
Falar no WhatsApp
```
**Depois** (o que o cliente vê ao clicar):
```
https://wa.me/5511999999999?text=Olá,%20quero%20saber%20mais%20%5Bref:TT-1763007625226-yn4xita3qylwh%5D
```
O `[ref:XXXX]` é o marcador que sua equipe de vendas (ou seu bot) usa pra registrar a atribuição de volta na xTracky.
## Registrando a venda
Quando o cliente fechar a venda pelo WhatsApp, seu backend (ou operador) chama a API:
```bash theme={null}
curl -X POST https://api.xtracky.com/api/integrations/api \
-H "Content-Type: application/json" \
-d '{
"orderId": "WPP_ORDER_456",
"amount": 49700,
"status": "paid",
"utm_source": "TT-1763007625226-yn4xita3qylwh",
"leadName": "Cliente WhatsApp",
"leadPhone": "+5511988887777"
}'
```
Basta extrair o `LeadId` do marcador `[ref:…]` que veio na primeira mensagem do cliente.
Se você usa um CRM tipo Chatwoot ou um bot, escreva uma regra que capture o `[ref:...]` da primeira mensagem e grave como atributo do contato. Assim, quando a venda for fechada, é só ler esse atributo.
## Alternativa sem WhatsApp Web API
Se você não tem backend/bot e mesmo assim quer atribuição, use um encurtador tipo Bit.ly ou seu próprio redirecionador que registra o clique. Nesse caso, chame diretamente:
```javascript theme={null}
document.querySelector('a[href*="wa.me"]').addEventListener('click', () => {
fetch('https://api.xtracky.com/api/integrations/api', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
orderId: `WPP_CLICK_${Date.now()}`,
amount: 0,
status: 'initiate_checkout',
utm_source: window.xtracky?.getLeadId(),
}),
});
});
```