Despachar Actividad de Tarea

POST /api/activities/tasks/:id/dispatch

Despacha manualmente una actividad TASK a un proveedor externo. La actividad debe estar en estado Lista(READY)Actividad está completamente resuelta y lista para accionar. Si el cliente tiene configurado un proveedor para hacer dispatch de las actividades, la próxima acción del sistema intenta despachar, de lo contrario la actividad permanece READY y podrá ser accionada desde la plataforma interna por algún operador. (ver Activity States para el state machine completo).

Auth: Requerida — permiso DISPATCH_ACTIVITY

Parámetros de Ruta

Ejemplo

curl -X POST https://api.reten.ai/api/activities/tasks/ee0e8400-e29b-41d4-a716-446655440000/dispatch \
  -H "Authorization: Bearer <token>" \
  -H "x-tenant-id: <tenant-id>"

const taskId = "ee0e8400-e29b-41d4-a716-446655440000";
const response = await fetch(`https://api.reten.ai/api/activities/tasks/${taskId}/dispatch`, {
  method: "POST",
  headers: {
    "Authorization": "Bearer <token>",
    "x-tenant-id": "<tenant-id>",
  },
});
// 204 No Content on success

import requests

task_id = "ee0e8400-e29b-41d4-a716-446655440000"
response = requests.post(
    f"https://api.reten.ai/api/activities/tasks/{task_id}/dispatch",
    headers={
        "Authorization": "Bearer <token>",
        "x-tenant-id": "<tenant-id>",
    },
)
# 204 No Content on success

Respuesta 204 Sin Contenido

Sin cuerpo de respuesta. El estado de la actividad pasa a Despachada(DISPATCHED)Actividad fue entregada al proveedor externo. Aplica únicamente cuando el cliente tiene un proveedor de dispatch configurado para la actividad; clientes que operan exclusivamente desde la plataforma interna de Reten no transitan por este estado. Tener proveedor de dispatch no impide que el resultado se registre desde la plataforma interna: el outcome puede llegar tanto desde el proveedor externo como desde la plataforma interna. en caso de éxito.

Respuestas de Error

Notas

• Utiliza bloqueo optimista para evitar despachos concurrentes
• En caso de fallo, reintenta hasta 3 veces antes de marcar como Fallida(FAILED)Actividad alcanzó un estado terminal fallido por una de dos vías: (a) los intentos de dispatch se agotaron sin éxito; o (b) un proceso de cierre de fin de día detectó una actividad que quedó reintentando, y la marcó como FAILED con resultado NOT_EXECUTED. Aunque es terminal, una actividad FAILED puede recuperarse manualmente vía endpoint dedicado, que la reintenta una vez; el intento puede terminar en DISPATCHED, RETRYING o nuevamente FAILED.
• Las credenciales se descifran únicamente durante la ejecución del despacho