Índice canônico. A medição quase nunca quebra por bug — quebra por configuração errada que não dá aviso. Cada linha: sintoma → causa → o que fazer. Itens 🔴 falham silenciosamente (nenhum erro na tela; o número só não fecha).

11.1 Captação & anúncio

# Sintoma Causa O que fazer
1 🔴 CPL/ROAS ficam “—” numa campanha que roda no Meta Canal ≠ Meta, OU canal Meta sem o ID da campanha preenchido. O custo só sincroniza com canal Meta e o ID do Gerenciador. No anúncio de conversa, CPL e ROAS ficam “—” mesmo com o ID (item 13) Garanta canal Meta e abra Editar campanha → cole o ID da campanha do Meta. Não há vínculo automático por nome (§5.1)
2 🔴 Tudo cai em “Sem atribuição” no placar O clique veio do anúncio, mas a marcação dele não chegou: o anúncio de site da Meta está sem os parâmetros de URL Cole no campo “Parâmetros de URL” do anúncio o bloco da §5.4, inteiro e sem alterar nada. Confira em Validar oferta (§5.4)
3 🔴 Nada rastreado; tudo “Orgânico” As conversas chegam sem sinal de anúncio. No anúncio de site, o botão de WhatsApp da landing page não usa o link rastreável, ou o link está sem a mensagem pré-preenchida. No anúncio de conversa, o número não está conectado pela conexão Oficial Meta No anúncio de site, coloque o Link do botão da sua página no botão de WhatsApp da landing page e mantenha a mensagem pré-preenchida (§5.2 e §5.3). No anúncio de conversa, conecte o número pela conexão Oficial Meta, em Canais (§5.3)
4 🔴 O criativo cai em “Sem atribuição” mesmo com os parâmetros colados no anúncio A landing page não repassa a marcação do anúncio para o link do botão Faça a página repassar a marcação para o link do botão (§5.4). Não aponte o anúncio para o link rastreável: o martec não orienta esse uso (§5.3)
5 🔴 Leads chegando no WhatsApp de quem você desligou Bloqueou o operador, mas os links dele continuam roteando Reatribua/desative os links antes de bloquear (§4.6)
6 Visitante vê “Este link expirou ou não existe” O link foi desativado, mas continua divulgado: no botão da landing page de um anúncio no ar, na bio, num QR code impresso ou em outro canal Para o link voltar a funcionar, use Ativar no menu ⋯ do link. Antes de desativar um link, tire o link de todo lugar onde ele foi divulgado; se ele está no botão da landing page de um anúncio no ar, pause o anúncio primeiro (§5.2)
7 Clique cai em “indisponível” Tracking link sem operador Associe um operador ao link (§5.2)
8 🔴 Cliente recebe “Olá {nome}” cru Placeholder inválido (só 6 funcionam) Use só os 6: {utm_source} {utm_campaign} {utm_content} {utm_term} {campaign_name} {tracking_link_slug} (§5.2)
9 Não consigo salvar o WhatsApp do operador (ou número legado rotearia errado) O cadastro exige celular BR válido (DDD + 9 — +55 DD 9XXXX-XXXX); não-BR/malformado é rejeitado na criação/edição com erro. Só dado legado escaparia e rotearia errado Informe um número BR válido; não-BR não é suportado hoje. Suspeita de dado legado? Edite o operador e re-salve

11.2 Integrações

# Sintoma Causa O que fazer
10 🔴 CAPI parou de enviar conversão Credencial desabilitada/não-verificada/revogada, OU Meta desconectado Cheque “Envio CAPI: Ativo”; reconecte o Meta se preciso (§7.2)
11 🔴 Custo congelado / ROAS desatualizado Token Meta expirou e ninguém reconectou (banner estado D) Reconecte antes do token vencer (<7 dias avisa) (§7.1)
12 🔴 Conectou o Meta mas não veio conta de anúncio Usuário do Facebook sem acesso à conta (banner estado C) Reconecte com o usuário que enxerga a conta no Gerenciador (§7.1)
13 🔴 Leads de anúncio de conversa (WhatsApp) sem custo, CPL, ROAS nem criativo Esperado: o lead do anúncio de conversa chega com a origem Meta Ads, mas não passa pelo link rastreável. Por isso o martec não liga esse lead a uma campanha nem a um criativo, e não calcula custo, CPL nem ROAS para ele. A origem Meta Ads só aparece com o número conectado pela conexão Oficial Meta (item 3) Não há o que configurar além da conexão Oficial Meta (§5.3). Se você precisa de criativo, custo, CPL e ROAS por anúncio no martec, o caminho é o anúncio de site (§5.3 e §5.4). Não use o link rastreável como destino do anúncio de conversa (§5.3)
14 🔴 As conversas de um operador não correlacionam Operador cadastrado com WhatsApp diferente do número conectado — o casamento é por número Cadastre o operador com o mesmo número conectado em WhatsApp connect (§7.4)
15 Duas conexões de WhatsApp no mesmo número Migrou Evolution→Oficial; a Evolution não desliga sozinha Desconecte a Evolution manualmente após confirmar a Oficial (§7.4)
16 Custo de campanha Google não aparece Esperado: Google ainda não tem import de custo Trate CPL/ROAS de Google como parciais (§7.6)

11.3 Públicas & operação

# Sintoma Causa O que fazer
17 Bio publicada parece abandonada Publicada sem botões Adicione ao menos um botão antes de publicar (§6.1)
18 Meu teste de clique não conta Bot/preview ou limite de cliques (10/60s no mesmo IP) Teste do celular, sem recarregar várias vezes; o clique real conta (§6.3)
19 “Hoje/Ontem” parecem deslocados Fuso da empresa errado Ajuste o timezone da empresa
20 O custo por anúncio só aparece no dia seguinte Esperado: o custo da campanha (Custo Meta (lifetime)) é buscado na hora, ao salvar o ID externo e no botão Sincronizar agora, e é atualizado de novo toda madrugada. Já o custo de cada anúncio, que aparece no placar, só é buscado uma vez por dia, de madrugada, por volta das 6h (horário de Brasília). Até lá, o placar mostra “—” com “Custo ainda não sincronizado para este anúncio” Para o custo da campanha, salve o ID externo ou use Sincronizar agora, uma vez por minuto (§5.1). Para o custo por anúncio, aguarde a madrugada seguinte; se ele não vier depois de um dia, confira o canal e o ID externo (§5.1) e a conexão com a Meta (§7.1)

11.4 Roteiro de “ativação sem buraco” (faça nesta ordem)

  1. Crie a campanha no canal certo (Meta, se roda no Meta) — item 1.
  2. Crie o tracking link com operador e mensagem só com os 6 placeholders — itens 7, 8.
  3. Confira o WhatsApp do operador no padrão BR e igual ao número conectado — itens 9, 14.
  4. No anúncio de site, ponha o link rastreável no botão de WhatsApp da landing page e cole os parâmetros de URL no anúncio; no anúncio de conversa, conecte o número pela conexão Oficial Meta — itens 2, 3, 4.
  5. Use Validar oferta pra conferir destino + mensagem + marcação antes de publicar (§5.3).
  6. Conecte o Meta com o usuário certo, confirme o banner verde, e cole o ID da campanha do Meta em cada campanha (Editar campanha) — senão o custo não fecha — itens 11, 12, 1.
  7. Se usa CAPI, confirme “Envio CAPI: Ativo” — item 10.
  8. Publique. Não pause/exclua o link nem bloqueie o operador sem antes tratar os anúncios no ar — itens 5, 6.