---
title: Inteligencia (data.ndocs)
description: La inteligencia es lo que Human Plugin te dice sobre cada persona en toda respuesta, en data.ndocs — a quién describe, qué cuenta, cuándo está ausente y cómo leerla.
canonical: https://developer.unico.io/es/human-plugin/get-started/intelligence
locale: es
generated_by: markdown-export
---

# Inteligencia

data.ndocs: lo que la misma persona ha hecho contigo, en cada respuesta.

Todo proceso finalizado te dice quién es la persona, con el Human Token, y qué ha hecho esa persona contigo, con la inteligencia en `data.ndocs`: con cuántos de tus clientes se la vio, cuántos documentos usó y cuándo.

```json
"ndocs": {
  "distinctClientsCount": 2,
  "transactionsCount": 3,
  "firstSeen": "2026-09-08",
  "lastSeen": "2026-11-03",
  "credentials": [
    { "type": "DUI_TYPE_NG_BVN", "countryCode": "NGA", "distinctCredentialCount": 1 }
  ]
}
```

| Campo | Significado |
| --- | --- |
| `distinctClientsCount` | Valores distintos de `clientId` entre los procesos de la persona |
| `transactionsCount` | Número de procesos de la persona, incluido este |
| `firstSeen`, `lastSeen` | Fechas UTC (`YYYY-MM-DD`) del proceso más antiguo y del más reciente |
| `credentials[].type` | Tipo de documento, un código del [catálogo de atributos](/es/human-plugin/additional-resources/attribute-catalog) |
| `credentials[].countryCode` | País alpha-3 que emite el documento. Ausente para un tipo que el catálogo ya no incluye |
| `credentials[].distinctCredentialCount` | Documentos distintos de ese tipo |

## Cómo leerla

Un `distinctClientsCount` mayor que 1, o un `distinctCredentialCount` mayor que 1, significa que el mismo rostro se ha usado con distintos clientes o documentos. Qué hacer con esa señal es decisión tuya.

## Qué se cuenta

Una persona se identifica por el Human Token. Solo se cuentan los procesos **finalizados** con ese token, entre todos tus client ids. Un proceso creado sin documento cuenta como una transacción y como un cliente, pero bajo ningún tipo de documento. `credentials` es `[]` cuando ninguno de los procesos de la persona tiene documento.

La inteligencia abarca los procesos de tu instalación de Human Plugin.

## De quién es la inteligencia

- **Identificación** que finalizó con un Human Token: esa persona. No cuando `data.liveness.value` es `not_live`.
- **Revalidación** con `data.humanTokenMatch` igual a `"true"`: la persona del token que enviaste en `references`. El proceso cuenta para esa persona.
- **En cualquier otro caso** (una coincidencia negativa o una captura que no es live): sin inteligencia y sin `data.ndocs`.

## Cuándo está ausente

`data.ndocs` puede faltar para una persona conocida:

- el proceso aún no ha finalizado;
- no se pudo calcular la inteligencia. La creación o la lectura igualmente tiene éxito, y un `GET` posterior lo intenta de nuevo.

No interpretes la ausencia de `data.ndocs` como que la persona nunca fue vista.

## Siguiente

[Requisitos previos y acceso](/es/human-plugin/get-started/prerequisites)