crm-track

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_ID e META_ACCESS_TOKEN no .env, reinicie (pm2 restart crm-track) e valide em Meta / CAPI. Comece com META_TEST_EVENT_CODE preenchido, 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.
Instale a captura de clique na landing:
```
<script src="https://SEU-DOMINIO/t/snippet.js"></script>
```
Sem isso o fbclid morre no primeiro redirecionamento e o pedido que chega por webhook não tem como ser ligado ao anúncio. Quando o cliente informar o telefone, chame crmTrackIdentify('5531999998888').

META_PURCHASE_ON=delivered e UTMIFY_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_id determinístico: integração.pedido.status — webhook reenviado nunca conta em dobro, e o mesmo id casa com o eventID do 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.

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.

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 o fbtrace_id — guarde esse número se abrir chamado com eles.
Conversão duplicada no Gerenciador: Confira se o Pixel do site envia eventID igual ao event_id daqui (formato integração.pedido.status).
Servidor: pm2 logs crm-track · pm2 restart crm-track · banco em data/crm.db (faça backup criptografado — tem CPF).

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.

crm·track