Revisión Manual
Una decision igual a in_review significa que una persona en Inyo decide el resultado. No es una falla y no es una respuesta final, y puede llegar por cualquiera de los puntos de entrada — incluida una verificación server-to-server, cuya evaluación puede terminar en él como cualquier otra.
La revisión manual existe solo en el decisionamiento gestionado. Bajo decisionamiento no gestionado no hay campo decision, nada se encola, y esta página no le aplica.
Por Qué una Verificación Está in_review
Su cuenta define qué franjas de puntuación van a un revisor. Nada se encola salvo que usted lo pida — por defecto la verificación es final tal como fue puntuada.
El status de la sesión es completed todo el tiempo: terminó, y solo la decision está pendiente.
decision | Qué ocurrió |
|---|---|
in_review | La sesión cayó en una franja que usted pidió revisar. Una persona está decidiendo |
approved / declined / inconclusive | O la puntuación lo resolvió, o lo resolvió un revisor — el campo se lee igual en ambos casos |
Qué franjas van a revisión se define para su cuenta — hable con su contacto en Inyo para cambiarlo.
El Índice de Confianza
Todo resultado lleva trustIndex, la puntuación de la verificación de 0 a 100. Los límites contra los que se puntúa son configuración de su cuenta y no se publican en el resultado.
El severity en cada fila de verificación — critical, high, medium o low, de la más pesada a la más liviana — nombra cuánto pesa esa verificación. Tanto los pesos como los límites se definen para su cuenta y pueden cambiar, así que lea decision para el resultado en vez de derivarlo de la puntuación.
Cómo le Llega la Decisión
Cuando un analista decide, el resultado almacenado se actualiza en el mismo lugar y se reenvía.
| Canal | Comportamiento |
|---|---|
| Webhook | Con un webhookUrl configurado, el resultado decidido se envía por POST a esa URL — firmado exactamente como cualquier otra entrega. Esto también cubre las sesiones en modo redirección y las verificaciones server-to-server, mediante las notificaciones de resultado |
| Lectura | GET /v1/sessions/{sessionId} para una sesión de widget, GET /v1/verifications/{verificationId} para una verificación, cada uno devolviendo el status y el result actuales. Es lo que tiene si no tiene un webhookUrl |
La decision cambia de in_review al resultado del revisor. Nada más del payload cambia de forma:
{
"sessionId": "9f1c8e42-7c3e-4f2b-9d7a-2b1e5c8f4a10",
"status": "completed",
"decision": "approved",
"notifiedAt": "2026-07-31T14:41:09.882Z"
}
El resultado no dice quién decidió ni por qué. Ese registro se conserva y está disponible para el personal de Inyo que atiende una consulta sobre la sesión — no forma parte del payload entregado al tenant.
Los Resultados Completados Pueden Cambiar
Una verificación cuya decision ya dice approved o declined puede revertirse más tarde mediante un override de control de calidad. Llega por el mismo canal, como una nueva decision en la misma sesión.
Por eso importa el orden: aplique el notifiedAt más alto e ignore cualquier cosa anterior (vea Recepción de Resultados). Una sesión puede tener dos entregas en curso a la vez — una todavía reintentándose mientras se despacha una decisión más reciente.
Qué Construir
| Requisito | Por qué |
|---|---|
| Un estado pendiente en su propio modelo, distinto de aprobado y rechazado | in_review no es ninguno de los dos, y su cliente puede estar esperando en una página de destino que lo recibió |
Un manejador de resultados idempotente con clave en sessionId, que resuelva por notifiedAt | El resultado de la misma sesión llega legítimamente más de una vez |
| La capacidad de revertir una decisión sobre la que ya actuó | Un override de control de calidad puede invertir un resultado completado |
Implemente el estado pendiente aunque no envíe nada a revisión: una verificación completada todavía puede reabrirse por una corrección de calidad, que llega como in_review.
Próximos Pasos
- Verificaciones y Decisiones — cada verificación y cuánto cuesta una falla de cada una
- Recepción de Resultados — entrega, firmas y ordenamiento