> ## Documentation Index
> Fetch the complete documentation index at: https://docs.metrito.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Rastreamento no WhatsApp

> Conecte suas conversas do WhatsApp ao container para atribuir vendas e enviar conversões aos pixels.

## Por que rastrear o WhatsApp

No Brasil, boa parte das vendas passa pelo WhatsApp: o cliente vê o anúncio, clica, conversa e só então compra. Se o WhatsApp ficar de fora do rastreamento, esse tráfego vira "venda sem origem" — e o anúncio que trouxe o cliente não recebe o crédito.

O Metrito conecta suas **conexões de WhatsApp** ao container. A partir daí, cada conversa entra na mesma [jornada](/tracking/overview) das sessões do site, e as conversões são enviadas de volta aos **pixels da Meta**, otimizando suas campanhas.

<Note>
  O rastreamento de WhatsApp do V3 **não usa mais** o antigo parâmetro `wa_session` na URL. A ligação é feita conectando a instância do WhatsApp ao container, como descrito abaixo.
</Note>

## Conecte seu WhatsApp

Na seção **WhatsApp** do tracking você encontra o card **Conectar WhatsApp**:

> *Selecione as instâncias do WhatsApp conectadas a este domínio para enviar dados de interação e conversão para os Pixels.*

Cada linha é uma instância (número) já conectada. Para vincular uma ao container, ligue o botão ao lado dela. Para conectar um número novo:

<Steps>
  <Step title="Clique em Nova conexão WhatsApp">
    O botão **Nova conexão WhatsApp** abre o fluxo de conexão.
  </Step>

  <Step title="Dê um nome à conexão">
    Use um nome que identifique o número (ex.: "Vendas SP").
  </Step>

  <Step title="Leia o QR Code">
    Escaneie o QR Code com o WhatsApp do aparelho, como faria no WhatsApp Web. Pronto — o número está conectado.
  </Step>
</Steps>

<Note>
  Use a busca **Buscar por 'nome' ou 'número'** para achar uma instância. Se não houver nenhuma, a tela mostra **"Nenhuma conexão WhatsApp no momento."** A conexão também pode ser feita pela tela de [integrações de WhatsApp](/integracoes/whatsapp).
</Note>

## As duas formas de rastrear o WhatsApp

Existem dois caminhos para levar uma conversa de WhatsApp até a atribuição. Eles podem (e costumam) conviver.

### 1. Campanha nativa de mensagem (CTWA)

Quando você roda **campanhas de mensagem nativas** — com o número vinculado na BM e o anúncio levando direto para o WhatsApp — o clique chega com o **CTWA** (*Click to WhatsApp*). Aquela primeira mensagem traz a "miniatura" do anúncio.

Nesse momento, o Metrito **dispara o evento `Contact` automaticamente**, cria o lead, inicia a sessão e passa a capturar os eventos seguintes da conversa.

<Warning>
  **O CTWA pode se perder.** Se o cliente desativou o rastreamento do WhatsApp no aparelho dele (uma opção do iPhone, por exemplo), o CTWA não chega — e isso é **impossível de corrigir**, porque a campanha é nativa e o usuário sai do Instagram/Facebook direto para o WhatsApp. Nesses casos, alguns disparos de `Contact` podem ser perdidos.
</Warning>

### 2. Link de redirect (Smart WhatsApp)

A forma mais robusta é usar um **link de redirect do tipo Smart WhatsApp**. Em vez de mandar o tráfego direto, o anúncio leva a um link do Metrito que redireciona para o WhatsApp já com tudo rastreado.

Como funciona: no clique, o Metrito captura os **UTMs e parâmetros** e os embute na **mensagem padrão** que vai para o WhatsApp. Quando o cliente envia a mensagem, o sistema recupera esses dados e atribui a conversa à campanha correta.

<Warning>
  A única forma de perder a atribuição aqui é se o cliente **apagar toda a mensagem padrão** antes de enviar. Por isso a mensagem padrão é obrigatória nesse tipo de link.
</Warning>

**Vantagens do redirect:** como o redirecionamento passa pela web, ele também captura **IP, navegador e geolocalização** — dados que a campanha nativa não traz.

<Card title="Criar um link Smart WhatsApp" icon="link" href="/tracking/links-de-redirect">
  Veja como criar o link, escolher a estratégia de roteamento e distribuir entre vários números.
</Card>

## Por que os UTMs são decisivos

A tela de [Campanhas](/analise/campanhas) usa **UTMs** para atribuir o resultado. Se uma conversa perde o CTWA ou chega sem UTM, ela **não aparece como venda atribuída** ali — mesmo que a venda tenha acontecido. É por isso que o link de redirect, que garante os UTMs na mensagem, é o caminho mais confiável.

## Disparar eventos a partir de mensagens

Você pode transformar **palavras ou frases** de uma conversa em um evento de conversão — por exemplo, disparar uma compra quando o operador envia "Pedido confirmado".

Isso é configurado na seção de [Eventos](/tracking/eventos), com o acionador **Mensagem no WhatsApp** e os **Termos de acionamento**.

<Warning>
  Os termos precisam **bater exatamente** com o que foi enviado — incluindo acentos, espaços e maiúsculas/minúsculas.
</Warning>

## Boas práticas

1. **Prefira o link de redirect** — garante UTMs, `Contact` e dados de web mesmo quando o CTWA falha.
2. **Mantenha a mensagem padrão** nos links Smart WhatsApp — apagá-la quebra a atribuição.
3. **Conecte o número certo ao container certo** — cada container é um [projeto](/conceitos/projetos); não misture marcas.
4. **Use termos de acionamento específicos** — evita disparar conversão em qualquer "oi".

## Próximos passos

<CardGroup cols={2}>
  <Card title="Links de redirect" icon="link" href="/tracking/links-de-redirect">
    Distribua leads entre números e garanta a atribuição.
  </Card>

  <Card title="Pixels" icon="square-code" href="/tracking/pixels">
    Entenda quando usar pixel Web e quando usar pixel de mensagem.
  </Card>
</CardGroup>