Campanhas e Links Rastreáveis

Visão geral: Campanhas e Links Rastreáveis

O módulo Campanhas do MEDSAC permite criar links de WhatsApp rastreáveis para cada origem (Instagram, Google Ads, TV, QR Code, parcerias, e-mail, etc.) e medir, na conversa e em relatórios, de onde cada paciente veio. Quando usar - Você anuncia em mídia paga e quer saber qual criativo trouxe lead. - Tem link na bio do Instagram, Google Ads ou QR Code impresso. - Quer separar leads orgânicos dos pagos. - Precisa medir taxa de conversão por origem. Duas formas de captura O MEDSAC suporta duas origens distintas de leads rastreáveis, e elas convivem sem conflito: | Origem | Como funciona | Onde aparece | | --------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------- | | Meta Click-to-WhatsApp (CTWA) | Anúncio no Facebook/Instagram com CTA "Enviar mensagem" — a Meta entrega os metadados do anúncio (headline, mídia, source_id) no webhook do WhatsApp Cloud API. | Card azul "Meta Ads" no topo da conversa. | | Link Rastreável MEDSAC | Você cria um link /r/MSAC-... no painel, distribui em qualquer canal (Instagram bio, Google Ads, QR, TV) e cada clique gera um token único que volta na primeira mensagem do paciente. | Card verde "MEDSAC / Lead via link rastreável" no topo da conversa. | Importante: os dois cards podem aparecer juntos na mesma conversa (lead veio por Meta Ads e clicou num link MEDSAC). O card MEDSAC tem prioridade visual (aparece em cima). O que você consegue medir - Total de leads por campanha, por origem (UTM source), por inbox, por status. - Taxa de conversão (leads que viraram conversa real vs. cliques perdidos). - Origem específica (Google Ads, Meta, Instagram Bio, etc.). - Histórico de cliques de cada campanha (com UTMs, hora, sem expor IP). Próximos passos - Como criar uma campanha rastreável — passo a passo no painel. - Entendendo a URL pública e a mensagem pré-preenchida — como o {{click_token}} funciona. - Casos de uso por canal — Instagram bio, Google Ads, QR Code, TV.

Como criar uma campanha rastreável (passo a passo)

Pré-requisitos - Recurso Campanhas MEDSAC habilitado na sua conta (sob solicitação à equipe MEDSAC). - Pelo menos uma caixa de entrada do WhatsApp configurada. - Permissão de administrador (apenas administradores criam campanhas). Passo 1 — Abrir o painel No menu lateral, vá em Campanhas → Links rastreáveis. Se você não vir essa opção, peça à equipe MEDSAC para liberar o recurso na sua conta. Passo 2 — Clicar em "Nova campanha" Use o botão + Nova campanha no canto superior direito da lista. Passo 3 — Preencher o formulário | Campo | Obrigatório | Para que serve | | --------------------------- | ----------- | ----------------------------------------------------------------------------------------------------------------------------- | | Nome | Sim | Identifica internamente. Ex: "Fale Conosco - Iturama - Insta", "Google Ads - Check-up Maio". | | Caixa de entrada | Sim | A inbox do WhatsApp que vai receber as conversas dessa campanha. | | Status | Sim | Ativa, Inativa ou Arquivada. Apenas Ativa redireciona cliques. | | Telefone WhatsApp | Sim | Número que aparece no destino (wa.me/). Aceita E.164 ou local — será normalizado. | | Mensagem pré-preenchida | Sim | Texto que aparece na caixa do WhatsApp do paciente. Deve conter {{click_token}} (será substituído automaticamente). | | Fonte (utm_source) | Opcional | Ex: instagram, google, tv, qrcode. Aparece no card e nos relatórios. | | Meio (utm_medium) | Opcional | Ex: cpc, bio, offline, social. | | Campanha (utm_campaign) | Opcional | Ex: checkup-maio, dia-das-maes. | | Conteúdo (utm_content) | Opcional | Variação do criativo (video-1, imagem-a). | | Termo (utm_term) | Opcional | Palavra-chave (mais comum em Google Ads). | | Expira em | Opcional | Após a data, o link retorna 404. Útil para campanhas sazonais. | Passo 4 — Salvar e copiar o link público Após salvar, a campanha gera uma URL como: https://app.medsac.com.br/r/MSAC-Zaryd4SazjKhrf8mrKoLeNpo Use o botão Copiar link público na lista para colar onde for divulgar (bio do Instagram, anúncio do Google, QR Code, e-mail, etc.). Pré-visualização O formulário mostra como ficará a mensagem que o paciente verá no WhatsApp, com MSAC-EXEMPLO123ABC no lugar do {{click_token}} real. Editar e arquivar Use os botões Editar e Arquivar na lista. Campanhas arquivadas continuam respondendo a cliques antigos (links já divulgados) mas não aceitam novos. Para matar um link de vez, use Status: Inativa ou defina Expira em.

