Ambiente de demonstração. Os dados aqui são de exemplo e
voltam ao início toda madrugada. Para rastrear a sua operação de
verdade, você recebe um ambiente só seu —
fale com a gente.
Rastreamento da campanha
Saiba exatamente qual campanha, conjunto e anúncio gerou cada venda — e devolva um sinal melhor para a Meta.
Como você vende?
Landing rastreada para WhatsApp
Escolha a aparência, altere os textos e veja a prévia antes de gerar. Cada página ganha um link individual que identifica campanha, conjunto e anúncio antes de abrir o WhatsApp.
Suas landings
Como colocar no anúncio da Meta (importante)
Na criação do anúncio, em Destino, escolha Site e cole o link da landing no campo URL. O visitante vê a página, toca no botão e segue para o WhatsApp. A campanha, o conjunto, o anúncio e o
Você pode editar a landing depois sem alterar o link que já está no anúncio.
fbclid ficam registrados no caminho.Você pode editar a landing depois sem alterar o link que já está no anúncio.
Rastreamento para página / checkout
Dois jeitos — use um ou os dois. O bloco pronto para copiar (com o seu domínio e a chave da conta) está na Documentação.
Tudo bem — os pedidos continuam entrando pelo webhook e virando Purchase na Meta com telefone, endereço e valor. Você só não vai saber de qual anúncio cada venda veio, e a nota de correspondência fica menor (sem o clique). Dá para mudar de ideia quando quiser.
Primeiros passos
Nenhum pedido ainda. Três coisas colocam o rastreio no ar em menos de 15 minutos.
- Cole a URL do webhook na sua plataforma (Logzz, Hyppe, Coinzz…)página Integrações — cada plataforma tem a sua URL
- Ligue a Meta com o ID do conjunto de dados e o tokenpágina Meta / CAPI tem um tutorial guiado — até lá os eventos ficam na fila, nada se perde
- Lance uma venda de teste e veja a prévia do eventopágina Lançar venda — ela mostra exatamente o que a Meta vai receber
Receita entregue por dia
Funil agora
Por integração
Por campanha
Perdas
Gasto do Meta Ads cruzado com a sua receita, campanha →
conjunto → anúncio. O elo é a UTM: use
NOME|{{campaign.id}}
nos parâmetros do anúncio para casar exato, ou o nome puro que casa por
igualdade. Receita = entregue — aprovado fica na coluna
Esteira e não infla o ROAS.
Contas de anúncio
Cole o token da Meta. O CRM busca somente as contas que esse token pode acessar; então você escolhe a conta certa. O token nunca volta para a tela.
Piloto automático
Ao conectar uma conta, o CRM começa a atualizar os gastos a cada 30 minutos e monitora campanhas com ROAS abaixo de 1 após R$ 100 investidos em 7 dias. Primeiro ele só observa; pausas reais exigem sua confirmação e permissão
ads_management.Configuração avançada de automações
Crie limites próprios ou controle horários. Regras em simulação nunca alteram a Meta.
Arraste o pedido entre as colunas para mudar a etapa. A mudança passa pelo
mesmo caminho de um webhook — mover para Entregue dispara
o evento na Meta de verdade.
Para venda que fechou fora da plataforma — WhatsApp, telefone, na mão.
Vai para a Conversions API no mesmo dataset do seu Pixel,
com os dados hasheados em SHA256 e
event_id próprio, então se o
Pixel do site mandar o mesmo evento a Meta deduplica sozinha.
Cole a URL no painel da plataforma (Logzz → Integrações → Webhook; Coinzz →
Integrações → Webhooks; PaguePay → notificações; ScalaCode → webhook de entrada
do WhatsApp). Plataforma nova: crie com
Detectar automaticamente, dispare um teste e mapeie os campos
na aba Payloads.
Todo webhook é gravado cru antes de ser interpretado. Se um
campo veio errado, corrija o mapeamento e clique em Reprocessar —
nada precisa ser reenviado pela plataforma.
Selecione um payload à esquerda.
Tutorial guiado — conectar a API de Conversões
Seis passos, uns 10 minutos. Cada passo marca ✓ sozinho quando o crm·track detecta que foi feito.
0 de 6
Qualidade dos dados enviados
Envia cada pedido para o painel da UTMify via
POST api-credentials/orders. A credencial sai de
Integrações → Webhooks → Credenciais de API na conta deles.
Fila de pedidos
Envia ao GA4 pelo Measurement Protocol só o que o navegador
não vê:
purchase na entrega confirmada, refund e
generate_lead. O client_id vem do cookie _ga
capturado na landing — é ele que faz a venda cair na sessão certa.
Credenciais: GA4 → Admin → Fluxos de dados → Measurement Protocol API secrets.
Fila de eventos
Auditoria técnica, não parecer jurídico. A base legal do compartilhamento
publicitário e a política de privacidade precisam de advogado —
docs/LGPD.md lista o que levar para ele.
Documentos públicos: Termos de Uso · Política de Privacidade. O titular pode pedir acesso, correção, portabilidade, oposição ou eliminação pelo canal de privacidade publicado.
Retenção de dados
Minha conta
Ao cancelar, o acesso da sua equipe e os novos webhooks param na hora. Os dados remanescentes seguem os prazos da Política de Privacidade; para uma solicitação específica de eliminação, use o canal de privacidade publicado.
Cada conta tem os próprios dados — leads, pedidos, integrações, Meta. Quem se cadastra
na tela de entrada cria uma conta nova; quem você convida aqui entra na
sua conta, já ativo. Só administradores convidam, desativam e mudam papel.
Desativar derruba a sessão da pessoa na hora.
Dados jurídicos da plataforma. Eles aparecem nos Termos, na Política de Privacidade e no cadastro. Só o dono da plataforma pode alterar. Este é um modelo operacional e deve ser revisado pelo seu advogado antes de abrir cadastros públicos.
Começando
- Conecte as plataformas. Em Integrações, copie a URL de cada webhook e cole no painel da plataforma: Logzz → Integrações → Webhook · Coinzz → Integrações → Webhooks · Hyppe / PaguePay → notificações. Plataforma que não está na lista: crie uma integração com adaptador Detectar automaticamente.
- Dispare um pedido de teste na plataforma. Ele aparece em Payloads com o corpo cru gravado. Se algum campo veio errado, clique no payload, confira o mapeamento sugerido, salve e use Reprocessar — sem pedir reenvio a ninguém.
- Ligue a Meta. No Gerenciador de Eventos → seu dataset →
Configurações → gere o token. Preencha
META_DATASET_IDeMETA_ACCESS_TOKENno.env, reinicie (pm2 restart crm-track) e valide em Meta / CAPI. Comece comMETA_TEST_EVENT_CODEpreenchido, confira em "Testar eventos" no Gerenciador, e apague o código depois — enquanto ele existir, nada entra em otimização. - Ligue a UTMify (opcional). Na conta deles: Integrações →
Webhooks → Credenciais de API. Preencha
UTMIFY_API_TOKEN, reinicie e clique em Validar credencial na página UTMify. - Capture o clique do anúncio (é o que mais sobe a nota da Meta):
sem isso o
fbclidmorre no primeiro redirecionamento e o pedido que chega por webhook não tem como ser ligado ao anúncio (fica semfbc). Dois jeitos, use um ou os dois: Quando o cliente informar o telefone na sua página, chamecrmTrackIdentify('5531999998888')para casar o clique com o pedido.
Decisões que valem dinheiro (já configuradas)
META_PURCHASE_ON=deliveredeUTMIFY_PAID_ON=delivered- No COD, pedido aprovado não é dinheiro — o cliente ainda pode recusar na
porta. O Purchase da Meta e o paid da UTMify só
disparam na entrega confirmada. Otimizar pelo "aprovado" ensina o algoritmo a
trazer quem aceita e não paga. Se a sua operação for de pagamento antecipado
(PIX/cartão), troque os dois para
paid. - Identidade pelo telefone (últimos 8 dígitos)
- A mesma pessoa chega da Logzz com 55, da Coinzz sem 55 e do formulário com o 9º dígito. O casamento é pelos últimos 8 — nunca por igualdade. CPF é a segunda chave, e-mail a terceira.
event_iddeterminísticointegração.pedido.status— webhook reenviado nunca conta em dobro, e o mesmo id casa com oeventIDdo Pixel do site (é assim que a Meta deduplica navegador × servidor).- Status nunca regride
- Webhook chega fora de ordem o tempo todo. Se "pago" chegar depois de "entregue", o pedido continua entregue. Só cancelamento/estorno/chargeback vencem um estado mais avançado, porque são fato posterior.
- CPF nunca vai para a Meta
- Ele existe só para casar a mesma pessoa entre plataformas (minimização, LGPD Art. 6º III). O que sai é hasheado em SHA256 no padrão exato da Meta.
Rotina do dia a dia
- Painel — os números do período: taxa de entrega é a métrica que decide se a operação COD dá lucro (entregue ÷ aprovado).
- Funil — arraste o pedido entre etapas; mover para Entregue dispara o evento de verdade, igual a um webhook.
- Lançar venda — venda que fechou no WhatsApp/telefone não tem webhook; sem lançar, ela nunca chega na Meta. Use Ver o que vai para a Meta antes: mostra o evento exato, os campos hasheados e a força do sinal.
- Clientes — a gaveta tem o botão Abrir no WhatsApp, a linha do tempo e as anotações. Os botões de LGPD (exportar, parar de trackear, eliminar) estão lá também.
- Tarefas — "ligar para confirmar a entrega de sábado" com prazo; atraso fica vermelho no menu.
Quando algo parecer errado
- O pedido não apareceu
- Olhe Payloads primeiro. Se o cru está lá com erro, o problema é interpretação (corrija o mapeamento e reprocesse). Se nem o cru chegou, o problema é a URL colada na plataforma.
- Evento não chegou na Meta
- Meta / CAPI → fila. Estado
pending = aguardando envio (ou
META_ENABLED=false). failed mostra o motivo devolvido pela Meta e ofbtrace_id— guarde esse número se abrir chamado com eles. - Conversão duplicada no Gerenciador
- Confira se o Pixel do site envia
eventIDigual aoevent_iddaqui (formatointegração.pedido.status). - Servidor
pm2 logs crm-track·pm2 restart crm-track· banco emdata/crm.db(faça backup criptografado — tem CPF).
Referências completas
docs/META-ADS.md— a documentação da Meta compilada: endpoint, 17 eventos padrão, hashing campo a campo, dedupe, webhooks, Lead Ads, limites.docs/API.md— todas as rotas deste servidor, com exemplos.docs/LGPD.md— a auditoria de conformidade e o que ainda depende de você (base legal, política de privacidade, DPO).README.md— visão geral, instalação e produção.