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

# Leads e origem

> Como o Metricaas descobre de onde a pessoa veio, e o que isso significa no payload.

## O modelo de atribuição, em uma frase

O **clique** é registrado quando acontece. O **lead** nasce quando a pessoa manda
mensagem no WhatsApp — e é nesse momento que a origem é resolvida, casando a
mensagem com o clique ou lendo o anúncio embutido na conversa.

Ou seja: existe clique sem lead (quem clicou e não falou), e o lead sempre chega
depois do clique. Se você cruzar contagem de cliques com contagem de leads, os
números não vão bater — e isso é o comportamento correto.

## `origin`

| Valor     | O que significa                                                                      |
| --------- | ------------------------------------------------------------------------------------ |
| `ctwa`    | Veio de um anúncio *Click-to-WhatsApp*. Traz campanha, conjunto, anúncio e criativo. |
| `link`    | Veio de um link traqueado do Metricaas.                                              |
| `organic` | Chegou sem rastro identificável.                                                     |

Só `ctwa` e `link` preenchem o objeto `ad`:

```json theme={null}
{
  "origin": "ctwa",
  "ad": {
    "campaign": "[VENDAS] [BOOTCAMP] [03/08]",
    "adset": "[ABERTO] [ADV+]",
    "ad": "CT-016 (2)"
  }
}
```

Para `organic`, os três campos vêm `null`.

## `channel`

`whatsapp` ou `instagram`. Repare que **o escopo do seu token pode filtrar por
canal** — ver [Autenticação](/autenticacao). Um token restrito a WhatsApp devolve
`200` com a lista sem os leads do Instagram, sem nenhum aviso.

## Telefone

Vem como está no provedor, em E.164 quando disponível (`+5547984310462`).

<Tip>
  Ao casar com sua base, normalize por **DDD + os 8 últimos dígitos**. O nono dígito
  dos celulares brasileiros aparece e some conforme o provedor, e comparar o número
  inteiro perde uma boa parte dos casos.
</Tip>

Alguns leads têm identificador de plataforma no lugar do telefone (Instagram, ou
contatos que o WhatsApp entrega como `lid:`). Trate `phone` como opaco: use-o para
casar, não para discar.

## Nome

É o nome do **perfil**, escrito pela própria pessoa. Vem com emoji, apelido, nome
de empresa, ou vazio.

<Warning>
  Nunca case comprador com lead por nome. Num cruzamento real, "Rodrigo Silva" casou
  com "Rodrigo Tomas da Silva Rizzo Hahn" — duas pessoas diferentes, e a venda foi
  parar no lead errado. Use telefone; na falta dele, e-mail.
</Warning>