Entendendo a URL pública e o {{click_token}}

A URL pública Toda campanha tem uma URL no formato: https://app.medsac.com.br/r/MSAC-{campaign_token} Esse campaign_token identifica a campanha. Tem 24 caracteres aleatórios, é gerado automaticamente na criação e nunca muda. É o que você divulga. O que acontece quando o paciente clica 1. O paciente acessa /r/MSAC-.... 2. O MEDSAC registra um clique, capturando: - UTM (source, medium, campaign, content, term) da URL OU defaults da campanha - gclid (Google Ads) e fbclid (Meta) se presentes - User Agent, referer, IP hasheado (LGPD-safe) - Timestamp - Um click_token único de 24 caracteres 3. Redireciona o navegador para wa.me/<telefone>?text=<mensagem_pre_preenchida_com_token>. 4. O WhatsApp do paciente abre com a mensagem pronta. 5. Quando o paciente envia, a mensagem chega no MEDSAC. 6. O MEDSAC extrai o MSAC-... do texto e vincula o clique àquela conversa. 7. O card MEDSAC aparece no topo da conversa. Por que dois tokens? | Token | O que identifica | Vida | Aparece em | | ---------------- | --------------------------------- | -------------------------- | ----------------------- | | campaign_token | A campanha (vida longa) | Da criação ao arquivamento | URL pública | | click_token | Um clique específico (vida curta) | Cada clique gera um novo | Mensagem pré-preenchida | Por que não usar um só? Se duas pessoas clicassem no mesmo link antes da primeira mandar mensagem, com um token único seria impossível saber qual clique veio de cada uma. Com click_token distinto por clique, a atribuição é determinística. O placeholder {{click_token}} Sua mensagem pré-preenchida deve conter {{click_token}} em algum lugar. Exemplo: Olá! Tudo bem? Vim pelo Instagram. Código: {{click_token}} No momento do clique, o {{click_token}} é substituído pelo token real (MSAC-RDHs5iokSJZgCSsQzGorMV5r). É esse trecho que o MEDSAC procura na primeira mensagem do paciente. Janela de match Cada click_token expira após 7 dias. Se o paciente clicar e só mandar mensagem 8 dias depois, o clique fica órfão (visível no relatório como "clique sem conversão") e a conversa não recebe o card. E se o paciente apagar o texto? Se o paciente apagar o MSAC-... antes de enviar, perdemos a atribuição. O clique fica órfão. Isso é raro porque o WhatsApp Mobile não incentiva edição da mensagem pré-preenchida.

UTMs: source, medium, campaign, content, term

UTM (Urchin Tracking Module) é um padrão consagrado de marketing digital para classificar origens de tráfego. O MEDSAC usa os 5 campos padrão: | Campo | Para que serve | Exemplo | | -------------- | -------------------------------------------- | ------------------------------------------------ | | utm_source | De onde veio o tráfego (plataforma/site) | google, instagram, facebook, tv, qr | | utm_medium | Como veio (tipo de mídia) | cpc, social, email, offline, bio | | utm_campaign | Qual campanha específica | checkup-maio, dia-das-maes, volta-as-aulas | | utm_content | Qual variação (A/B testing) | imagem-1, video-curto, texto-direto | | utm_term | Qual palavra-chave (Google Ads) | laboratorio-perto, exame-sangue | Onde definir Opção 1: Padrões da campanha (recomendado) Ao criar a campanha no MEDSAC, preencha os 5 campos UTM. Eles serão gravados automaticamente em todos os cliques desse link. Vantagem: simples. Você divulga só https://app.medsac.com.br/r/MSAC-... e o MEDSAC cuida do resto. Opção 2: UTMs na URL (override) Você pode passar UTMs na URL pública para sobrescrever os defaults: https://app.medsac.com.br/r/MSAC-Zaryd4...?utm_source=facebook&utm_campaign=teste-b Quando usar: quando uma mesma campanha é divulgada em vários canais e você quer separar resultados sem criar várias campanhas. Regra: se vier na URL, ganha do default. Se não vier, usa o default da campanha. Boas práticas - Use minúsculas e kebab-case consistente: checkup-maio, não Checkup_Maio. - Padronize entre clientes — alinhe com sua equipe de marketing para que instagram sempre seja instagram (e não às vezes insta, às vezes ig). - utm_campaign deve ser específico: checkup-maio-2026 é melhor que checkup (que confunde de um ano pro outro). - Não coloque dados pessoais nos UTMs — eles ficam visíveis em logs e relatórios. Como os UTMs aparecem na conversa O card MEDSAC mostra: MEDSAC Lead via link rastreável CAMPANHA checkup-maio Origem: instagram Meio: cpc Se você não preencher os UTMs, o card mostra só o que tiver (ex: só "Origem: instagram" se o medium estiver vazio). Google Ads e Meta tracking Além dos UTMs padrão, o MEDSAC captura automaticamente: - gclid (Google Click ID) — quando o paciente vem de um anúncio do Google. - fbclid (Facebook Click ID) — quando vem do Meta. Esses IDs não aparecem no card (privacidade), mas ficam disponíveis nos relatórios como contagens e chips ("Google Ads", "Meta/Facebook").

