Entrega y reintentos

Cómo Dcision entrega webhooks, solicitudes a APIs, workflows y traspasos a agentes — al menos una vez, seis intentos en unas siete horas, Retry-After, timeouts, estados, reenvíos y retención.

Los webhooks, las solicitudes a APIs, los workflows y los agentes en modo async son entregas: la decisión responde primero y Dcision las envía en segundo plano. La respuesta te dice qué se encoló:

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

Al menos una vez

Una entrega se envía al menos una vez. Un receptor que agota el tiempo o pierde su respuesta recibe la misma entrega de nuevo, así que haz que los receptores sean idempotentes con el ID de la entrega, que es el mismo en cada intento y en los reenvíos:

TipoDónde está el ID de la entrega
TodosEl header Dcision-Delivery.
webhookEl id del evento.
http, workflow, agentEl header Idempotency-Key (a menos que definas el tuyo); dcision.delivery_id en workflows, decision.delivery_id para agentes.

Las entregas no están ordenadas: dos entregas de la misma decisión —o de dos decisiones— pueden llegar en cualquier orden.

Intentos

IntentoCuándo
1de inmediato
230 segundos después del primer intento
32 minutos después del segundo
410 minutos después del tercero
51 hora después del cuarto
66 horas después del quinto

Son 6 intentos en unas 7 horas. El header Dcision-Attempt indica cuál es cada solicitud, y cada intento se vuelve a firmar con un timestamp nuevo.

El receptor…Resultado
responde 2xxEntregado.
responde 408, 425, 429 o 5xx, agota el tiempo o no es alcanzableSe reintenta según el calendario anterior. Con 429 o 503, un header Retry-After —en segundos o como fecha— define la espera en su lugar, de 1 segundo hasta 6 horas.
responde cualquier otro 4xxFalla de inmediato: corrige el destino y luego reenvía.
responde una redirección (3xx)Falla de inmediato: las redirecciones nunca se siguen; usa la URL final.
resuelve a una dirección que no es pública, o la URL no es válida una vez completadas las variablesFalla de inmediato; consulta Seguridad y límites.

Cada intento tiene un plazo de 10 segundos. Dcision lee hasta 64 KB de la respuesta y guarda su código de estado, la latencia y sus primeros 1,024 caracteres, que la app muestra junto a la entrega.

Estados

EstadoEn la appSignificado
PENDINGenviando · reintentandoEsperando su próximo intento.
SENDINGenviandoHay un intento en curso. Un intento interrumpido por un reinicio se retoma después de 60 segundos.
SUCCEEDEDentregadoUna respuesta 2xx.
FAILEDfallóUna falla definitiva, o 6 intentos sin éxito.

Dónde seguirlos:

  • El resultado del Playground y los detalles de una ejecución en Ejecuciones muestran cada destino con su estado en vivo, los intentos, el estado HTTP y la latencia, el próximo intento y el error, y modo de prueba para las entregas con livemode: false.
  • El Resumen de la decisión cuenta las entregas entregadas, fallidas y pendientes por destino.

Todos en el workspace pueden ver las entregas; la app nunca muestra su cuerpo, solo una vista previa enmascarada de la solicitud.

Reenvía una entrega fallida

Reenviar en una entrega fallida (Miembros, Administradores y el Propietario) la vuelve a encolar con 6 intentos nuevos y el mismo ID de entrega, para que un receptor que sí la procesó todavía pueda deduplicarla.

La solicitud renderizada —con sus secretos— se guarda cifrada mientras una entrega pueda necesitarla: se elimina cuando la entrega tiene éxito y se conserva para las fallidas, para que puedan reenviarse. Un reenvío envía esa misma solicitud: un cambio en el destino o en un secreto se aplica a las nuevas ejecuciones de la decisión, no a los reenvíos.

Ritmo y límites

  • Un workspace envía hasta 600 entregas por minuto. Las que superan esa cifra esperan al minuto siguiente sin gastar un intento.
  • La respuesta no espera a las entregas: se encolan con la ejecución y empiezan de inmediato, en segundo plano.
  • Si una entrega no se puede encolar en absoluto (la cola no está disponible), su entrada dice "status": "skipped", "reason": "unavailable", y la decisión responde igualmente.

Retención

Las entregas terminadas —exitosas o fallidas— se eliminan 30 días después de crearse, sea cual sea la retención del log de ejecuciones del workspace. Eliminar una decisión no cancela las entregas ya encoladas: terminan sus intentos y expiran con las demás. Eliminar el workspace las elimina todas.

Idempotencia y repeticiones

  • Una repetición idempotente devuelve la respuesta guardada con los mismos IDs de entrega, y no se vuelve a entregar nada.
  • Una solicitud que todavía se está ejecutando con el mismo Idempotency-Key recibe 409 con Retry-After: 1: nunca se ejecuta, ni entrega, dos veces.
  • Un fallback por error del motor no se guarda para idempotencia: un reintento vuelve a ejecutar la decisión y encola entregas nuevas, con IDs nuevos.

En esta página