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:
| Tipo | Onde fica o ID da entrega |
|---|---|
| Todos | O header Dcision-Delivery. |
webhook | O id do evento. |
http, workflow, agent | O 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
| Tentativa | Quando |
|---|---|
| 1 | imediatamente |
| 2 | 30 segundos depois da primeira tentativa |
| 3 | 2 minutos depois da segunda |
| 4 | 10 minutos depois da terceira |
| 5 | 1 hora depois da quarta |
| 6 | 6 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 2xx | Entregue. |
responde 408, 425, 429 ou 5xx, estoura o tempo ou não pode ser alcançado | Nova 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 4xx | Falha 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 preenchidas | Falha 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
| Status | No app | Significado |
|---|---|---|
PENDING | enviando · tentando de novo | Aguardando a próxima tentativa. |
SENDING | enviando | Uma tentativa está em andamento. Uma tentativa interrompida por um reinício é retomada depois de 60 segundos. |
SUCCEEDED | entregue | Uma resposta 2xx. |
FAILED | falhou | Uma 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-Keyrecebe409comRetry-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.
Segredos do workspace
Mantenha tokens e URLs secretas fora das decisões — segredos do workspace referenciados como {{secrets.NAME}}, quem pode gerenciá-los, como são guardados e mascarados, e quando as mudanças valem.
Testando destinos
Veja prévias dos destinos no Playground com os segredos mascarados, execute-os de verdade com livemode false, use API keys de teste e acompanhe entregas, tentativas e respostas dos receptores.