Card MEDSAC na conversa: como interpretar

Quando um paciente entra em contato via link rastreável MEDSAC, um card verde aparece no topo da conversa com as informações da campanha. Esse card é visível para todos os atendentes da inbox. Anatomia do card Header - Chip MEDSAC — marca a origem do card. - Lead via link rastreável — confirma que veio de um clique no link MEDSAC. Body - CAMPANHA — nome do utm_campaign (ex: checkup-maio). Se vazio, a linha não aparece. - Origem / Meio — utm_source e utm_medium. Aparece se algum dos dois estiver preenchido. - Conteúdo / Termo — utm_content e utm_term. Linha opcional, só aparece se preenchidos. - Chips Google Ads / Meta/Facebook — aparecem apenas se o clique veio com gclid/fbclid. O valor cru não é exibido (privacidade). Footer - #N — ID interno da campanha. Útil para identificar duplicatas. - Abrir campanha — link rápido para a tela de gestão da campanha (apenas administradores conseguem abrir). Diferenças vs. card Meta Ads (CTWA) | Característica | Card MEDSAC (verde) | Card Meta Ads (azul) | | -------------- | ----------------------------------------- | ------------------------------------------ | | Origem | Link rastreável MEDSAC /r/MSAC-... | Anúncio Click-to-WhatsApp direto na Meta | | Onde rastrear | Qualquer canal (Insta, Google, QR, TV) | Apenas Meta Ads (Facebook/Instagram) | | Dados | UTMs que você configurou | Headline, mídia, source_id do anúncio Meta | | Privacidade | Não mostra click_token, gclid, fbclid, IP | Não mostra ctwa_clid | Coexistência Se um paciente vier de um anúncio Meta CTWA E também clicou num link MEDSAC, ambos os cards aparecem na mesma conversa: 1. Card MEDSAC em cima (prioridade visual) 2. Card Meta Ads logo abaixo Quando o card NÃO aparece - O paciente apagou o MSAC-... da mensagem antes de enviar. - Já se passaram mais de 7 dias entre o clique e a primeira mensagem. - A campanha foi arquivada/excluída antes da primeira mensagem. - O paciente já tem conversa aberta — a 2ª mensagem dele com token novo não atualiza atribuição (vincula só na primeira mensagem incoming da conversa). Privacidade e LGPD O card nunca exibe: - click_token (apenas internamente para match) - campaign_token (idem) - Valor cru de gclid/fbclid (só os chips dizendo que existe) - IP do paciente (gravamos só o hash SHA256) - User Agent ou referer

Relatórios de Campanhas: o dashboard executivo

O relatório de campanhas fica em Campanhas → Relatórios. Top bar — Filtros - Período — janela de tempo (hoje, últimos 7 dias, mês, customizado). - Origem — meta_ads, medsac_link ou all. - Campaign ID — filtra por uma campanha específica. - utm_source / utm_campaign — filtros granulares. - Inbox — filtra por caixa de entrada. - Baixar Relatório — exporta CSV das últimas conversas. Bloco 1: Visão Geral das Conversas - Total — todas as conversas no período. - Rastreadas — só conversas vindas de um link rastreável MEDSAC. Mostra contagem + percentual. - Não rastreadas — conversas Meta CTWA + conversas orgânicas (sem nenhum atributo). - Donut semicircular — visualização da proporção rastreado vs não rastreado. Atenção: Meta Ads conta como "Não Rastreada" neste bloco porque a atribuição CTWA não é determinística como o link MEDSAC. Bloco 2: Origem das Conversas - Meta Ads — conversas vindas via CTWA da Meta. - Google Ads — conversas com utm_source google ou google_ads (derivado dos UTMs do clique). - Outras Origens — demais utm_source (instagram, tv, qr, parcerias, etc). - Não Rastreada — conversas sem nenhum atributo. - Gráfico stacked bar — leads por dia separados por canal (meta vs medsac). Bloco 3: Funil da Jornada Três etapas do funil: 1. Novo Contato (100%) — total de leads no período. 2. Negociação (% do total) — leads que viraram conversa real (com mensagens). 3. Conversão (% do total) — leads resolvidos com sucesso. Útil para identificar gargalo: se "Negociação" cai muito em relação a "Novo Contato", o problema está na entrada (qualidade do lead ou primeira resposta lenta). Bloco 4: Performance - Taxa de match — % de cliques MEDSAC que viraram conversa (cliques matched / cliques totais). - Meta leads — contagem de conversas Meta CTWA. - MEDSAC leads — contagem de conversas via link rastreável. - Leads com gclid — quantos vieram com Google Click ID. - Leads com fbclid — quantos vieram com Facebook Click ID. Tabela: Leads Recentes Lista paginada das últimas conversas com: - Chip de origem (MEDSAC ou Meta) - Campanha/Anúncio (headline ou nome) - Inbox, Status, Atendente, Criado em - Link direto pra abrir a conversa Exportar CSV O botão Baixar Relatório gera um arquivo campaigns_YYYYMMDD_YYYYMMDD.csv com as últimas conversas (até 200 linhas). Colunas: Origin, Conversation ID, Display ID, Contact, Inbox, Status, Assignee, Campaign/Ad, Created at. Cuidado com privacidade: o CSV pode conter nome de contato. Trate com mesmo cuidado de qualquer export de dados pessoais.

