Configuración de flujos

Un proyecto tiene una configuración de flujo: qué pasos corre, en qué orden, con qué parámetros y qué hacer cuando algo falla. Se arma desde el dashboard; esta página documenta el modelo que hay abajo, para que sepas exactamente qué significa cada opción.

Versionado y congelamiento

Cada vez que publicás, se crea una versión (cfg_00000003) que queda inmutable. Cada sesión se ata a la versión activa en su modo al momento de crearse.

Consecuencias que conviene tener presentes:

• cambiar el flujo no afecta a las sesiones en curso ni a las ya resueltas;
• el costo en tokens se congela con la versión: una sesión se cobra al precio vigente cuando se publicó ese flujo;
• las opciones de payload de webhook también se leen de la versión congelada de esa sesión, no de la configuración actual del proyecto;
• un proyecto tiene punteros independientes para test y para live: podés probar una versión nueva sin tocar producción.

Estructura de una configuración

webhookPayload

Cuatro interruptores, todos apagados por defecto. Controlan qué sale en los eventos — ver Eventos y payload.

Parámetros de cada paso

document_ar

face_liveness

otp_email

otp_whatsapp

form

choice

Reglas condicionales

Una regla dice: cuando el paso X termina con el resultado R, hacé A.

{
  "when": { "step": "documento", "result": "review" },
  "then": { "goto": "verificacion-extra", "resume": true }
}

when

then

Exactamente una de estas cinco acciones:

Pasos condicionales

Un paso puede declararse con entrada conditional: entonces sólo es alcanzable por una regla goto, y no puede estar en flow.sequence. Es la forma de definir ramas de excepción —una verificación extra que sólo corre cuando algo salió raro— sin que se ejecuten en el camino feliz.

Qué valida la plataforma al publicar

Además del schema, se valida la estructura del grafo. Una configuración que no pasa estas reglas no se puede publicar:

Un paso alcanzado por un goto sin resume tiene una exigencia extra: como no hereda continuación, cada uno de los cuatro resultados posibles necesita su propia regla que encamine el flujo (goto sin resume, reject o review). Si sólo cubrís el caso de fallo, la rama "aprueba y sigue" queda sin salida y la configuración se rechaza. La forma más simple de evitarlo es usar resume: true.

Ejemplo completo

Un flujo con documento y biometría, donde un documento dudoso suma una verificación por WhatsApp antes de decidir:

{
  "schemaVersion": 2,
  "version": 3,
  "name": "Onboarding estándar",
  "steps": [
    {
      "id": "documento",
      "type": "document_ar",
      "params": {
        "acceptedDocs": ["dni_card", "passport"],
        "rejectExpired": true,
        "padronCrossCheck": true,
        "padronUnavailablePolicy": "review",
        "nameMatchThreshold": 0.85,
        "maxCaptureAttempts": 3
      }
    },
    {
      "id": "selfie",
      "type": "face_liveness",
      "params": {
        "challenge": "FaceMovementAndLightChallenge",
        "livenessThreshold": 85,
        "compareFaces": { "autoApprove": 92, "reviewBand": [80, 92] },
        "maxAttempts": 3
      }
    },
    {
      "id": "otp-refuerzo",
      "type": "otp_whatsapp",
      "params": {
        "entry": "conditional",
        "ttlMinutes": 5,
        "maxAttempts": 5,
        "collectIfMissing": true
      }
    }
  ],
  "flow": {
    "sequence": ["documento", "selfie"],
    "rules": [
      {
        "when": { "step": "documento", "result": "review" },
        "then": { "goto": "otp-refuerzo", "resume": true }
      },
      {
        "when": { "step": "selfie", "result": "retries_exhausted" },
        "then": { "review": true }
      }
    ]
  },
  "expiration": { "linkTtlHours": 48, "sessionIdleMinutes": 30 },
  "review": { "enabled": true, "slaHours": 24 },
  "webhookEvents": [
    "verification_session.approved",
    "verification_session.rejected"
  ],
  "webhookPayload": { "documentData": true }
}

Con la matriz de costos por defecto, ese flujo presupuesta 12 tokens: document_ar (5) + face_liveness (5) + el destino de la regla goto, otp_whatsapp (2). El paso condicional se cobra aunque no siempre corra: el presupuesto es de peor caso. Ver Prueba y producción.