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:
| Tipo | Dónde está el ID de la entrega |
|---|---|
| Todos | El header Dcision-Delivery. |
webhook | El id del evento. |
http, workflow, agent | El 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
| Intento | Cuándo |
|---|---|
| 1 | de inmediato |
| 2 | 30 segundos después del primer intento |
| 3 | 2 minutos después del segundo |
| 4 | 10 minutos después del tercero |
| 5 | 1 hora después del cuarto |
| 6 | 6 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 2xx | Entregado. |
responde 408, 425, 429 o 5xx, agota el tiempo o no es alcanzable | Se 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 4xx | Falla 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 variables | Falla 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
| Estado | En la app | Significado |
|---|---|---|
PENDING | enviando · reintentando | Esperando su próximo intento. |
SENDING | enviando | Hay un intento en curso. Un intento interrumpido por un reinicio se retoma después de 60 segundos. |
SUCCEEDED | entregado | Una respuesta 2xx. |
FAILED | falló | 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-Keyrecibe409conRetry-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.
Secretos del workspace
Mantén los tokens y las URLs secretas fuera de las decisiones — secretos del workspace referenciados como {{secrets.NAME}}, quién puede gestionarlos, cómo se guardan y ocultan, y cuándo se aplican los cambios.
Probar destinos
Previsualiza los destinos en el Playground con los secretos ocultos, ejecútalos de verdad con livemode false, usa claves de API de prueba y sigue las entregas, los intentos y las respuestas de los receptores.