Casos de uso: Instagram bio, Google Ads, QR Code, TV

Caso 1: Link na bio do Instagram Cenário: clínica posta um link único na bio do Instagram que leva ao WhatsApp. Configuração: | Campo | Valor | | ------------ | ----------------------- | | Nome | Bio Instagram - Geral | | utm_source | instagram | | utm_medium | bio | | utm_campaign | bio-geral | Link divulgado: apenas https://app.medsac.com.br/r/MSAC-... na bio. Sem parâmetros extras. Como ler: todo paciente que vem por aqui aparece com card "Origem: instagram, Meio: bio". Caso 2: Stories sazonais Cenário: stories de campanha do "Check-up de Maio", colado no link da story. Configuração: crie uma campanha separada (não use a mesma da bio): | Campo | Valor | | ------------ | ------------------------- | | Nome | Stories - Check-up Maio | | utm_source | instagram | | utm_medium | stories | | utm_campaign | checkup-maio-2026 | Por que separar? Stories tem volume e dinâmica diferente da bio. Misturando, você perde a comparação. Caso 3: Google Ads Cenário: anúncio de Google Ads (search ou display) com botão "Falar no WhatsApp". Configuração: | Campo | Valor | | ------------ | ------------------------------ | | Nome | Google Ads - Search - Exames | | utm_source | google | | utm_medium | cpc | | utm_campaign | search-exames-2026 | No Google Ads, configure a URL final como: https://app.medsac.com.br/r/MSAC-...?utm_content={creative}&utm_term={keyword} O Google substitui {creative} e {keyword} automaticamente, e o gclid é adicionado também. Vantagem: você consegue separar por criativo (utm_content) e palavra-chave (utm_term) sem criar uma campanha por palavra. Caso 4: QR Code (folheto, balcão, TV) Cenário: QR Code impresso em folder ou na recepção. Configuração: | Campo | Valor | | ------------ | ---------------------------- | | Nome | QR Code - Recepção Iturama | | utm_source | qrcode | | utm_medium | offline | | utm_campaign | recepcao-iturama | Dica: crie uma campanha por ponto físico (recepção Iturama, recepção Limeira, totem da farmácia parceira). Assim você sabe qual ponto traz mais leads. Caso 5: TV / Mídia tradicional Cenário: comercial de TV pede pra acessar medsac.com.br/checkup. Configuração: crie a campanha MEDSAC normal e configure no seu site/redirecionador um redirect 301 de /checkup → /r/MSAC-.... | Campo | Valor | | ------------ | ------------------------- | | Nome | TV - Comercial Check-up | | utm_source | tv | | utm_medium | broadcast | | utm_campaign | tv-checkup-maio | Atenção: TV gera picos. O MEDSAC tem rate limit de 30 cliques/minuto/IP — o que não afeta usuários reais (cada IP é único), mas evita scrapers. Caso 6: Parceria / B2B Cenário: parceiro divulga sua clínica. Configuração: | Campo | Valor | | ------------ | ----------------------- | | Nome | Parceria - Farmácia X | | utm_source | parceria-farmacia-x | | utm_medium | referral | | utm_campaign | parceria-2026-q2 | Vantagem: você consegue medir quantos leads cada parceiro traz e remunerar com base em performance real. Resumo das convenções recomendadas | utm_source | utm_medium | Usar quando | | ----------------- | --------------------------------- | -------------------------- | | instagram | bio, stories, feed, reels | Instagram orgânico ou pago | | facebook | feed, stories, groups | Facebook orgânico | | google | cpc, display | Google Ads | | qrcode | offline | QR Code físico | | tv | broadcast | Mídia tradicional | | parceria-{nome} | referral | Parcerias B2B | | email | newsletter, transactional | Campanhas de e-mail | | whatsapp | broadcast, status | WhatsApp orgânico |

Meta CTWA vs Link Rastreável MEDSAC: quando usar cada um?

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.

Privacidade e LGPD nas campanhas rastreáveis

