---
title: Intelligence (data.ndocs)
description: L'intelligence est ce que Human Plugin vous indique sur chaque personne dans chaque réponse, dans data.ndocs — qui elle décrit, ce qu'elle compte, quand elle est absente et comment la lire.
canonical: https://developer.unico.io/fr/human-plugin/get-started/intelligence
locale: fr
generated_by: markdown-export
---

# Intelligence

data.ndocs : ce que la même personne a fait chez vous, dans chaque réponse.

Chaque processus terminé vous indique qui est la personne, avec le Human Token, et ce qu'elle a fait chez vous, avec l'intelligence dans `data.ndocs` : avec combien de vos clients elle a été vue, combien de documents elle a utilisés, et quand.

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

| Champ | Signification |
| --- | --- |
| `distinctClientsCount` | Valeurs `clientId` distinctes parmi les processus de la personne |
| `transactionsCount` | Nombre de processus de la personne, celui-ci inclus |
| `firstSeen`, `lastSeen` | Dates UTC (`YYYY-MM-DD`) du processus le plus ancien et du plus récent |
| `credentials[].type` | Type de document, un code du [catalogue d'attributs](/fr/human-plugin/additional-resources/attribute-catalog) |
| `credentials[].countryCode` | Pays émetteur du document (alpha-3). Absent pour un type que le catalogue ne répertorie plus |
| `credentials[].distinctCredentialCount` | Documents distincts de ce type |

## La lire

Un `distinctClientsCount` supérieur à 1, ou un `distinctCredentialCount` supérieur à 1, signifie que le même visage a été utilisé avec des clients ou des documents différents. Que faire de ce signal reste votre décision.

## Ce qui est compté

Une personne est identifiée par le Human Token. Seuls les processus **terminés** portant ce token sont comptés, pour tous vos identifiants de client. Un processus créé sans document compte comme une transaction et comme un client, mais sous aucun type de document. `credentials` vaut `[]` lorsqu'aucun des processus de la personne n'a de document.

L'intelligence couvre les processus de votre installation de Human Plugin.

## De qui est l'intelligence

- **Identification** terminée avec un Human Token : cette personne. Pas lorsque `data.liveness.value` est `not_live`.
- **Revalidation** avec `data.humanTokenMatch` égal à `"true"` : la personne du token que vous avez envoyé dans `references`. Le processus compte pour cette personne.
- **Sinon** (une correspondance négative, ou une capture qui n'est pas live) : pas d'intelligence, et pas de `data.ndocs`.

## Quand elle est absente

`data.ndocs` peut manquer pour une personne connue :

- le processus n'est pas encore terminé ;
- l'intelligence n'a pas pu être calculée. La création ou la lecture réussit quand même, et un `GET` ultérieur réessaie.

Ne lisez pas un `data.ndocs` manquant comme une personne jamais vue.

## Suite

[Prérequis et accès](/fr/human-plugin/get-started/prerequisites)