> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Investigator : revue IA KYC, AML et dossiers

> Didit Investigator rédige un rapport sourcé pour chaque vérification, alerte et dossier, et vous fixez son niveau d'autonomie.

> [!WARNING]
>
> L'Investigateur est récent et n'est pas encore activé pour toutes les organisations. Demandez à Didit de l'activer. Il nécessite le forfait Growth ou supérieur, et il ne fonctionne jamais sur les applications sandbox.

L'Investigateur examine les éléments qui attendent l'intervention d'une personne. Pour chacun, il lit l'enregistrement, rédige un rapport contenant une recommandation et les éléments de preuve qui la justifient, puis attend la décision de votre réviseur ou, si vous l'y autorisez, décide seul.

## Ce qu'il examine

| File d'attente | Élément | Démarre quand |
| - | - | - |
| KYC | Une session de vérification | La session passe à **En cours d'examen**. |
| KYB | Une vérification d'entreprise | La session passe à **En cours d'examen**. |
| AML | Une session avec une correspondance issue de la surveillance AML continue | Une nouvelle correspondance arrive. |
| Transactions | Une alerte sur transaction | La transaction passe à **En cours d'examen**. |
| Dossiers | Un dossier | Le dossier est ouvert ou rouvert. |

Si votre équipe tranche d'abord l'élément, l'exécution de l'Investigateur se termine sans décision.

## Le rapport

Chaque rapport contient :