O módulo Campanhas foi desenhado com LGPD-first. Esta página detalha o que é coletado, como é protegido e por quanto tempo é mantido. O que é coletado em cada clique Quando alguém clica em https://app.medsac.com.br/r/MSAC-..., registramos o clique com os seguintes dados: | Campo | O que é | Por que coletamos | | ------------------------------------------------- | ----------------------------------- | -------------------------------------------- | | click_token | Token único de 24 chars | Para vincular o clique à conversa correta | | utm_source / medium / campaign / content / term | UTMs da URL ou defaults da campanha | Atribuição comercial | | gclid | Google Click ID (se presente) | Permitir reconciliação futura com Google Ads | | fbclid | Facebook Click ID (se presente) | Reconciliação Meta | | user_agent | Navegador e SO | Detecção de bots e analytics | | referer | Site que originou o clique | Atribuição da origem | | ip_hash | SHA256 do IP + salt secreto | Rate limit + detecção de abuso | | clicked_at | Timestamp | Análise temporal | O que NÃO é gravado - IP bruto — nunca persistido no banco. Só o hash irreversível. - Dados do dispositivo além do User-Agent — fingerprint não é feito. - Cookies — o redirect não cria cookie nenhum. O que NÃO é exibido na interface O card MEDSAC na conversa nunca mostra: - click_token (apenas usado internamente) - campaign_token - Valor cru de gclid ou fbclid (só chips dizendo "Google Ads" / "Meta/Facebook") - ip_hash, user_agent, referer O atendente vê apenas: nome da campanha, UTMs, ID interno. IP hash e salt O IP é processado com SHA256(ip + salt). O salt é uma chave secreta, armazenada de forma protegida no servidor e jamais exposta publicamente. Por que hashar e não anonimizar? Porque precisamos comparar IPs entre cliques (rate limit de 30/min/IP). Com hash, conseguimos comparar sem armazenar dado pessoal reversível. Risco de reidentificação: baixo. Mesmo se um atacante obtivesse o banco e descobrisse o algoritmo, sem o salt e sem uma rainbow table de IPs específicos, não consegue reverter. Rate limit A rota /r/:token tem throttle de 30 requisições/minuto/IP. Logs de bloqueio carregam IP cru (base legal: interesse legítimo de segurança contra abuso). Esses logs têm retenção curta e acesso restrito à equipe de operações. Retenção de dados Política atual: - Cliques com match (matched_conversation_id preenchido) — mantidos enquanto a conversa existir, para fins de auditoria comercial. - Cliques sem match (órfãos > 90 dias) — purgados periodicamente. Esses cliques não trazem valor analítico e mantê-los só aumenta exposição. Em estudo: anonimização automática de UTMs e click IDs em cliques com mais de 365 dias, mantendo apenas os vínculos de atribuição. Responsabilidades sob a LGPD Sua clínica (Controlador): - Define a finalidade do tratamento (marketing, comercial, atendimento). - Deve incluir a coleta de dados de campanha na sua Política de Privacidade. - Deve atender solicitações de direito de acesso, retificação e exclusão dos titulares. MEDSAC (Operador): - Processa os dados sob sua instrução. - Garante segurança técnica (hash de IP, rate limit, encriptação em trânsito). - Apaga dados conforme política de retenção combinada. Direitos do titular Se um paciente solicitar: - Acesso aos dados — conseguimos exportar todos os cliques + conversas vinculadas àquele número de WhatsApp. - Exclusão — apagamos cliques + dissociamos da conversa (mantendo a conversa pelo dever legal de retenção de comunicações comerciais). - Portabilidade — exportação em formato CSV. Para solicitar, abra ticket no painel ou contate lgpd@medsac.com.br.

FAQ — Perguntas Frequentes sobre Campanhas

