Conectar

Como mandar os leads do formulário do site para o TraceClose

Atualizado em 28 de setembro de 2026

Passo a passo

1. Crie a conexão Site

   Em Configurações › Integrações › Nova conexão, escolha a plataforma Site. As funções Fonte de leads e Visitas do site já vêm marcadas; desmarque a que não for usar.

2. Gere e guarde o segredo

   Clique em Gerar segredo e depois em Copiar segredo. Guarde no servidor do site: depois de salvar, ele não aparece de novo.

3. Passe para quem cuida do site

   Clique no nome da conexão. A tela mostra a URL do webhook e o guia Como enviar do seu site, com o botão Copiar exemplo.

4. Teste com um lead

   Envie um cadastro de teste pelo formulário e veja se o lead aparece no Kanban.

Para quem é

Para quem capta pelo site (cadastro, orçamento, agendamento, checkout) e quer ver o ROAS por campanha, conjunto e anúncio com a venda real, mesmo quando o cliente não passa pelo WhatsApp. Funciona com código próprio e com ferramentas de automação que façam uma chamada HTTP.

O que o site envia

• Lead ("event": "lead"): o externalId (o id no seu sistema) e o e-mail ou o telefone. Opcionais: nome, data (occurredAt) e a origem em attribution: UTMs, fbclid, fbc, fbp, gclid, página de entrada, eventId do pixel, navegador, IP e o visitorId da tag de visitas.
• Venda ("event": "sale"): o externalId do pedido, o lead (por leadExternalId, e-mail ou telefone), amountMinor e currency.

amountMinor é o valor na menor unidade da moeda, sem vírgula: R$ 499,00 vai como 49900 com currency BRL.

Segurança do envio

Só o servidor do site chama o webhook, nunca o navegador. Cada envio leva o cabeçalho x-traceclose-signature com sha256= e o HMAC-SHA256 do corpo, ou, se a ferramenta não calcula HMAC, Authorization: Bearer com o segredo. Respostas: 200 recebido (repetido também), 401 assinatura ou conexão inválida, 400 corpo fora do formato (o campo errado vem indicado). Em erro 5xx ou de rede, envie de novo: a mesma entrega não entra duas vezes.

O que acontece no TraceClose

• O lead é procurado pelo id, depois pelo telefone, depois pelo e-mail. Não achou: é criado na etapa de entrada e distribuído pelo rodízio.
• Lead que já existe mantém o vendedor e só ganha os dados que faltavam. A origem só entra se ele ainda não tinha (o primeiro toque vence).
• Com anúncio identificado, fbclid, gclid ou fbc, o lead é Tráfego pago com método Site (UTMs). Só com UTMs, fica Orgânico.
• A venda é creditada ao vendedor de origem, leva o lead para a etapa de ganho e, se ela tiver o Purchase e o envio de conversões estiver ligado, gera o evento para a Meta.
• Reenviar o mesmo lead ou a mesma venda não duplica nada.

Se o site já dispara Lead ou Purchase pelo pixel da Meta, mande o mesmo event_id em eventId: a Meta descarta o repetido. Sem eventId, não dispare o mesmo evento pelo pixel, ou ele conta duas vezes.

Exemplo

Exemplo fictício: a Empresa Exemplo recebe o orçamento de Maria (maria@exemplo.com) pelo formulário, vindo do anúncio 120200000000000003. O servidor envia o lead cadastro-1001 com as UTMs. Dois dias depois, o checkout envia a venda pedido-5001 com amountMinor: 49900 e BRL. Maria vai para a etapa de ganho, a venda de R$ 499,00 entra na receita do anúncio e o Purchase sai para a Meta.

Não funcionou? Veja…

• 401 em tudo: segredo diferente do salvo, conexão desativada ou URL de outra conexão. Perdeu o segredo? Gere outro em Editar e troque no site.
• 400: falta o e-mail ou o telefone, ou o valor veio com vírgula ou decimal.
• Venda que chegou antes do lead: o TraceClose tenta de novo por alguns minutos e, se não achar, cria o lead pelo contato da venda.
• Evento não chega à Meta: a venda não aparece na Meta.

Perguntas frequentes