* une **recommandation** : approuver, refuser, demander des informations complémentaires (nouvelle soumission pour une vérification, attente de l'utilisateur pour une transaction) ou escalader,
* un **niveau de confiance** : élevé, moyen ou faible,
* un résumé et le raisonnement,
* des **éléments de preuve** : chaque point est marqué comme conforme, comme un risque, comme à vérifier, comme expliqué ou comme contexte, et cite ses sources,
* pour les correspondances de filtrage, si chaque correspondance concerne la même personne, ne concerne pas la même personne ou reste incertaine,
* des prochaines étapes suggérées, comme l'ouverture d'un enregistrement lié ou d'un dossier.

### Sources citées

L'Investigateur lit les mêmes données que vos réviseurs voient dans la console et dans l'API : la décision de vérification, la décision de vérification d'entreprise, le détail de la transaction ou le détail du dossier. Il peut aussi ouvrir les sessions, transactions et dossiers liés. Chaque élément de preuve cite la section de l'enregistrement qu'il a lue, ou l'enregistrement lié qu'il a ouvert. Le rapport affiche aussi **Ce que j'ai vérifié** : la vue d'ensemble, les sections et les enregistrements lus, dans l'ordre.

Il ne travaille qu'à partir de cet enregistrement. Avant que l'enregistrement n'atteigne le modèle, Didit supprime les médias, les liens et les identifiants internes, et masque les caractéristiques protégées. L'Investigateur ne peut pas modifier les données. Il se contente de rédiger son rapport.

## Étapes

| Étape | Ce qui se passe | Facturé |
| - | - | - |
| **Non configuré** | L'Investigateur ne s'exécute pas. | Non |
| **Mode observation** | Il rédige des rapports et évalue ses résultats en les comparant aux décisions de votre équipe. Les réviseurs décident comme d'habitude. | Non |
| **L’automatisation est active** | Les rapports apparaissent pour les réviseurs, et les files d'attente peuvent décider seules au niveau d'autonomie que vous choisissez. | Oui |

Exécutez le mode observation pendant 7, 14 (par défaut) ou 30 jours avant la mise en service. La configuration, le mode observation et les tests rétrospectifs ne sont jamais facturés.

## Niveaux d'autonomie

Définissez un niveau d'autonomie pour chaque file d'attente :

| Niveau | Ce qu'il fait |
| - | - |
| **Désactivé** | Les éléments arrivent aux réviseurs sans rapport. |
| **Suggérer** (par défaut) | Il prépare le rapport. Une personne décide de chaque élément. |
| **Automatique** | Il décide des éléments couverts par votre politique, avec une confiance **élevée**, lorsque sa concordance passée avec votre équipe atteint le seuil de la file d'attente. |
| **Entièrement automatique** | Il décide aussi des éléments à confiance **moyenne**. Un échantillon reste transmis à une personne pour les contrôles qualité. |

L'Investigateur ne décide seul que si toutes les conditions suivantes sont réunies :

* l'application est en production et la file d'attente est sur **Automatique** ou **Entièrement automatique**, et n'est pas suspendue,
* la politique de votre équipe couvre l'élément et prévoit de suivre la recommandation,
* aucun garde-fou ne bloque l'élément,
* sa concordance avec les décisions passées de votre équipe atteint le seuil, sur au moins 20 décisions au cours des 90 derniers jours,
* l'élément n'est pas retenu dans l'échantillon qualité, se trouve dans la proportion du déploiement, et la limite quotidienne n'est pas atteinte.

| Paramètre de file | Valeurs |
| - | - |
| Seuil | 80, 85, 90 (par défaut) ou 95% de concordance |
| Échantillon qualité | 2, 5 (par défaut) ou 10% des éléments tranchés sont transmis à une personne |
| Limite quotidienne | 200 éléments par jour par défaut |
| Déploiement | Progressif (25% des éléments pendant 14 jours) ou tous les éléments |
| Plafond de montant | Les transactions au-dessus de ce plafond sont toujours transmises à une personne. Par défaut 25 000 dans la devise de votre application. |
| Passer automatiquement au niveau supérieur | Passer au niveau supérieur lorsque la concordance atteint 98% |

Pour passer une file d'attente sur **Automatique** ou **Entièrement automatique**, vous devez d'abord exécuter un test rétrospectif sur les décisions passées et valider le résultat. Les files **Dossiers** et **AML** ne sont jamais acceptées par lot, et les dossiers escaladés ou les dossiers en attente d'un second réviseur ne sont jamais tranchés automatiquement.

## Garde-fous

Ces règles sont toujours actives et ne peuvent pas être modifiées :

* Les correspondances avec des sanctions sont toujours transmises à une personne.
* Les motifs liés à la fraude et à l'AML ne parviennent jamais aux utilisateurs finaux.
* Aucune décision ne repose sur des caractéristiques protégées.
* L'Investigateur ne dépose jamais de déclaration réglementaire.
* Chaque décision est journalisée et peut être remplacée.

## Examiner un rapport

Sur **Suggérer**, un réviseur peut :

* **Accepter** la recommandation,
* **Modifier et accepter** la recommandation,
* **Remplacer** la recommandation, en indiquant une catégorie (contexte manquant, informations nécessaires, politique différente, élément de preuve mal interprété, autre) et un motif de 10 à 500 caractères,
* **Accepter en lot** jusqu'à 50 éléments marqués **Prêts à accepter**.

L'acceptation d'une recommandation applique la décision par le circuit habituel de l'élément, de sorte que vos webhooks et notifications habituels se déclenchent. Une escalade ouvre un dossier lié. Une décision prise par l'Investigateur porte la mention **Tranché par l'Investigateur** sur l'élément.

## Politique d'équipe

Chaque file d'attente dispose d'une politique d'équipe : vos règles sur ce qu'il faut approuver, refuser ou escalader. L'Investigateur la suit, et il ne décide seul que lorsque la politique couvre l'élément. Les politiques sont versionnées. L'onglet **Questions** recense les points que votre équipe doit clarifier.

## Piste d’audit

L’onglet **Activité** enregistre chaque rapport, acceptation, modification, substitution, décision automatique, blocage par une règle de garde et modification des paramètres, avec l’auteur de l’action : l’enquêteur, une personne, une clé API ou le système. Les entrées ne peuvent pas être modifiées. Exportez jusqu’à 10 000 entrées au format CSV.

Chaque décision que l’enquêteur prend de manière autonome est également inscrite dans le [journal d’audit](https://docs.didit.me/fr/console/audit-logs.md) de votre organisation, sous **L’enquêteur** et liée à son rapport, à côté des actions de vos membres et de vos clés API.

## Tarifs

L’enquêteur a un seul tarif : **\$0.20 par vérification examinée (KYC, KYB ou correspondance AML), alerte de transaction ou dossier**. Pour ce prix, il lit le dossier, rédige un rapport sourcé avec sa recommandation, puis le transmet à votre réviseur ou décide de manière autonome dans le cadre de votre politique.

| Élément examiné | Prix |
| - | - |
| Vérification (KYC, KYB ou correspondance AML), alerte de transaction ou dossier | \$0.20 |

Vous êtes facturé une seule fois par élément, uniquement lorsque l’application est en production et que le rapport est accepté, ou modifié puis accepté, ou lorsque l’enquêteur décide de manière autonome. Les substitutions, les éléments sur lesquels votre équipe a pris une décision ailleurs, les exécutions échouées, le mode fantôme, la configuration et les rétrotests sont gratuits. Les remises du forfait s’appliquent.

Vous pouvez définir un plafond de dépenses mensuel facultatif dans **Paramètres**. Une fois ce plafond atteint, les nouveaux éléments parviennent aux réviseurs sans rapport.

## API et webhooks

L’API de l’enquêteur se trouve sous `https://verification.didit.me/v3/investigator/` et utilise la clé API de votre application (`x-api-key`).

| Endpoint | Usage |
| - | - |
| `GET summary/`, `GET queue/` | Nombre d’éléments en file d’attente et éléments en attente. |
| `GET runs/{id}/` | Un rapport. |
| `POST runs/{id}/accept/`, `POST runs/{id}/override/`, `POST runs/batch-accept/` | Agir sur les rapports. |
| `GET transactions/{id}/` | Le rapport d’une transaction. |
| `GET dashboard/`, `GET performance/`, `GET activity/`, `GET activity/export/` | Résultats et piste d’audit. |
| `GET guardrails/` | Les règles de garde verrouillées. |
| `GET` / `PATCH settings/` | Étape et plafond de dépenses mensuel. |

Une clé API restreinte a besoin du périmètre `decisions` pour lire et traiter les rapports, et du périmètre `applications` pour lire ou modifier les paramètres. Les rapports de transaction nécessitent également le périmètre `transactions`. Les clés limitées à certains workflows ou à des sessions approuvées sont refusées, car la file d’attente couvre tous les workflows. Le schéma complet des requêtes et des réponses se trouve dans [`openapi-25.json`](https://docs.didit.me/openapi-25.json), sous l’étiquette **Investigator**.

Il n’existe pas de webhook distinct pour l’enquêteur. Le champ `decision` d’un [webhook `status.updated`](https://docs.didit.me/fr/integration/webhooks#bloc-investigator) et de la réponse de `GET /v3/session/{id}/decision/` contient un bloc `investigator` avec le `status`, la `recommendation`, la `confidence`, le `summary`, le `ready_to_accept`, l’`automated` et le `decided_by` (`investigator` ou `member`) de l’exécution.

## Liens connexes

> [card] [Examen manuel](https://docs.didit.me/fr/console/manual-review.md)
>
> Comment votre équipe examine les sessions de vérification.

> [card] [Dossiers](https://docs.didit.me/fr/console/case-management/cases.md)
>
> Gestion des dossiers pour les alertes et les enquêtes.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.