Vendas do checkout
Como conectar a Kiwify ao TraceClose
Crie a conexão Kiwify em Configurações › Integrações e copie a URL do webhook. Na Kiwify, em Apps › Webhooks, crie um webhook com essa URL e os eventos de compra, e cole o token do webhook no TraceClose. As vendas passam a entrar sozinhas.
Passo a passo
Crie a conexão no TraceClose
Em Configurações › Integrações, clique em Nova conexão e, no grupo Vendas do checkout, escolha Kiwify. Deixe a aba aberta: a tela mostra a URL do webhook (botão de copiar) e o campo Token.
Crie o webhook na Kiwify
No painel da Kiwify, abra Apps › Webhooks e clique em Criar webhook. Dê um nome (ex.: “TraceClose”), cole a URL do webhook do TraceClose e escolha todos os produtos ou um produto.
Marque os eventos
Marque Compra aprovada, Compra reembolsada, Chargeback e, se vender assinatura, Assinatura renovada.
Copie o token
O formulário do webhook mostra um token. Copie e cole no campo Token do TraceClose. Salve o webhook na Kiwify.
Escolha as opções e salve
Decida o envio do Purchase para a Meta (ligado por padrão; se o pixel do checkout já envia a compra, veja abaixo) e se o checkout não pago vira lead (desligado por padrão). Clique em Salvar.
Teste
Na Kiwify, use Testar webhook. O evento aparece na conexão do TraceClose como último evento recebido.
Qual é a URL
O painel mostra a URL pronta, no formato https://t.traceclose.com/webhooks/sales/kiwify/<id-da-conexão>. Ela vale só para essa conexão.
Carrinho abandonado, boleto e pix gerados (opcional)
Ligue checkout não pago vira lead na conexão e marque, na Kiwify, Carrinho abandonado, Boleto gerado e Pix gerado. O lead entra com a origem, sem venda e sem Purchase, para o vendedor chamar no WhatsApp. Se pagar depois, a venda entra no mesmo lead.
O que acontece no TraceClose
- Venda aprovada vira venda no TraceClose, com o valor pago e a moeda do pedido, creditada ao vendedor do lead. O lead vai para a etapa de ganho.
- O lead é achado pela referência do link de checkout, depois pelo telefone, depois pelo e-mail. Não achou: o lead é criado com a origem que o checkout guardou e entra no rodízio.
- Lead que já existia mantém a origem e o vendedor: quem veio de um anúncio de clique para WhatsApp continua creditado a esse anúncio.
- Reembolso e chargeback cancelam a venda. A mesma entrega reenviada pela plataforma não duplica nada.
Para a venda casar com o lead certo mesmo quando o comprador paga com outro e-mail ou telefone, use Copiar link de checkout no detalhe do lead: cole a URL do produto e o TraceClose acrescenta a referência do lead no parâmetro de rastreio da plataforma. Na Kiwify, a referência vai no parâmetro sck. As UTMs que chegam ao checkout (utm_source, utm_campaign…) também servem de origem para o lead novo.
Se o pixel da Meta já está instalado no checkout da plataforma e envia o Purchase, escolha quem envia a compra: desligue o envio do Purchase nesta conexão com um clique (ou desligue o Purchase no pixel do checkout). Assim a Meta recebe a venda uma vez só, e ela continua entrando no painel e no ROAS.
Não funcionou? Veja…
- Nada chega: confira a URL e se o webhook está ligado para o produto vendido. Na Kiwify, o menu de três pontos do webhook mostra os registros de envio e permite reenviar.
- Erro de autenticação na conexão: o token do TraceClose é diferente do token do webhook na Kiwify. Copie de novo e salve em Editar.
- Venda chegou, mas não foi para a Meta: veja a venda não aparece na Meta.
Perguntas frequentes
Posso ter um webhook por produto?
Pode. Todos podem apontar para a mesma URL do TraceClose, desde que usem o token colado na conexão.
Compra recusada vira lead?
Não. Só compra aprovada vira venda; carrinho abandonado, boleto e pix gerados viram lead se você ligar a opção.
O valor é o bruto ou o líquido?
O valor pago pelo comprador, na moeda do pedido. Taxas da plataforma não são descontadas.
Veja o caminho do anúncio até a venda no seu WhatsApp.
Teste o TraceClose por 7 dias grátis com o seu time. Sem cartão para testar.