Como as vendas entram no sistema

As vendas não são cadastradas manualmente no Oráculo. Elas entram automaticamente quando alguem compra seu produto, atraves de webhooks dos gateways de pagamento (Eduzz, Xgrow, Hotmart, Kiwify, Monetizze, Guru, PerfectPay, Stripe).

O fluxo completo

Quando alguem compra seu produto, isso é o que acontece nos bastidores:

Pessoa clica no botao de compra
         |
         v
Faz o pagamento na plataforma (Eduzz, Hotmart etc.)
         |
         v
Plataforma confirma o pagamento
         |
         v
Plataforma envia um webhook para o Oráculo
         |
         v
Oráculo recebe e processa os dados
         |
         v
Cria o cliente + registra a venda
         |
         v
Tenta vincular a venda a um lead existente

Todo esse processo acontece em poucos segundos, sem que você precise fazer nada.

O que é um webhook

Um webhook é uma notificação automatica. Quando uma venda acontece na plataforma de pagamento, ela “avisa” o Oráculo enviando os dados da compra (nome, email, telefone, valor, produto, status).

Para isso funcionar, você precisa configurar a URL do webhook na sua plataforma de pagamento. Veja o guia completo em Configurando webhooks de pagamento.

Como o sistema identifica o lead

Quando uma venda chega, o Oráculo tenta encontrar o lead correspondente. Ele faz isso em ordem de prioridade:

1. Por telefone

O sistema normaliza o telefone da venda e procura um lead com o mesmo telefone. Essa é a forma mais confiavel porque o telefone é o identificador único do lead no Oráculo.

2. Por email

Se não encontrar por telefone, o sistema tenta pelo email. Isso acontece quando o lead se cadastrou com um telefone diferente do usado na compra.

3. Direto (sem lead)

Se não encontrar nem por telefone nem por email, a venda e registrada como venda direta — a pessoa comprou sem ter se cadastrado como lead antes.

4. Orfao

Se não for possível identificar a origem de nenhuma forma, a venda e marcada como órfã.

Tipos de rastreamento

Cada venda tem um campo que indica como ela foi vinculada ao lead:

Tipo	Significado
lead_telefone	Venda vinculada ao lead pelo telefone (mais preciso)
lead_email	Venda vinculada ao lead pelo email
direto	Pessoa comprou sem ser lead (não se cadastrou antes)
órfão	Não foi possível identificar a origem

O que e criado quando uma venda chega

O Oráculo cria duas coisas:

1. Cliente

O cliente é a pessoa que comprou. E uma entidade separada do lead. Um lead vira cliente quando compra. Os dados do cliente (nome, email, telefone) vem do webhook da plataforma de pagamento.

2. Venda

A venda registra os detalhes da transacao:

Valor bruto e liquido
Status (aprovada, pendente, cancelada etc.)
Data da compra
Produto comprado
Gateway de pagamento
UTMs de captacao (do lead) e de checkout (do webhook)

UTMs de captacao vs UTMs de checkout

O Oráculo rastreia duas origens para cada venda:

UTMs de captacao — De onde o lead veio quando se cadastrou (qual anúncio, campanha, criativo). Essas informações vem do cadastro do lead.
UTMs de checkout — De onde a pessoa veio quando acessou a página de pagamento. Essas informações vem do webhook da plataforma.

Ter as duas origens permite saber, por exemplo, que o lead foi captado pelo anúncio A mas comprou após clicar no anúncio B.

Status de uma venda

Uma venda pode ter os seguintes status:

Status	Significado
Aprovada	Pagamento confirmado. A venda conta na receita.
Pendente	Pagamento ainda não confirmado (boleto gerado, pix não pago).
Cancelada	Venda foi cancelada antes da confirmacao.
Reembolsada	O cliente pediu e recebeu o dinheiro de volta.
Chargeback	O cliente contestou a cobranca no cartão de credito.

O que é uma venda órfã

Uma venda órfã e quando o sistema não consegue identificar de onde ela veio. Isso pode acontecer quando:

O telefone e email da compra são diferentes dos cadastrados no lead
A pessoa comprou sem se cadastrar como lead antes
Houve erro nos dados enviados pela plataforma

Vendas órfãs não afetam a receita (ainda são contabilizadas), mas não aparecem no funil de conversao porque não estão vinculadas a um lead.

Perguntas frequentes

As vendas entram sozinhas?

Sim, desde que o webhook esteja configurado na plataforma de pagamento. Veja como configurar em Configurando webhooks de pagamento.

E se a mesma venda chegar duas vezes?

O sistema detecta duplicatas pelo ID da transacao no gateway. Se uma venda com o mesmo ID já existe, ela e atualizada em vez de duplicada.

O status muda automaticamente?

Sim. Se a plataforma enviar um novo webhook com status diferente (ex: de “pendente” para “aprovada”), o Oráculo atualiza o status automaticamente.

Vendas de todas as plataformas entram da mesma forma?

Sim. O Oráculo normaliza os dados de cada plataforma para um formato padrao. Independente se veio da Eduzz, Hotmart ou Stripe, a venda aparece igual no dashboard.

Resumo

Vendas entram automaticamente via webhooks das plataformas de pagamento
O sistema tenta vincular a venda a um lead existente (por telefone ou email)
Cada venda cria um cliente e registra a transacao
UTMs de captacao e checkout são rastreados separadamente
Status possiveis: aprovada, pendente, cancelada, reembolsada, chargeback
Vendas órfãs são contabilizadas mas não aparecem no funil