Como investigar erros nos webhooks recebidos
O histórico de um listener ajuda a descobrir se a integração chegou à plataforma e por que a ação não aconteceu. Por exemplo, uma compra pode estar aprovada no gateway, mas o evento ter chegado com um e-mail em um campo diferente do configurado.
Você precisa de permissão para consultar e gerenciar o recurso na sua plataforma.
Na plataforma, abra sua foto de perfil e clique em Painel administrativo. Depois siga: Integrações → Webhooks → Recebidos.
1Localize o recebimento
Encontre o listener da integração e abra seu ícone de logs. Filtre pelo período da compra e atualize a consulta. A lista da imagem é a entrada dessa consulta; cada listener cadastrado tem seu próprio histórico. Os registros são mantidos por 30 dias.
2Leia o motivo antes de corrigir
Inactive webhook indica que o listener estava inativo. Payload does not satisfy listener criteria indica que os critérios não corresponderam. Email não encontrado no payload pede revisão do caminho do e-mail; Usuário não encontrado exige conferir o cadastro e a opção de criar usuários. Compare o JSON recebido com o mapeamento da ação.
3Cruze as evidências
Sem entrada, confira período, retenção e histórico do gateway, além da URL cadastrada. Ausência de log não prova, sozinha, que nada foi enviado. Com sucesso, confira o resultado da ação específica no usuário: sucesso de uma mensagem não comprova atribuição de selo. Para acesso, confira também o selo e sua validade.
Dica
Copie a URL pelo controle do próprio listener. Antes de reenviar um evento, leia O que conferir antes de reenviar uma integração: algumas ações acumulam efeitos.
Dúvidas comuns
Uma resposta HTTP 200 garante a entrega?
Não. Um listener inativo ou com critérios não atendidos pode responder 200 sem executar a ação. Leia o desfecho no log.