Sobre criação Posso criar quantas campanhas quiser? Sim. Não há limite. Recomendamos uma campanha por canal + criativo + ponto de divulgação distinto, para conseguir separar resultados. Posso editar uma campanha já publicada? Sim. Edite nome, UTMs, mensagem pré-preenchida, telefone. A URL pública (/r/MSAC-...) não muda — links já divulgados continuam funcionando. Posso mudar o telefone WhatsApp depois? Sim. Mas atenção: novos cliques no link antigo serão redirecionados para o novo telefone. Tenha certeza antes de trocar. Posso reutilizar o mesmo link em mais de um canal? Pode, mas perde a separação por canal nos relatórios. Recomendado criar uma campanha por canal. Sobre o link O MSAC- no link é necessário? Sim, é nosso prefixo identificador. Não retire nem altere. O link pode ser encurtado (bit.ly, etc.)? Sim, funciona. Mas você perde a possibilidade de adicionar UTMs na URL final (porque o encurtador redireciona para a URL completa que você cadastrou). Se precisar de A/B testing por canal, prefira criar campanhas separadas. Posso colocar em link de página externa (não meu site)? Sim. Qualquer lugar onde você cole o https://app.medsac.com.br/r/MSAC-... funciona — bio do Instagram, descrição do YouTube, parceiro, e-mail. Sobre matching Por que algumas conversas não recebem o card? Cenários possíveis: 1. Paciente apagou o MSAC-... da mensagem antes de enviar (raro, < 1%). 2. Mais de 7 dias entre o clique e a primeira mensagem (token expira). 3. Conversa pré-existente — o token só vincula na primeira mensagem incoming de uma conversa nova. 4. Campanha foi excluída entre o clique e a mensagem. O paciente já era nosso contato. O card vai aparecer? Só se for criada uma conversa nova (não numa conversa aberta antiga). O MEDSAC usa o critério "primeira mensagem incoming da conversa = 1" para evitar atribuição errada. Posso vincular manualmente um clique a uma conversa? Hoje não há interface para isso. Cliques órfãos ficam visíveis nos relatórios mas sem vínculo. Sobre os relatórios Posso filtrar por período customizado? Sim. Use o filtro de período no topo da tela de relatórios. O CSV exportado tem limite? Sim, 200 linhas na primeira versão. Se precisar de export massivo, contate a equipe MEDSAC. Os cliques sem conversão (órfãos) contam? Aparecem como métrica separada ("cliques totais" vs "cliques matched"). A taxa de match = matched / totais. Útil para detectar campanhas com link quebrado ou template confuso. Posso ver os UTMs de uma conversa específica? Sim. Abra a conversa e olhe o card MEDSAC no topo. Mostra todos os UTMs preenchidos. Sobre permissões Quem pode criar campanhas? Apenas usuários com papel administrador. Quem pode ver o card MEDSAC na conversa? Todos os atendentes da inbox onde a conversa está. O card é informação operacional. Quem pode ver os relatórios? Apenas administradores (mesma regra dos demais relatórios do MEDSAC). Sobre integrações Posso integrar com Google Ads para conversões offline? Está em nosso planejamento. Hoje gravamos o gclid no clique e ele fica disponível para integração futura com o Google Ads. Posso integrar com Meta CAPI? Também está em nosso planejamento. Capturamos fbclid e dados de referral CTWA para envio futuro de eventos de conversão à Meta. Tem webhook para eventos de match/clique? Hoje não. Os dados ficam no banco e disponíveis via relatório. Se precisar empurrar para outro sistema, contate a equipe. Sobre LGPD Preciso pedir consentimento para usar UTMs? UTMs não são dados pessoais — são metadados de campanha. Não precisa consentimento. Mas você deve documentar na sua Política de Privacidade que coleta esses dados. O paciente pode solicitar exclusão dos cliques? Sim. Veja o artigo Privacidade e LGPD nas campanhas rastreáveis para o procedimento. Quanto tempo os cliques ficam guardados? Cliques matched: enquanto a conversa existir. Cliques órfãos: 90 dias. Política revisitada a cada 6 meses. Outras dúvidas? Abra um ticket interno ou fale com a equipe MEDSAC em suporte@medsac.com.br.

Card Meta Ads (CTWA): como interpretar

Quando um paciente clica em um anúncio Click-to-WhatsApp (CTWA) do Facebook ou Instagram e envia a primeira mensagem, um card azul "Meta Ads" aparece no topo da conversa. Ele ajuda o atendente a entender de qual anúncio o paciente veio antes mesmo de responder. Este artigo explica como interpretar esse card. De onde vem o card O card Meta Ads não depende de nenhuma configuração no painel MEDSAC. Quando o usuário clica no botão "Enviar mensagem" do anúncio, a própria Meta abre o WhatsApp e envia, junto com a primeira mensagem, um objeto referral com os metadados do anúncio. O MEDSAC lê esses dados e monta o card automaticamente. Se você quer entender a diferença entre essa atribuição e a do link rastreável próprio, leia Meta CTWA vs Link Rastreável MEDSAC: quando usar cada um?. O que o card mostra O card azul traz informações que vêm direto da Meta, e não de UTMs configurados por você: - Headline e body do anúncio — o título e o texto do criativo. É o principal apoio ao atendente: você vê na hora qual oferta ou campanha trouxe o paciente. - Mídia do anúncio — quando disponível, ajuda a contextualizar exatamente o que o paciente viu antes de clicar. - Dados de origem da Meta — campos como source_id e source_type, que identificam o anúncio dentro da plataforma da Meta. Diferente do link rastreável, aqui você não controla os UTMs: o que aparece é o que a Meta entrega. O que o card NÃO mostra Por privacidade, o card Meta Ads nunca exibe o ctwa_clid (o identificador de clique da Meta). Ele é usado apenas internamente. Card Meta Ads vs Card MEDSAC São dois cards distintos e com cores diferentes. Para detalhes do card verde, veja Card MEDSAC na conversa: como interpretar. Em resumo: | Característica | Card Meta Ads (azul) | Card MEDSAC (verde) | | -------------- | -------------------- | ------------------- | | Origem | Anúncio CTWA direto na Meta | Link rastreável /r/MSAC-... | | Onde rastrear | Apenas Meta Ads (Facebook/Instagram) | Qualquer canal | | Dados | Headline, mídia, source_id do anúncio | UTMs que você configurou | Quando os dois cards aparecem juntos Se o paciente clicou num anúncio Meta CTWA e também num link rastreável MEDSAC, ambos os cards aparecem na mesma conversa: o card MEDSAC (verde) fica em cima, por prioridade visual, e o card Meta Ads (azul) logo abaixo. Quando o card não aparece - A conversa não veio de um anúncio CTWA (foi mensagem orgânica, Google Ads, QR Code, etc.) — para esses casos use o link rastreável MEDSAC. - A Meta não entregou o objeto referral junto da mensagem. Dica: se o canal é Meta Ads, deixe o CTWA fazer o trabalho — ele já traz headline e mídia sem nenhum setup. Para todo o resto, crie um link rastreável MEDSAC.

