O MEDSAC suporta **duas formas independentes** de capturar a origem de um lead. Esta página explica quando usar cada uma.

## Meta CTWA (Click-to-WhatsApp Ads)

**O que é:** um anúncio do Facebook ou Instagram com CTA "Enviar mensagem". Quando o usuário clica, a Meta abre o WhatsApp e envia, junto com a primeira mensagem, um objeto `referral` contendo metadados do anúncio (headline, body, mídia, source_id, ctwa_clid).

**Como aparece no MEDSAC:** card **azul "Meta Ads"** no topo da conversa, com headline e body do anúncio.

**Vantagens:**

* Atribuição vem direto da Meta — você não precisa configurar UTMs.

* O headline e a mídia do anúncio aparecem no card (ajuda o atendente a contextualizar).

* Sem dependência de a mensagem do paciente conter algum código.

**Limitações:**

* **Só funciona pra anúncios pagos da Meta** (Facebook + Instagram).

* Atribuição **não é determinística**: depende do que a Meta entrega.

* Não funciona pra anúncios orgânicos, Google Ads, QR Code, TV, etc.

* Você não controla os UTMs — usa os campos `source_id`, `source_type` da Meta.

## Link Rastreável MEDSAC

**O que é:** um link `/r/MSAC-...` criado no painel MEDSAC. Você divulga onde quiser, e cada clique gera um token único que volta na primeira mensagem do paciente.

**Como aparece no MEDSAC:** card **verde "MEDSAC / Lead via link rastreável"** no topo da conversa.

**Vantagens:**

* Funciona em **qualquer canal**: bio do Instagram, Google Ads, QR Code, TV, e-mail, parcerias.

* Atribuição é **determinística** (token único por clique).

* Você controla os UTMs (source, medium, campaign, content, term).

* Captura `gclid` e `fbclid` automaticamente.

* Permite separar performance por criativo, ponto físico, parceria.

**Limitações:**

* Depende do paciente **não apagar o `MSAC-...` da mensagem** antes de enviar (raro mas possível).

* Funciona só na **primeira mensagem incoming** da conversa.

* Janela de match de 7 dias entre clique e mensagem.

## Comparativo direto

| Critério                   | Meta CTWA                       | Link MEDSAC                               |
| -------------------------- | ------------------------------- | ----------------------------------------- |
| Canais suportados          | Apenas Meta Ads                 | Qualquer canal                            |
| Configuração de UTMs       | Não (vem da Meta)               | Sim, totalmente controlado                |
| Headline/mídia do anúncio  | Sim, vem direto                 | Não (você define o nome)                  |
| Atribuição determinística  | Não                             | Sim (token único)                         |
| Funciona com Google Ads    | Não                             | Sim                                       |
| Funciona offline (QR, TV)  | Não                             | Sim                                       |
| Setup                      | Zero (basta criar anúncio Meta) | Criar campanha no painel                  |
| Risco de perder atribuição | Baixo                           | Baixo (se template tem `{{click_token}}`) |

## Devo usar os dois juntos?

**Sim.** Os dois sistemas convivem e se complementam:

* Para **anúncios pagos da Meta**, o CTWA já cobre — você nem precisa criar campanha MEDSAC para esses.

* Para **todo o resto** (Google, Instagram orgânico, QR, parcerias), o link MEDSAC é necessário.

Se um paciente clicar num anúncio Meta E num link MEDSAC, ambos os cards aparecem na conversa (MEDSAC tem prioridade visual no topo).

## Resumo prático

> **Regra de ouro:** se o canal é Meta Ads, deixe o CTWA fazer o trabalho. Para todo o resto, crie um link rastreável MEDSAC.