Documentação

O painel só mostra números quando recebe eventos reais. Verifique: 1) o script está instalado antes de </head>; 2) você acessou a página de vendas de verdade; 3) os UTMs estão ativos nos anúncios. Depois do primeiro clique com fbclid ou utm_source, os números começam a subir.

Entre em Integrações → aba Gateways, crie uma credencial (escolha o gateway — FortPay, FlevoPay, Hotmart, Kiwify, Utmify ou “Outro gateway”) e copie a URL do webhook e o token. Cole-os na configuração de webhooks da sua plataforma de pagamento. Veja o guia completo de gateways.

O token é exibido uma única vez por segurança (ele é salvo apenas como hash no banco). Crie uma nova credencial no painel, obtenha um token novo e reative o webhook na sua plataforma. Recomendamos destruir o token antigo após a troca.

Pelo utm_campaign (contém nome + ID da campanha) e pelo fbclid/fbc. O script da página captura isso automaticamente e o webhook do gateway repassa os campos de rastreamento (tracking.* / metadata.*). Sem UTMs ativos, as vendas aparecem mas não são ligadas a uma campanha.

ROAS = receita atribuída (soma dos Purchase aprovados com valor) ÷ gasto da campanha (Marketing API da Meta). Acompanhe em Campanhas com os períodos disponíveis. Você precisa ter contas Meta vinculadas e campanhas com UTMs ativos.

O 401 significa token ausente, inválido ou desativado. Confira se o token está completo (começa com tb_live_), se chegou no header Authorization: Bearer, X-TrackBase-Key ou ?token=, e se a credencial está ativa. Gere uma nova credencial se necessário.

Isso é a regra de centavos: valores inteiros acima de 10000 são interpretados como centavos e divididos por 100. Se sua API trabalha com centavos, envie inteiros acima de 10000 (ex.: 12990). Se trabalha com decimais, envie decimais (ex.: 129.90). A conversão é automática.

Não. O webhook é idempotente: o pedido é identificado por provider + external_id e reenvios apenas atualizam o status. Eventos usam event_id único (project + event), então duplicados são ignorados — inclusive navegador × CAPI na Meta.

O fluxo OAuth troca o token curto pelo token de longa duração ao vincular as contas. Se houver invalidação, basta reconectar a conta em Contas Meta. O token do CAPI (gerado no Gerenciador de Eventos) pode ser renovado e reconectado na aba Pixel & CAPI.

Sim. Selecione “Outro gateway” na criação da credencial e envie o JSON no formato do seu sistema. Como os campos são detectados por heurística (id, status, amount, tracking.*), a maioria funciona sem adaptação.

Não é obrigatório para rastrear vendas: com o script + webhook do gateway você já vê vendas e funil. A conexão com as contas Meta adiciona gasto, cliques, CPC/CPM e ROAS por campanha, e o Pixel + CAPI melhora a otimização e atribuição dentro da Meta.