Pular para o conteúdo
  • Não há sugestões porque o campo de pesquisa está em branco.

Regras de ativação, desativação e Backup de um Webhook - Developer Hub

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

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 à nossa equipe de suporte por meio do link do formulário.

Neste link, serão solicitadas algumas informações para validar sua identidade. É por meio dele que você poderá relatar seu problema, permitindo que sua dúvida seja encaminhada à equipe de atendimento e garantindo que sua solicitação seja devidamente atendida. 😉