Vendas do checkout

Como conectar a loja Shopify ao TraceClose

Atualizado em 12 de outubro de 2026

Passo a passo

1. Crie a conexão no TraceClose

   Em Configurações › Integrações, clique em Nova conexão e, no grupo Vendas do checkout, escolha Shopify. Deixe a aba aberta: a tela mostra a URL do webhook (botão de copiar) e o campo Chave de assinatura.

2. Abra os webhooks da loja

   No admin da Shopify, abra Configurações › Notificações e role até Webhooks. Quem cria precisa ter acesso às configurações da loja.

3. Copie a chave de assinatura

   Na seção de webhooks, a Shopify mostra a chave com que assina os webhooks da loja (“Seus webhooks serão assinados com…”). Copie e cole no campo Chave de assinatura do TraceClose.

4. Crie o webhook do pagamento

   Clique em Criar webhook. Em Evento, escolha o pagamento do pedido (Order payment); em Formato, JSON; em URL, cole a URL do TraceClose; em versão da API, a mais recente. Salve.

5. Crie o webhook do reembolso

   Repita com o evento de criação de reembolso (Refund create) e a mesma URL. Assim, o reembolso cancela a venda no TraceClose.

6. 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.

7. Teste

   No menu ⋯ da linha do webhook, use Enviar teste. 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/shopify/<id-da-conexão>. Ela vale só para essa conexão.

Checkout iniciado e não pago (opcional)

Para o vendedor recuperar quem começou a compra e parou, ligue checkout não pago vira lead na conexão e crie mais um webhook com o evento de criação de checkout (Checkout creation). O lead entra com a origem, sem venda e sem Purchase.

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 Shopify, a referência vai no parâmetro tc_ref do link da loja, e a Shopify guarda no pedido o endereço por onde o comprador chegou. As UTMs desse endereço 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…

• O webhook sumiu da lista: a Shopify apaga sozinha o webhook que responde com erro muitas vezes seguidas. Confira a conexão no TraceClose (ativa e com a chave certa) e crie o webhook de novo.
• Erro de autenticação na conexão: a chave do TraceClose é diferente da chave de assinatura da loja. 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