Webhooks et événements

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.

Dans cette section

• Configuration — enregistrement du point de terminaison, méthodes d'authentification (OAuth2, Basic, API Key), paramètres de nouvelle tentative.
• Types d'événements — les événements envoyés par Unico et la structure de la charge utile.
• Sécurité — idempotence, limite de simultanéité et taux d'erreur.
• Repli — comment récupérer le résultat du processus lorsque le webhook est indisponible.