Webhooks
Entregas e retentativas
Como a Oneos entrega, quando tenta de novo e o que fazer quando uma entrega falha.
O que conta como sucesso
Qualquer resposta 2xx em até 10 segundos. Todo o
resto é falha: 3xx (redirecionamento não é seguido), 4xx, 5xx, timeout e erro de
conexão.
As entregas saem em lotes, a cada minuto — um evento pode levar até cerca de um minuto para a primeira tentativa.
Retentativas
- 1 imediata
- 2 +1 min
- 3 +5 min
- 4 +30 min
- 5 +2 h
- 6 +8 h
- 7 +24 h
- Falhou
A primeira tentativa é imediata; as seguintes esperam cada vez mais. Uma URL que passe a apontar para endereço não público falha na hora, sem retentativas.
Status de uma entrega
| Status | Na plataforma | Significa |
|---|---|---|
PENDING | Pendente | Na fila para a primeira tentativa. |
RETRYING | Reenviando | Falhou e vai tentar de novo. |
SUCCESS | Sucesso | Seu endpoint respondeu 2xx. |
FAILED | Falhou | Esgotou as tentativas. Pode ser reenviada manualmente. |
Reenviar manualmente
Em Minha empresa › Webhooks › Entregas, entregas com Falhou têm o botão
Reenviar: a entrega volta para a fila com o mesmo id e o mesmo corpo, e ganha um novo ciclo de
tentativas. Em Detalhes você vê o corpo enviado e a resposta de cada tentativa. O histórico fica
disponível por 90 dias.
Pausar sem perder
Desligar Entregas ativadas segura as entregas que já estavam na fila até você reativar — mas eventos que acontecerem com o endpoint pausado não são registrados para você.
Ordem e duplicidade
- A ordem não é garantida. Retentativas se misturam com eventos novos. Use o
createdAt. -
Um evento pode chegar mais de uma vez — num reenvio manual, ou se a sua resposta 2xx se perder no caminho.
Deduplique pelo
id.