# Origem do lead: como é definida, canal e o que sai nas planilhas

A **origem do lead** responde "de onde veio este contato". Ela é gravada **uma única vez** (primeiro toque) e nunca é sobrescrita automaticamente; toques seguintes ficam como **último toque**. Este artigo explica cada forma de atribuição e o que aparece nas planilhas.

## Como a origem é definida (ordem de prioridade)

1. **Manual** — você escolhe a origem no painel do contato ou pela API.
2. **Anúncio Meta** — conversa iniciada por anúncio de clique para WhatsApp: origem *Meta Ads*.
3. **UTM / clique em anúncio** — visita com `utm_source` ou identificador de clique (Google, Meta, Microsoft, TikTok, X) que virou contato por formulário, link rastreado ou widget. Ex.: `google` + `cpc` → **Google Ads**; `facebook` + `paid_social` → **Facebook / Paid Social**.
4. **Acionador ou fluxo** — ação "Definir origem do lead" configurada por você.
5. **Canal da caixa** — contato que chegou direto pelo WhatsApp, Instagram, e-mail ou site sem nenhum sinal acima recebe a origem padrão do canal (ex.: *WhatsApp V2*, *Instagram*).
6. **Preenchimento retroativo** — ferramenta em Configurações › Marketing › Origem do Lead para contatos antigos.

No painel do contato você vê a origem, **Definida por** (manual, canal, UTM, anúncio, acionador, fluxo, preenchimento) e o **Último toque** quando difere do primeiro.

## Canal

Além do nome da origem, cada lead recebe um **canal** padronizado: Busca paga, Social pago, Busca orgânica, Social orgânico, E-mail, SMS, WhatsApp, Referência, Afiliado, Display, Vídeo, Direto. Ele é calculado a partir da origem/meio e dos identificadores de clique, e aparece na aba **Origens** do Dashboard e nas planilhas.

## O que sai na planilha do Dashboard (Exportar Relatório)

| Coluna | Significado |
| --- | --- |
| **Origem** | Origem do lead (manual ou automática). Sem origem cadastrada: anúncio Meta → UTM → campanha → padrão do canal → *Direto*. |
| **Detalhe da Origem** | Anúncio, campanha/conteúdo/termo da UTM ou nome da caixa. |
| **Canal** | Canal padronizado (Busca paga, WhatsApp, Direto...). |
| **Origem Definida Por** | Manual, Canal, UTM, Anúncio, Acionador, Fluxo, Importação, Preenchimento. |

> Se a planilha mostra **Direto** para muitos leads, é porque esses contatos não têm origem nem sinal de campanha. Rode o **Preencher origem por canal** e configure o site conforme o guia *Como ligar o site aos seus leads*.

## Construtor de UTM e links rastreados

Em **Configurações › Marketing › Links e UTM**:

- **Link de URL**: destino + UTMs → URL curta `/l/…` que redireciona com as UTMs e um identificador de clique. Use em anúncios, bio e QR.
- **Link de WhatsApp**: número + mensagem → URL curta que leva ao WhatsApp com um código; a primeira mensagem liga o clique ao contato.
- **Catálogo**: valores já usados aparecem como sugestão; remova os errados clicando no ×.
- **QR Code**: cada link tem QR para materiais impressos.

## Dicas

- Um lead só tem **uma** origem (primeiro toque). Para mudar, edite manualmente.
- Origens inativas continuam contando leads antigos; o diagnóstico avisa se ainda recebem leads novos.
- Conversões (LeadQualified/Purchase) voltam para Meta e Google uma única vez por oportunidade; veja o card **Conversões e receita** em Geral.