Entrega e repetição
Entrega, tentativas e pausa automática
Uma entrega falhada (resposta não 2xx, tempo esgotado ou erro de rede) é repetida com backoff exponencial: 5s, 30s, 2min, 10min, 1h, 4h, e depois uma tentativa final cerca de 24 horas após a primeira. Se um endpoint falhar por 72 horas contínuas, ele é pausado automaticamente e seu criador é notificado por e-mail — nenhum evento adicional é entregue até que seja corrigido e retomado.
Solucionando problemas de entrega
Resultados de resposta comuns e como corrigir cada um.
Não é possível conectar | Certifique-se de que seu host esteja publicamente acessível e não bloqueado por um firewall. |
Redirecionamento 3xx | Redirecionamentos são tratados como falhas. Aponte o endpoint diretamente para a URL final. |
Erro de cliente 4xx | Seu servidor rejeitou a requisição. Verifique se a URL está correta e não exige uma autenticação que não enviamos. |
Erro de servidor 5xx | Seu servidor apresentou erro ao processar a requisição. Verifique os logs da sua aplicação. |
Tempo esgotado | Seu endpoint demorou demais. Retorne um 2xx imediatamente e processe o evento de forma assíncrona. |
A ordem dos eventos não é garantida
Os eventos podem chegar fora de ordem, e as novas tentativas significam que o mesmo evento pode ser entregue mais de uma vez. Não dependa da ordem de entrega e elimine duplicatas pelo id do envelope — nunca por created_at, já que dois eventos podem compartilhar um timestamp.
Repetição
Qualquer entrega individual — bem-sucedida ou falhada — pode ser repetida sob demanda a partir do histórico de entregas em Configurações → Desenvolvedor → Webhooks. Uma repetição reentra no mesmo pipeline de entrega com um novo ciclo de tentativas; ela não reenvia nada retroativamente por conta própria.
Testando seu endpoint
Use "Enviar evento de teste" em Configurações → Desenvolvedor → Webhooks para disparar um evento sintético ping.sent através do pipeline de entrega real — assinado da mesma forma que qualquer outro evento — para que você possa verificar seu endpoint sem esperar que um evento real aconteça.