O Histórico de Webhooks é a sua ferramenta de debug pras integrações com plataformas de venda. Sempre que Hotmart, Kiwify, Eduzz ou seu Webhook personalizado mandam alguma coisa pra Weve (uma compra, reembolso, cancelamento), aparece nessa tela — com payload completo, status de processamento e botão pra reprocessar caso tenha falhado.
Quando uma venda chega mas o acesso não libera, é aqui que você descobre o porquê em segundos.
Onde encontrar
Acesse Configurações → Plataformas de Vendas e clique na aba Histórico de Webhooks. A tela mostra os últimos 30 dias de requisições recebidas, ordenadas da mais recente pra mais antiga.
O que aparece em cada linha
Pra cada webhook recebido você vê:
Plataforma: de qual sistema veio (Hotmart, Kiwify, Eduzz ou Webhook personalizado).
Evento: o que aconteceu (ex.:
PURCHASE_APPROVED,order_paid,invoice_paid, etc.).Cliente: e-mail do comprador, extraído do payload.
Status: success, failed ou pending (veja seção abaixo).
Mensagem de erro: se falhou, o motivo aparece aqui.
Payload completo: o JSON cru que a plataforma enviou — útil pra debug profundo.
Data e hora: timestamp exato do recebimento.
Status de cada webhook
Sucesso (success)
O webhook chegou, foi processado e a ação foi executada (acesso liberado, reembolso aplicado, etc.). Nada a fazer.
Pendente (pending)
Chegou mas ainda não foi processado. Geralmente dura segundos — se ficar pendente por muito tempo, pode haver problema na fila interna.
Falhou (failed)
Foi processado mas deu erro. Você vê a mensagem de exceção indicando o motivo. Causas comuns:
Produto não cadastrado na Weve com aquele ID externo.
Produto sem entrega vinculada.
Plano de membros já no limite (não conseguiu criar membro novo).
Evento não suportado pela plataforma.
Payload malformado (caso de webhook personalizado).
Webhook com status failed quase sempre é problema de configuração — não é bug. Verifique se o produto está cadastrado, se tem entrega ativa e se o ID externo bate com o que a plataforma manda.
Reprocessar um webhook
Quando um webhook falhou e você corrigiu o problema (cadastrou o produto, vinculou a entrega, etc.), dá pra reprocessar sem pedir pra plataforma reenviar:
Encontre o webhook na lista.
Clique em Reprocessar.
O sistema limpa o erro, marca como pendente e tenta de novo.
Em segundos você vê o novo status.
Se reprocessar com sucesso, a ação é executada normalmente — o acesso é liberado, etc. Se falhar de novo, a mensagem de erro vai te dizer o que ainda está faltando.
Investigando "venda chegou mas acesso não foi liberado"
É o caso de uso mais comum. Cheque na ordem:
O webhook chegou? Filtre pelo e-mail do cliente. Se não aparece, a plataforma não enviou ou enviou pra URL errada (verifique a configuração na plataforma de venda).
Qual o status? Se success, o problema não está na entrada — pode ser que o aluno não saiba acessar, ou esteja olhando outro e-mail. Se failed, leia a exceção.
O evento é o esperado? Compras aprovadas têm eventos específicos por plataforma (Hotmart:
PURCHASE_APPROVED, Kiwify:order_approved, etc.). Se chegou um evento diferente (carrinho abandonado, lead, etc.), a Weve ignorou de propósito.O ID do produto bate? Inspecione o payload completo. O ID externo enviado pela plataforma precisa ser exatamente o cadastrado no Produto da Weve.
Tem entrega ativa? Mesmo com produto cadastrado, sem entrega vinculada o aluno não recebe nada.
Quando o histórico não mostra nada
Significa que nenhum webhook chegou nos últimos 30 dias dessa plataforma. Possíveis causas:
A plataforma não foi configurada pra mandar webhook.
Foi configurada com URL errada (cole de novo a URL correta — está em Configurações → Plataformas de Vendas, na linha de cada plataforma).
A plataforma está bloqueando o envio (raro, geralmente erro de credenciais).
Você está olhando o período errado (filtro de 30 dias).
Limites e retenção
Histórico mostra os últimos 30 dias.
Webhooks mais antigos podem ser purgados periodicamente (depende da política de retenção do banco).
Pra histórico longo de auditoria, considere consumir via API/MCP ou exportar pra ferramenta externa.
Diferença entre Histórico de Webhooks e Webhooks de saída
Não confunda:
Histórico de Webhooks (esta tela): webhooks recebidos das plataformas de venda. Você é o servidor.
Webhooks (Configurações → Integrações → Webhooks): webhooks enviados pela Weve pra sistemas externos quando algo acontece no clube. Você é o cliente.
Os dois são úteis — esta tela serve pra debugar entradas (compras), a outra pra debugar saídas (notificações pro seu CRM).
Boas práticas
Cheque o histórico quando alguém reclamar. "Comprei mas não liberou" — vá direto no histórico pelo e-mail do cliente.
Configure alertas internos. Se você tem muitos webhooks failed, vale criar uma rotina de monitoramento (alguém da equipe checa diariamente).
Salve payloads complexos antes de purgar. Pra integrações novas (webhook personalizado), copie alguns payloads de exemplo pra documentação interna.
Reprocessar é seguro. A Weve detecta duplicidade — você não vai criar 2 acessos pro mesmo cliente reprocessando.
Mantenha as credenciais válidas. Webhook chega, mas se sua credencial expirou ou foi trocada, falhas começam a aparecer. Verifique periodicamente.
Use filtros (busca por e-mail). Em clubes com volume alto, busca por e-mail acelera muito o debug.
Perguntas frequentes
Por que um webhook está pendente há horas?
Não deveria — pendente normal dura segundos. Se persistir, pode indicar lentidão na fila interna ou problema temporário. Tente reprocessar; se persistir, fale com o suporte.
Reprocessar pode duplicar uma compra?
Não. A Weve usa delivery_id e checagens internas pra evitar duplicidade. Você pode reprocessar à vontade.
Posso ver webhooks de mais de 30 dias atrás?
Hoje a interface mostra até 30 dias. Pra histórico maior, use API/MCP ou exporte os dados regularmente.
O que faço se o status está "failed" e a mensagem não ajuda?
Olhe o payload completo — geralmente a discrepância está aí (ID errado, campo faltando). Se ainda não entender, fale com o suporte com o ID do webhook em mãos.
Webhook personalizado dá mais erro que os nativos?
Sim, geralmente — o sistema externo manda dados num formato que precisa ser exatamente o esperado. Pra reduzir falhas, valide payloads antes de mandar pra produção.
Posso reprocessar todos os failed de uma vez?
Hoje é um por vez na interface. Pra reprocessamento em massa, use a API/MCP ou fale com o suporte se forem muitos.
Webhooks ficam disponíveis em qual fuso horário?
O timestamp é mostrado no fuso configurado da sua organização. Se está vendo horário "errado", verifique configurações.
Posso filtrar por status (só failed, por exemplo)?
A interface tem filtros. Pra ver só falhas, basta selecionar o status. Útil quando você quer revisar todos os erros do dia/semana.
Webhook que veio com e-mail diferente do cadastrado cria membro novo?
Sim. Cada e-mail único vira membro próprio. Se o cliente comprou com e-mail diferente do cadastro, vai ter dois membros.
Tem alerta automático pra mim quando um webhook falha?
Hoje não há notificação automática nativa. Pra monitoramento ativo, considere consumir via API/MCP e ter um sistema externo alertando.