Glossário de campanhas: clique, lead, conversão, match e órfão

As campanhas rastreáveis do MEDSAC usam um vocabulário próprio que aparece no painel, no card da conversa e nos relatórios. Este glossário reúne os termos essenciais para você ler os números com segurança. Clique Cada vez que alguém acessa a URL pública de uma campanha (/r/MSAC-...), o MEDSAC registra um clique. No momento do clique gravamos os UTMs (ou os padrões da campanha), gclid/fbclid se existirem, timestamp e um click_token único — sem expor IP em texto puro. Em seguida o paciente é redirecionado para o WhatsApp. Para entender o passo a passo, veja Entendendo a URL pública e o {{click_token}}. Lead É o paciente que chegou até você por uma origem rastreável. No funil dos relatórios, o estágio Novo Contato representa o total de leads no período. Nem todo clique vira lead com conversa: só quando a mensagem chega ao MEDSAC. Match O match é o vínculo entre um clique e uma conversa. Quando o paciente envia a primeira mensagem contendo o MSAC-..., o MEDSAC extrai esse trecho, encontra o clique correspondente e os liga. Esse vínculo é determinístico (diferente da atribuição Meta CTWA). A taxa de match nos relatórios é cliques matched ÷ cliques totais — útil para detectar link quebrado ou mensagem confusa. Clique órfão É o clique que nunca virou conversa. Acontece quando o paciente apaga o MSAC-... antes de enviar, quando passam mais de 7 dias entre o clique e a primeira mensagem (o click_token expira), ou quando a campanha foi removida nesse intervalo. Cliques órfãos aparecem nos relatórios como métrica separada ("cliques sem conversão") e, hoje, não podem ser vinculados manualmente. Conversão No Funil da Jornada dos relatórios, Conversão é o estágio final: leads resolvidos com sucesso, exibido como percentual do total. Não confunda com "leads que viraram conversa real" — esse é o estágio intermediário (Negociação). UTM UTM (Urchin Tracking Module) é o padrão de classificação de origem de tráfego. O MEDSAC usa os cinco campos: utm_source (de onde), utm_medium (como), utm_campaign (qual campanha), utm_content (qual variação) e utm_term (palavra-chave). Detalhes e boas práticas em UTMs: source, medium, campaign, content, term. Os dois tokens | Token | Identifica | Vida | Onde aparece | | --- | --- | --- | --- | | campaign_token | A campanha | Da criação ao arquivamento | URL pública (/r/MSAC-...) | | click_token | Um clique específico | Expira em 7 dias | Mensagem pré-preenchida | O click_token distinto por clique é o que torna a atribuição precisa, mesmo que várias pessoas cliquem no mesmo link. Veja também - Card MEDSAC na conversa: como interpretar - Relatórios de Campanhas: o dashboard executivo - FAQ — Perguntas Frequentes sobre Campanhas

Solução de problemas: meu link não está rastreando

