Webhooks
Entregas e novas tentativas
Política de reenvio, estados das entregas, histórico e limites.
Sucesso
Qualquer resposta 2xx em até 10 segundos confirma o recebimento. Ela significa que o destino recebeu o evento, não que a automação externa terminou. Responda rápido e faça o trabalho demorado depois.
O LiveTP lê no máximo 8 KiB da resposta. Respostas maiores são tratadas como falha de rede.
Novas tentativas
Falhas temporárias geram até sete envios em uma janela de 24 horas, contados a partir do primeiro envio:
| Tentativa | Momento aproximado |
|---|---|
| 1 | Imediatamente |
| 2 | 1 minuto |
| 3 | 5 minutos |
| 4 | 30 minutos |
| 5 | 2 horas |
| 6 | 6 horas |
| 7 | 23 horas |
Os horários têm variação aleatória de até 10%. Um header Retry-After válido é respeitado dentro da janela.
Como cada resposta é tratada
| Resposta do destino | Resultado |
|---|---|
2xx | Entregue. |
Rede, DNS, timeout, 408, 425, 429 ou 5xx | Nova tentativa, se ainda houver prazo. |
401 ou 403 | Falha, e o destino é pausado para correção. |
410 Gone | Falha, e o destino é desativado. |
Outros 4xx e qualquer 3xx | Falha definitiva. Redirecionamentos não são seguidos. |
| Endereço inseguro (IP privado, etc.) | Bloqueado, e o destino é pausado. |
Teste sem o challenge correto | Falha do teste (challenge_mismatch). |
Estados no histórico
Cada destino tem um Histórico de entregas na área logada:
| Estado | Significado |
|---|---|
| Aguardando entrega | Na fila, aguardando a primeira tentativa ou a próxima. |
| Enviando | Tentativa em andamento. |
| Recebido pelo destino | O destino respondeu 2xx. |
| Falhou | Sem novas tentativas. O motivo aparece na entrega. |
| Cancelado | O destino foi removido ou sua configuração mudou. |
Estados do destino
| Estado | Comportamento |
|---|---|
| Aguardando teste | Recém-cadastrado ou alterado. Só recebe o evento de teste. |
| Ativo | Recebe eventos. |
| Pausado | Não recebe novas tentativas. Pendências válidas são preservadas até expirar. |
| Desativado | O destino respondeu 410. Teste e ative novamente para voltar a receber. |
Trocar a URL, os eventos ou o filtro de status cancela as entregas pendentes e volta o destino para Aguardando teste. Isso evita enviar eventos antigos para um endereço novo. Veja Meu destino foi pausado.
Reenvio manual
Entregas que falharam ou foram recebidas podem ser reenviadas pelo botão Reenviar no histórico:
- O reenvio usa o mesmo ID de evento e o mesmo corpo, com timestamp e assinatura novos.
- Só vale para o destino na configuração atual e enquanto ele estiver ativo.
- O corpo fica disponível por 7 dias. Depois disso, o reenvio não é mais possível.
- Limite de 5 reenvios por minuto por conta.
Retenção
| Dado | Prazo |
|---|---|
| Corpo do evento (para reenvio) | 7 dias |
| Metadados de entregas e tentativas | 30 dias |
| Destinos removidos | 30 dias, sem segredos |
Excluir a conta remove destinos, eventos e segredos. Requisições já transmitidas não podem ser recolhidas.
Limites e concorrência
- Uma tentativa por vez para cada destino e até duas simultâneas por conta.
- Até 10 mil tentativas por dia por conta.
- Até 2 mil entregas pendentes por conta. Acima disso, novas entregas falham com
backlog_limit, sem afetar o salvamento dos roteiros. - Até 5 destinos por conta e ambiente.