---
title: Webhooks et événements
description: Introduction aux webhooks IDCloud — recevez des notifications en temps réel pour les événements de processus de vérification d'identité.
canonical: https://developer.unico.io/fr/dual-api/developers/webhooks-and-events/
locale: fr
generated_by: markdown-export
---

Un **webhook** est un service de notification systémique qui permet une intégration asynchrone entre systèmes — Unico IDCloud notifie votre backend à chaque changement d'état d'un processus, vous évitant ainsi d'avoir à interroger les mises à jour.

Cette section couvre les quatre éléments nécessaires à l'intégration des webhooks : comment **configurer** le point de terminaison et l'authentification, les **événements** envoyés par Unico, la **stratégie de repli** et les modèles de **sécurité et fiabilité** que votre point de terminaison doit implémenter.

### Quand utiliser les webhooks

Les webhooks sont la méthode recommandée pour être notifié de l'achèvement d'un processus. Ils sont particulièrement pertinents pour :

- **Les flux Web et SDK asynchrones** — pour être notifié lorsqu'un `POST /client/v1/process` termine son traitement du côté d'Unico.
- **Les flux de longue durée** qui combinent plusieurs capacités (ex. : analyse de document + révision manuelle). Les webhooks se déclenchent uniquement à l'état terminal (`PROCESS_STATE_FINISHED`) ; aucun événement de progression intermédiaire n'est transmis.

Les webhooks complètent, sans remplacer, les points de terminaison **GetProcess**. Voir [Repli](/developers/webhooks-and-events/fallback).

### Dans cette section

- **[Configuration](/developers/webhooks-and-events/setup)** — enregistrement du point de terminaison, méthodes d'authentification (OAuth2, Basic, API Key), paramètres de nouvelle tentative.
- **[Types d'événements](/developers/webhooks-and-events/event-types)** — les événements envoyés par Unico et la structure de la charge utile.
- **[Sécurité](/developers/webhooks-and-events/security)** — idempotence, limite de simultanéité et taux d'erreur.
- **[Repli](/developers/webhooks-and-events/fallback)** — comment récupérer le résultat du processus lorsque le webhook est indisponible.