Entrega e retries

Como a Dcision entrega webhooks, requisições de API, workflows e repasses a agentes — pelo menos uma vez, seis tentativas em cerca de sete horas, Retry-After, timeouts, status, reenvios e retenção.

Webhooks, requisições de API, workflows e agentes no modo async são entregas: a decisão responde primeiro, e a Dcision as envia em segundo plano. A resposta informa o que entrou na fila:

{ "key": "notify_sales", "type": "webhook", "status": "queued", "delivery_id": "dlv_8kJx2mQp4LzN7vR1tY6w" }

Pelo menos uma vez

Uma entrega é enviada pelo menos uma vez. Um receptor que estoura o tempo ou perde a própria resposta recebe a mesma entrega de novo, então torne os receptores idempotentes com o ID da entrega — o mesmo em toda tentativa e nos reenvios:

TipoOnde fica o ID da entrega
TodosO header Dcision-Delivery.
webhookO id do evento.
http, workflow, agentO header Idempotency-Key (a menos que você defina o seu); dcision.delivery_id em workflows, decision.delivery_id para agentes.

As entregas não são ordenadas: duas entregas da mesma decisão — ou de duas decisões — podem chegar em qualquer ordem.

Tentativas

TentativaQuando
1imediatamente
230 segundos depois da primeira tentativa
32 minutos depois da segunda
410 minutos depois da terceira
51 hora depois da quarta
66 horas depois da quinta

São 6 tentativas em cerca de 7 horas. O header Dcision-Attempt diz qual tentativa é cada requisição, e toda tentativa é assinada de novo com um timestamp novo.

O receptor…Resultado
responde 2xxEntregue.
responde 408, 425, 429 ou 5xx, estoura o tempo ou não pode ser alcançadoNova tentativa conforme o cronograma acima. Com 429 ou 503, um header Retry-After — em segundos ou como data — define a espera no lugar dele, de 1 segundo até 6 horas.
responde qualquer outro 4xxFalha na hora: corrija o destino e depois reenvie.
responde um redirecionamento (3xx)Falha na hora: redirecionamentos nunca são seguidos — use a URL final.
resolve para um endereço que não é público, ou a URL fica inválida depois que as variáveis são preenchidasFalha na hora — veja Segurança e limites.

Cada tentativa tem um prazo de 10 segundos. A Dcision lê até 64 KB da resposta e guarda o código de status, a latência e os primeiros 1.024 caracteres, que o app mostra ao lado da entrega.

Status

StatusNo appSignificado
PENDINGenviando · tentando de novoAguardando a próxima tentativa.
SENDINGenviandoUma tentativa está em andamento. Uma tentativa interrompida por um reinício é retomada depois de 60 segundos.
SUCCEEDEDentregueUma resposta 2xx.
FAILEDfalhouUma falha definitiva, ou 6 tentativas sem sucesso.

Onde acompanhá-las:

  • O resultado do Playground e os detalhes de uma execução em Execuções mostram cada destino com o status ao vivo, as tentativas, o status HTTP e a latência, a próxima tentativa e o erro — e modo de teste para entregas com livemode: false.
  • A Visão geral da decisão conta as entregas entregues, falhas e pendentes por destino.

Todos no workspace podem ver as entregas; o app nunca mostra o body delas — só uma prévia mascarada da requisição.

Reenviar uma entrega que falhou

Reenviar numa entrega que falhou (Membros, Admins e o Proprietário) a coloca de novo na fila com 6 novas tentativas e o mesmo ID de entrega, para que um receptor que já a processou ainda consiga deduplicar.

A requisição renderizada — com os seus secrets — fica guardada criptografada enquanto a entrega pode precisar dela: é apagada quando a entrega tem sucesso e mantida nas que falharam, para que possam ser reenviadas. Um reenvio manda essa mesma requisição: uma mudança no destino ou num secret vale para novas execuções da decisão, não para reenvios.

Ritmo e limites

  • Um workspace envia até 600 entregas por minuto. As entregas acima disso esperam o minuto seguinte sem gastar uma tentativa.
  • A resposta não espera as entregas: elas entram na fila junto com a execução e começam na hora, em segundo plano.
  • Se uma entrega não puder entrar na fila de jeito nenhum (a fila está indisponível), a entrada dela diz "status": "skipped", "reason": "unavailable", e a decisão responde mesmo assim.

Retenção

Entregas finalizadas — com sucesso ou com falha — são apagadas 30 dias depois de criadas, qualquer que seja a retenção do log de execuções do workspace. Apagar uma decisão não cancela as entregas já na fila: elas terminam as tentativas e expiram com as demais. Apagar o workspace apaga todas elas.

Idempotência e replays

  • Um replay idempotente devolve a resposta guardada com os mesmos IDs de entrega, e nada é entregue de novo.
  • Uma requisição que ainda está rodando com o mesmo Idempotency-Key recebe 409 com Retry-After: 1 — ela nunca roda, nem entrega, duas vezes.
  • Um fallback por erro de engine não é guardado para idempotência: um retry roda a decisão de novo e coloca novas entregas na fila, com novos IDs.

Nesta página