Automação & Apps

Webhooks (sua URL)

Manda os eventos das suas vendas para qualquer URL sua — payload v1 + assinatura HMAC opcional.

Para que serve

O app Webhooks é o conector genérico: a CopyFunnel POSTa cada evento de pedido na URL que você cadastrar. Use quando a sua ferramenta (CRM, planilha, zap, seu próprio servidor) não estiver na lista de apps prontos.

Como configurar

  1. No painel, entre em Integrações e clique no card Webhooks.
  2. Cole a URL do webhook (o endereço que recebe o POST).
  3. Opcional: Segredo do webhook (HMAC) — se preencher, cada requisição recebe o header de assinatura do corpo (HMAC-SHA256) para você conferir que veio da CopyFunnel.
  4. Clique em Testar conexão — dispara um POST de teste na sua URL.

O que você recebe (payload v1)

{
  "event": "order.completed",
  "data": {
    "orderId": "…",
    "product": "Nome do produto",
    "amountCents": 99700,
    "method": "PIX",
    "buyerEmail": "…",
    "paidAt": "2026-10-22T12:00:00Z"
  }
}

Eventos: order.pending, order.completed, order.refunded, recovery.carrinho, recovery.boleto.

Retries e dedupe

  • 1 push por pedido/evento (dedupe no banco — reenvios não duplicam).
  • Falha de rede ou 5xx: a rota "Reenviar apps" do painel reprocessa.
  • A URL deve responder 2xx em até 10 segundos.