Webhook

Un webhook est un rappel automatisé : lorsqu'un traitement de document se termine, le système envoie une requête HTTP POST vers une URL que vous spécifiez, transportant les données extraites ou une mise à jour de statut. Cela évite de devoir demander sans cesse "est-ce terminé ?" Votre application attend simplement et ne réagit que lorsqu'il y a effectivement quelque chose à traiter.

Comment ça fonctionne

Dans un pipeline documentaire, vous enregistrez une URL de webhook au moment de soumettre un document (ou une seule fois, au niveau du compte, pour l'ensemble des traitements). Le moteur d'extraction traite le fichier : classification, analyse de mise en page, extraction de paires clé-valeur, règles de validation, bref tout ce que le pipeline requiert. Une fois qu'il atteint un état final (succès, échec ou nécessite une relecture), le système construit une charge utile, généralement en JSON, contenant les champs extraits, un score de confiance et un identifiant de traitement, puis l'envoie vers votre point de terminaison.

Votre serveur doit accomplir trois choses de façon fiable : répondre rapidement (typiquement en quelques secondes) avec un code de statut 2xx, vérifier que la requête provient bien de l'éditeur (via un en-tête de signature, pas simplement en comptant sur la confidentialité de l'URL), et traiter la charge utile de manière asynchrone plutôt que dans le gestionnaire de requête lui-même. La plupart des fournisseurs relancent les envois échoués avec un mécanisme de backoff, donc votre point de terminaison doit être idempotent : traiter deux fois le même identifiant de job ne doit pas créer d'enregistrements en double.

Les webhooks sont particulièrement adaptés aux traitements asynchrones et de durée variable, comme l'OCR ou l'extraction basée sur des LLM, où le temps de traitement dépend de la complexité du document. Ils sont l'exact opposé du polling, où votre application interroge répétitivement une API pour vérifier le statut d'un traitement. Le polling gaspille des requêtes et ajoute de la latence ; les webhooks poussent les données dès qu'elles existent.

Pourquoi c'est important pour le traitement documentaire

L'extraction de documents se termine rarement de façon instantanée, en particulier pour les contrats multi-pages ou les lots de factures. Les webhooks permettent de construire un pipeline qui réagit dès que les données sont disponibles, plutôt qu'un système qui vérifie à intervalles réguliers en gaspillant des cycles ou en ajoutant des délais. C'est essentiel pour le straight-through processing : une facture validée et approuvée sans intervention humaine doit voir son résultat routé vers l'ERP en quelques secondes, pas en quelques minutes.

La fiabilité compte autant que la vitesse. Un appel de webhook manqué ou perdu peut laisser une réclamation ou une facture bloquée sans que personne ne s'en rende compte. Les bonnes implémentations journalisent chaque tentative d'envoi, exposent un tableau de bord ou une piste d'audit permettant de rejouer les envois, et laissent la possibilité de récupérer les résultats via un simple appel API en filet de sécurité. Lors de l'évaluation d'un éditeur de solutions d'IA documentaire, demandez comment il gère les relances de webhooks, la vérification des signatures et le versionnage des charges utiles : ces détails déterminent si votre intégration sera solide ou fragile.

Termes associés

• Straight-through processing (STP)
• Score de confiance
• Piste d'audit
• Extraction de données
• Développer ou acheter une solution IDP

FAQ

Que se passe-t-il si mon serveur est indisponible au moment où un webhook se déclenche ?

La plupart des plateformes de traitement documentaire relancent les envois échoués avec un backoff exponentiel, souvent pendant plusieurs heures, et ne marquent le job comme livré qu'après une réponse réussie. Si les tentatives de relance s'épuisent, vous devriez tout de même pouvoir récupérer le résultat manuellement via une API de statut. Prévoyez toujours ce filet de sécurité ; ne présumez jamais que les webhooks seuls suffisent.

Dois-je utiliser des webhooks ou du polling pour l'extraction de documents ?

Utilisez les webhooks pour les pipelines de production : ils réduisent la latence et limitent les appels API inutiles. Le polling convient pour des tests rapides, du débogage, ou dans des environnements où vous ne pouvez pas exposer un point de terminaison public (derrière un pare-feu strict, par exemple). Certaines équipes combinent les deux approches : les webhooks comme voie principale, le polling comme vérification de réconciliation périodique pour les jobs qui auraient pu être manqués.