Como acompanhar falhas de entrega de um webhook
Uma falha de entrega indica que o destino não confirmou o recebimento de uma alteração como esperado. Ela não prova, por si só, que o Meuats perdeu dados nem que o sistema externo está indisponível para sempre. O diagnóstico precisa relacionar o evento, o horário e a resposta do destino.
Comece em Configurações > Integrações > Webhooks e identifique qual webhook está envolvido. Registre a URL configurada, os eventos selecionados e quando o comportamento foi percebido. Em seguida, a equipe técnica deve consultar os registros do serviço que recebe as requisições para conferir se houve chegada, rejeição de segurança, erro de validação ou indisponibilidade.
Os problemas mais comuns são URL incorreta, certificado HTTPS inválido, destino fora do ar, regra de rede bloqueando a requisição, segredo diferente entre origem e destino e erro no processamento do conteúdo recebido. Não altere vários fatores ao mesmo tempo: corrija uma hipótese, teste com um evento controlado e valide o resultado antes de seguir.
Se houver risco de processar dados duplicados, peça que o destino use o identificador do registro e trate repetições de forma segura. Evite desligar ou recriar o webhook apenas para “zerar” o problema, pois isso pode remover o contexto necessário para entender a falha. Quando precisar de suporte, reúna URL sem expor credenciais, horário, evento, identificação do registro e mensagem de erro disponível.
Defina quando a falha exige interrupção
Nem toda falha exige desligar o webhook. Avalie primeiro o impacto: quais eventos foram afetados, se há dados que precisam de reconciliação e se o destino pode processar uma nova entrega com segurança. Para fluxos críticos, suspenda alterações automáticas no sistema externo até entender se ele está recebendo registros parciais ou duplicados.
Depois de corrigir a causa, valide uma ocorrência recente e uma nova ocorrência controlada. A confirmação deve acontecer no Meuats e no destino; um status aparentemente normal em apenas um dos lados não encerra o diagnóstico.