Conectar a Reportana

A Reportana recupera boleto e carrinho abandonado via WhatsApp. A integração é por webhook de saída: a CopyFunnel envia um POST JSON para a URL que você configurar, a cada evento de pedido ou de recuperação — a cadência de mensagens é toda da Reportana.

Pegar a URL na Reportana

Na conta da Reportana, crie um webhook de entrada e copie a URL que ela gera para receber eventos de plataformas externas (consulte a documentação da ferramenta para o passo a passo). Se a Reportana oferecer 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 Reportana e preencha:

1. URL do webhook — a URL copiada da Reportana.
2. Segredo do webhook (HMAC) — opcional. Quando preenchido, todo POST sai com o header x-copyfunnel-signature, o HMAC-SHA256 (hex) do corpo cru. Para validar do lado da Reportana, calcule o HMAC do body exatamente como a string chegou e compare com o header.

O segredo é um campo secreto: fica cifrado e nunca volta para a tela (só os últimos 4 dígitos). Vazio ao salvar preserva o anterior.

Eventos recebidos

A Reportana recebe todos os eventos da CopyFunnel:

1. order.pending — pedido criado, aguardando pagamento.
2. order.completed — pedido pago.
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 nomeando o evento. O data é o snapshot do pedido (orderId, status, método, valores em centavos, comprador, itens, UTMs first-touch quando existirem) 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" (e assinatura, se houver segredo) na URL configurada. Resposta 2xx valida a credencial e o card vira Conectado.

Fluxo de recuperação

A esteira funciona de trás para frente: a Reportana inicia o contato quando recebe um recovery.* — a CopyFunnel dispara um push por pedido/sessão (com dedupe automático) — e pausa quando recebe order.completed (venda fechada) ou order.refunded (não há mais o que recuperar). Não há limite de estágios no lado da CopyFunnel: quem controla quantas mensagens e em que intervalo é a ferramenta.

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.
• Trocou a URL na Reportana? Atualize o campo e salve — a nova URL já vale para os próximos eventos.