Conectar a Utmify

A Utmify faz rastreio de campanhas e atribuição de vendas. A integração da CopyFunnel é nativa: cada evento de pedido vira um postback para a API da Utmify, com as UTMs capturadas no checkout e os valores do pedido.

Gerar o token

Na Utmify, gere o token em Integrações → Webhooks → Credenciais de API (botão Adicionar Credencial → Criar Credencial).

⚠️ Atenção ao token certo. O painel da Utmify também exibe outros tokens (ex.: token de webhook de outras integrações). O que a CopyFunnel precisa é o valor da Credencial de API criada no caminho acima — copiado integralmente. Um token errado passa no teste superficial e é recusado no envio real com INVALID_WEBHOOK_TOKEN.

Configurar na CopyFunnel

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

1. Token de API (Credencial de API) — o token gerado no passo acima (campo secreto: é cifrado e nunca volta para a tela, só os últimos 4 dígitos).

Clique em Salvar. A CopyFunnel já valida na hora: envia uma ordem de R$ 0,01 com status waiting_payment para https://api.utmify.com.br/api-credentials/orders — validação real (a API autentica o token), e a ordem aparece no painel da Utmify como prova da conexão (não conta como venda paga). Passou, o status vira Conectado. O botão Testar conexão repete essa validação quando quiser.

Eventos enviados

A Utmify recebe os três eventos de pedido (recuperação não é venda e não é enviada):

1. order.pending — status waiting_payment.
2. order.completed — status paid (com approvedDate preenchido).
3. order.refunded — status refunded (com refundedAt preenchido).

O mesmo orderId é reenviado a cada evento, mantendo o createdAt idêntico — é assim que a API da Utmify atualiza o status da transação ao longo do ciclo.

UTMs first-touch

As UTMs vêm do checkout, gravadas na criação da sessão (first-touch). O payload leva o objeto trackingParameters com as 7 chaves da spec Utmify: src, sck, utm_source, utm_campaign, utm_medium, utm_content e utm_term. Chave que o visitante não trouxe vai como null (a API aceita).

O que mais vai no postback

• Pedido: orderId, método de pagamento (pix, credit_card ou boleto), plataforma CopyFunnel.
• Comprador: nome, e-mail, telefone, documento (CPF) e IP da sessão quando disponíveis.
• Produtos: um item por produto do pedido (ID, título, quantidade 1 e valor em centavos).
• Commission: valor total, taxa do gateway e sua comissão líquida em centavos.

Bom saber

• Falha de envio nunca derruba a venda — o postback é fire-and-forget.
• Cada evento é enviado uma única vez por pedido (dedupe automático).
• O token pode ser trocado a qualquer momento: informe o novo no drawer e salve.