Aprenda a gerenciar seus webhooks de maneira eficiente, garantindo o funcionamento adequado das suas automações. Nesta documentação, você vai entender como realizar o backup dos dados para aumentar a segurança e controle nas integrações, além de aprender como ativar ou desativar seus webhooks conforme necessário.
- Status de Configuração
- Primeiras 3 Tentativas
- Após as 3 Tentativas com Backup Ativo
- Após 10 Tentativas Sem Backup Ativo
Status de Configuração
Ao configurar um webhook, ele pode se encontrar em três estados diferentes: Ativo, Backup, ou Inativo.
- Ativo: A URL está funcionando corretamente e recebendo eventos normalmente.
- Backup: A URL falhou nas tentativas iniciais, mas está armazenando eventos enquanto o sistema tenta o reenvio por até 7 dias.
- Inativo: A URL não está recebendo eventos devido a falhas contínuas ou à ausência de uma configuração de backup, resultando no descarte dos eventos.
Abaixo, explicamos as condições e comportamentos para cada um desses estados.
Primeiras 3 Tentativas
Quando enviamos um evento para uma URL e recebemos um código de status diferente de sucesso (diferente de 200), tentamos novamente até 3 vezes consecutivas, com intervalo de 1 minuto entre cada tentativa. Durante esse período, a URL permanecerá com status Ativo e os eventos serão armazenados.
Se, em qualquer uma das 3 tentativas, a URL retornar um código de status de sucesso (200), a URL será reativada, e o sistema enviará todos os eventos armazenados no backup, do mais antigo ao mais recente.
Após as 3 Tentativas com Backup Ativo
Se a falha persistir após as 3 tentativas e a funcionalidade de backup estiver configurada, a URL será marcada como Backup. Nesse estado, os eventos serão armazenados por até 7 dias.
Durante esse período de 7 dias, o serviço de webhook continuará tentando reenviar o evento que falhou. Se a URL responder com sucesso (status 200), ela será automaticamente reativada e o envio dos eventos armazenados será retomado. Porém, nesses casos, não garantimos a ordem exata de envio dos eventos.
Se, após 7 dias, a URL não retornar status 200, o webhook será desativado e todos os eventos em backup serão excluídos.
Após 10 Tentativas Sem Backup Ativo
Se o backup não estiver configurado, após as 3 tentativas iniciais sem sucesso, a URL será desativada imediatamente e todos os eventos serão descartados.
Obs: Você pode ativar no momento de criação de um Webhook ou ao editar o mesmo.
Ainda precisa de ajuda? Estamos prontos para te atender! 🙂
Caso ainda haja dúvidas, envie uma solicitação para nossa equipe de suporte pelo link do Formulário.
Neste link será pedido algumas informações para que sua identidade seja validada e será onde você poderá relatar o seu problema, para que assim sua dúvida seja encaminhada para a equipe de atendimento, garantindo que sua solicitação seja atendida. 😉