---
title: Inteligência (data.ndocs)
description: A inteligência é o que o Human Plugin informa sobre cada pessoa em toda resposta, em data.ndocs — a quem ela se refere, o que conta, quando está ausente e como interpretá-la.
canonical: https://developer.unico.io/pt-BR/human-plugin/get-started/intelligence
locale: pt-BR
generated_by: markdown-export
---

# Inteligência

data.ndocs: o que a mesma pessoa já fez com você, em toda resposta.

Todo processo finalizado informa quem é a pessoa, com o Human Token, e o que essa pessoa já fez com você, com a inteligência em `data.ndocs`: com quantos dos seus clientes ela foi vista, quantos documentos usou e quando.

```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` nos processos da pessoa |
| `transactionsCount` | Número de processos da pessoa, incluindo este |
| `firstSeen`, `lastSeen` | Datas em UTC (`YYYY-MM-DD`) do processo mais antigo e do mais recente |
| `credentials[].type` | Tipo de documento, um código do [catálogo de atributos](/pt-BR/human-plugin/additional-resources/attribute-catalog) |
| `credentials[].countryCode` | País emissor do documento, em alpha-3. Ausente para um tipo que o catálogo não lista mais |
| `credentials[].distinctCredentialCount` | Documentos distintos desse tipo |

## Como interpretar

Um `distinctClientsCount` acima de 1, ou um `distinctCredentialCount` acima de 1, significa que o mesmo rosto foi usado com clientes ou documentos diferentes. O que fazer com esse sinal é decisão sua.

## O que é contado

Uma pessoa é identificada pelo Human Token. Só são contados os processos **finalizados** com esse token, em todos os seus client ids. Um processo criado sem documento conta como uma transação e como um cliente, mas sem tipo de documento. `credentials` é `[]` quando nenhum dos processos da pessoa tem documento.

A inteligência abrange os processos da sua instalação do Human Plugin.

## De quem é a inteligência

- **Identificação** finalizada com um Human Token: essa pessoa. Não quando `data.liveness.value` é `not_live`.
- **Revalidação** com `data.humanTokenMatch` igual a `"true"`: a pessoa do token que você enviou em `references`. O processo conta para essa pessoa.
- **Nos demais casos** (uma correspondência negativa, ou uma captura que não é viva): sem inteligência e sem `data.ndocs`.

## Quando está ausente

`data.ndocs` pode estar ausente para uma pessoa conhecida:

- o processo ainda não foi finalizado;
- não foi possível calcular a inteligência. A criação ou a consulta ainda é bem-sucedida, e um `GET` posterior tenta de novo.

Não interprete um `data.ndocs` ausente como uma pessoa nunca vista.

## Próximo passo

[Pré-requisitos e acesso](/pt-BR/human-plugin/get-started/prerequisites)