O cliente mandou o comprovante, a plataforma mostra a venda aprovada, e no painel ela não está. A primeira reação é achar que o sistema perdeu a venda. Quase nunca é isso. A venda fez um caminho, e parou em algum ponto dele que dá para ver.
- Plataformamanda o aviso
- Recebimentoconfere quem mandou
- Leituraentende o que chegou
- Painelmostra no período certo
Este texto segue esse caminho na ordem. Em cada etapa, o que testar e o que costuma estar errado.
Antes de tudo: a tela Eventos
Toda chamada que uma plataforma faz ao UTMizey fica registrada em Eventos, com a hora em que chegou, a plataforma, o resultado e o conteúdo recebido, já sem os dados pessoais do comprador. Procure pelo horário da venda ou filtre pela plataforma. Uma de três coisas vai acontecer: o aviso não está lá, está com erro ou ignorado, ou está processado.
1. O aviso não está em Eventos
Então a plataforma não mandou nada para cá. O defeito está na configuração do webhook, do lado dela. Os casos mais comuns:
- O webhook não foi cadastrado naquele produto. Em várias plataformas o webhook é por produto, e um produto novo nasce sem ele.
- O evento de aprovação não foi marcado. Algumas plataformas pedem para escolher quais eventos disparam o aviso. Marque pelo menos compra aprovada, reembolso e chargeback.
- A URL foi colada pela metade, ou é a URL de outro painel seu. A URL de cada painel carrega um código próprio: copie de novo, direto de Integrações.
A plataforma também tem um registro
Quase toda plataforma guarda o histórico dos webhooks que tentou mandar, com a resposta que recebeu. Se lá aparece um envio e aqui não, confira se o endereço de destino é exatamente o que o painel mostra.
2. O aviso está lá, com erro ou ignorado
Aqui o aviso chegou, mas não virou venda. A tela diz o motivo em português. Os que mais aparecem:
| O que a tela diz | O que fazer |
|---|---|
| A assinatura enviada não confere com o segredo cadastrado | O segredo ou token do webhook mudou na plataforma. Cadastre o novo em Integrações. |
| O hottok enviado não confere com o cadastrado | Na Hotmart, copie o hottok de novo e salve no painel. |
| Evento mais antigo que o já gravado | Nada. Um aviso atrasado chegou depois de um mais novo, e o pedido ficou no estado certo. |
| O adaptador não reconheceu o formato | Um status de pagamento novo ou um formato diferente. Fale com o suporte com o horário do evento. |
Duas coisas importantes sobre esse grupo. Primeiro, um aviso recusado por assinatura não entra depois por insistência: se ele pudesse entrar, a assinatura não protegeria nada. Corrija o segredo e peça para a plataforma reenviar. Segundo, quando o erro é de leitura nossa, a venda fica guardada com o conteúdo original e é processada de novo depois da correção. Ela não se perde.
3. O aviso está processado, e a venda não aparece
Esse é o caso mais comum, e quase sempre é uma destas cinco coisas:
- A venda ainda não foi paga. Pix gerado e boleto emitido entram como pendentes. Eles aparecem no cartão Vendas pendentes do Resumo, e só entram no faturamento quando o pagamento é confirmado.
- A data é outra. A venda entra no dia em que o pedido foi gerado, e não no dia em que foi paga: o Pix gerado ontem e pago hoje aparece em ontem. E o painel recorta o dia pelo fuso configurado nele, então uma venda das 23h40 pode cair no dia seguinte se o fuso do painel não for o seu. Teste ampliando o período para “últimos 7 dias”.
- Há um filtro ligado. Produto, plataforma ou fonte selecionados no topo da tela escondem o resto. Limpe os filtros e procure de novo.
- Era uma venda de teste. O botão de teste da plataforma manda uma venda de exemplo, que fica fora do Resumo, dos relatórios e da contagem do plano. É de propósito: venda de teste não é faturamento.
- O limite do plano Gratuito foi atingido. No Gratuito, a venda que passa do limite do mês fica guardada, e não some. Assinar um plano libera todas de volta, com a origem de cada uma.
Para achar um pedido específico
O Resumo mostra totais. Para achar uma venda, use Relatórios: uma linha por pedido, com o número que a plataforma deu a ele, o status, o valor e a origem. É ali que se confere o pedido que o cliente citou ou que o financeiro quer bater com o extrato.
E se a venda aparece, mas sem campanha?
Aí a venda chegou inteira e a origem é que se perdeu no caminho entre o anúncio e o checkout. É outro diagnóstico, com quatro lugares para testar, e está no artigo sobre venda sem UTM.
Pelo sintoma, onde procurar
| O que você vê | Onde procurar |
|---|---|
| Nenhuma venda de um produto aparece | Webhook não cadastrado naquele produto |
| Nenhuma venda de uma plataforma aparece desde ontem | Segredo do webhook trocado: veja os erros em Eventos |
| A venda aparece em Relatórios e não no Resumo de hoje | Fuso do painel ou venda ainda pendente |
| Só a venda que eu testei não aparece | Venda de teste, fora do faturamento de propósito |
| As vendas pararam de entrar no meio do mês, no Gratuito | Limite do plano: as vendas estão guardadas |
Em uma frase
Abra Eventos e procure o horário da venda: se o aviso não está lá, o problema é o webhook na plataforma; se está com erro, a tela diz o motivo; se está processado, confira se a venda já foi paga, o fuso, os filtros e se não era um teste.
Nenhuma venda some sem deixar rastro
No UTMizey, cada aviso que chega fica em Eventos com o resultado e o motivo, e a venda que a leitura não entendeu é guardada e reprocessada depois da correção. Venda pendente, de teste ou acima do limite do Gratuito aparece separada, e não some do painel. Para começar, a URL do webhook de cada plataforma está pronta em Integrações.