Se você divulgou um link rastreável MEDSAC mas as conversas não estão recebendo o card verde — ou o relatório mostra muitos "cliques órfãos" (sem conversão) —, este guia ajuda a identificar a causa. Antes de começar, vale reler Card MEDSAC na conversa: como interpretar e FAQ — Perguntas Frequentes sobre Campanhas. Primeiro: o link gera clique? Acesse seu próprio link https://app.medsac.com.br/r/MSAC-... e confira se o navegador é redirecionado para o WhatsApp com a mensagem pré-preenchida. Em seguida, veja em Relatórios de Campanhas: o dashboard executivo se um clique foi registrado. - Não registrou clique: confira se o MSAC- do início não foi removido ou alterado, e se você está usando a URL pública exata da campanha. O prefixo MSAC- é obrigatório. - Registrou clique, mas sem card na conversa: o problema está no match (vínculo). Veja as causas abaixo. Causas comuns de match que falha 1. A mensagem pré-preenchida não tem o {{click_token}} O MEDSAC procura o trecho MSAC-... na primeira mensagem do paciente. Se a mensagem pré-preenchida da campanha não contém o placeholder {{click_token}}, não há o que vincular. Edite a campanha e garanta que o texto inclua {{click_token}} em algum lugar. 2. O paciente apagou o código antes de enviar Se o paciente apagar o MSAC-... da mensagem pronta, perdemos a atribuição e o clique fica órfão. É raro (menos de 1%), porque o WhatsApp não incentiva editar a mensagem pré-preenchida. 3. Passaram mais de 7 dias entre clique e mensagem Cada click_token expira em 7 dias. Se o paciente clicar hoje e só enviar mensagem 8 dias depois, o clique fica órfão e a conversa não recebe o card. 4. A mensagem caiu numa conversa pré-existente O token só vincula na primeira mensagem incoming de uma conversa nova. Se o paciente já tinha uma conversa aberta, a nova mensagem com token não atualiza a atribuição. Isso evita atribuir conversas antigas à campanha errada. 5. A campanha foi excluída ou arquivada Se a campanha foi arquivada/excluída entre o clique e a primeira mensagem, não há campanha para vincular o card. Encurtadores e links externos Encurtadores (bit.ly e similares) e links em sites externos funcionam, desde que redirecionem para a URL pública completa /r/MSAC-.... Se você encurtou o link, perde a opção de adicionar UTMs na URL final — nesse caso, prefira criar campanhas separadas por canal. Ainda não rastreia? Confira a taxa de match no relatório (cliques matched / cliques totais). Uma taxa baixa costuma indicar template confuso ou link quebrado. Persistindo o problema, abra um ticket interno ou fale com a equipe MEDSAC em suporte@medsac.com.br.

Checklist antes de divulgar uma campanha

Antes de colar um link rastreável na bio do Instagram, num anúncio ou num QR Code, vale gastar dois minutos revisando a campanha. Um detalhe errado — telefone trocado, token ausente ou UTM faltando — só aparece depois, quando os relatórios já estão poluídos. Use este checklist para publicar com segurança. Se ainda não criou a campanha, veja antes Como criar uma campanha rastreável (passo a passo). 1. Mensagem pré-preenchida contém o {{click_token}} Este é o item mais importante. O MEDSAC vincula o clique à conversa procurando o trecho MSAC-... na primeira mensagem do paciente. Se a mensagem pré-preenchida não tiver o placeholder {{click_token}}, não há o que rastrear e todos os cliques viram órfãos. - Abra a campanha e confirme que o texto inclui {{click_token}} em algum lugar. - Use a pré-visualização do formulário para ver como o paciente verá a mensagem (o sistema mostra um token de exemplo no lugar). 2. Telefone WhatsApp correto O campo Telefone WhatsApp é o número que aparece no destino (wa.me/). Confira dígito por dígito, incluindo DDD. Um número errado manda os pacientes para o lugar errado — e isso não fica óbvio nos relatórios. Se você mudar o telefone depois, lembre-se: novos cliques no link antigo passam a ir para o novo número. Confirme antes de trocar. 3. Status: Ativa Apenas campanhas com Status: Ativa redirecionam cliques. Se estiver Inativa, o link não funciona. Confira esse campo antes de divulgar. 4. UTMs preenchidos e padronizados Os UTMs são o que separa seus resultados por origem nos relatórios. Revise os 5 campos seguindo as boas práticas do artigo UTMs: source, medium, campaign, content, term: - Minúsculas e kebab-case: checkup-maio, não Checkup_Maio. - Padronizado: instagram sempre como instagram (nunca insta ou ig). - utm_campaign específico: checkup-maio-2026 é melhor que checkup. - Sem dados pessoais nos UTMs — eles ficam visíveis em logs e relatórios. Lembre-se: uma campanha por canal + criativo + ponto de divulgação distinto facilita a leitura dos números. 5. Canal e link público corretos - Confirme a Caixa de entrada vinculada — é a inbox do WhatsApp que receberá as conversas. - Copie sempre pelo botão Copiar link público. Não edite o MSAC- do início: o prefixo é obrigatório. - Se for usar encurtador (bit.ly), saiba que você perde a opção de adicionar UTMs na URL final. Para separar por canal, prefira criar campanhas separadas. 6. Teste de mesa antes de publicar Acesse seu próprio link https://app.medsac.com.br/r/MSAC-... e verifique se o navegador abre o WhatsApp com a mensagem e o telefone certos. Depois, confira em Relatórios de Campanhas: o dashboard executivo se o clique foi registrado. Se algo não bater, consulte Solução de problemas: meu link não está rastreando antes de divulgar para o público. Com esses seis itens revisados, é só publicar e acompanhar os resultados.