Saltar para o conteúdo principal
Este artigo explica porque é que a CloudTalk desativa automaticamente um endpoint de webhook que falha continuamente e como voltar a pô-lo a funcionar, incluindo recuperar os eventos perdidos.
Nível de utilizador: Administrador

Porque é que um endpoint é desativado

Quando uma entrega para o seu endpoint de webhook não recebe uma resposta bem-sucedida (2xx), a CloudTalk tenta novamente de forma automática, até 50 vezes ao longo de cerca de 11,5 horas. Se o seu endpoint continuar a falhar ininterruptamente durante cerca de 5 dias, a CloudTalk desativa-o automaticamente e deixa de lhe enviar eventos. Isto evita que um endpoint avariado acumule um volume interminável de entregas falhadas. Os administradores da conta recebem um email quando um endpoint é desativado e outro quando é reativado.

Como voltar a pô-lo a funcionar

  1. Corrija o seu endpoint para que responda com HTTP 2xx aos pedidos de webhook recebidos.
  2. Se o corrigir nas 12 horas seguintes à desativação, não precisa de fazer mais nada. Durante essas 12 horas, a CloudTalk continua a testar o seu endpoint. Assim que responder corretamente, a CloudTalk reativa-o automaticamente e reenvia os eventos perdidos.
  3. Se tiverem passado mais de 12 horas, volte a ativar o endpoint manualmente:
    1. Aceda a Definições > Webhooks e abra o endpoint.
    2. Volte a ativar o endpoint.
    3. Utilize Recover para reenviar as entregas que falharam enquanto estava desativado.

Durante quanto tempo os eventos perdidos são guardados

Os payloads dos eventos são guardados durante 30 dias. Durante esse período, pode reenviar eventos individuais ou recuperar entregas falhadas. Após 30 dias, são eliminados e já não podem ser reenviados.
Se testar webhooks com uma ferramenta de testes pública, como o webhook.site, lembre-se de que estes endpoints podem ficar offline ou deixar de responder. Isso conta como um endpoint com falhas, pelo que pode ser desativado da mesma forma que um endpoint de produção.
Para ver o calendário completo de novas tentativas e dicas para criar um endpoint fiável, consulte Webhook Delivery, Retries, and Best Practices.
Precisa de ajuda ou tem alguma questão? Contacte-nos através do nosso Portal de suporte. Estamos aqui para si.