Integrações — Apps

Conectar a Smart Funnel

Envie os eventos de conversão da CopyFunnel para a Smart Funnel via webhook — trackeamento avançado de tráfego.

A Smart Funnel faz trackeamento avançado e relatórios de tráfego (com WordPress). Aqui a webhook funciona como um tracker: em vez de disparar mensagens, a ferramenta recebe os eventos de conversão da CopyFunnel e alimenta seus relatórios e atribuição.

Pegar a URL na Smart Funnel

Na conta da Smart Funnel, gere o webhook de entrada para receber eventos de plataformas externas e copie a URL (consulte a documentação da ferramenta para o passo a passo). Se a ferramenta fornecer um segredo para validar a origem do POST, guarde-o para o próximo passo.

Configurar na CopyFunnel

Na rota Integrações, abra o card Smart Funnel e preencha:

  1. URL do webhook — a URL copiada da Smart Funnel.
  2. Segredo do webhook (HMAC) — opcional. Preenchido, todo POST sai com o header x-copyfunnel-signature: o HMAC-SHA256 (hex) do corpo cru. Do lado da Smart Funnel, calcule o HMAC do body exatamente como a string chegou e compare com o header.

O segredo fica cifrado e nunca volta para a tela (só os últimos 4 dígitos); vazio ao salvar preserva o anterior.

Eventos recebidos

A Smart Funnel recebe todos os eventos da CopyFunnel:

  1. order.pending — pedido criado, aguardando pagamento.
  2. order.completed — pedido pago (a conversão de fato).
  3. order.refunded — pedido reembolsado.
  4. recovery.carrinho — carrinho abandonado (e-mail digitado, sem pedido).
  5. recovery.boleto — pedido PIX/boleto pendente na esteira de recuperação.

O POST traz {event, data, sentAt} com o header x-copyfunnel-event. O data é o snapshot do pedido (orderId, status, método, valores em centavos, comprador, itens, UTMs first-touch quando existirem — úteis para atribuição) ou da sessão de recuperação (sessaoId, comprador, produto, valor e âncora da agenda).

Testar conexão

Clique em Testar conexão: a CopyFunnel envia um POST sintético com event: "copyfunnel.test" (assinado, se houver segredo) na URL configurada. Resposta 2xx valida a credencial e o card vira Conectado.

Bom saber

  • Falha de envio nunca derruba a venda — o POST é fire-and-forget, com timeout de 10 segundos.
  • Cada evento é enviado uma única vez por pedido (dedupe automático).
  • Trocou a URL na Smart Funnel? Atualize o campo e salve — a nova URL já vale para os próximos eventos.