Envoyer les données parsées d’un document vers n’importe quelle application via un webhook
Zapier et Make couvrent la plupart des cas d'usage d’automatisation. Mais lorsqu’il s’agit de connecter Parseur à une application personnalisée, une base de données interne ou un système qui ne figure dans aucune marketplace d’applications, il vous faut une connexion directe. C’est exactement à cela que servent les webhooks Parseur.
À chaque fois que Parseur traite un document, il envoie une requête HTTP POST à une URL qui vous appartient, avec les champs extraits au format JSON. Votre application reçoit en temps réel des données structurées et peut les traiter selon vos besoins. Pas de plateforme intermédiaire, pas de mapping à travers une interface tierce, pas de facturation à la tâche.
Une étude Parseur et QuestionPro de 2025 a révélé que les employés passent plus de 9 heures par semaine à transférer manuellement des données de documents vers d’autres outils, pour un coût moyen de $28 500 par salarié et par an. Pour les équipes techniques qui souhaitent intégrer l’automatisation documentaire dans leurs propres produits, les webhooks constituent le chemin le plus rapide et à la latence minimale entre un document parsé et un système actif.
Points clés à retenir
Parseur envoie du JSON structuré vers n’importe quel endpoint HTTP via un webhook, à chaque document traité. Aucune plateforme intermédiaire nécessaire.
Quatre événements sont gérés : Document traité, Tables aplaties, Élément de table traité, et Échec d’export. Chacun pour des usages différents.
Des en-têtes HTTP personnalisés permettent d’ajouter des tokens d’authentification ou secrets partagés pour sécuriser votre endpoint webhook.
Les webhooks fonctionnent vers n’importe quelle destination : applications sur-mesure, bases de données internes, ERP, outils d’automatisation auto-hébergés comme n8n, ou microservices.
Utilisez Zapier ou Make lorsque la destination est une app courante ; les webhooks quand ce n’est pas le cas.
Webhook vs Zapier vs Make : Quand utiliser chaque solution
Tous permettent d’envoyer des données de Parseur vers d’autres systèmes. Le bon choix dépend de votre cas d’usage :
Utilisez Zapier ou Make si la destination est une application déjà présente dans leur catalogue (Google Sheets, HubSpot, Salesforce, Slack, Airtable et des milliers d’autres). La mise en place est rapide, sans aucun code.
Utilisez un webhook quand la destination est votre application sur-mesure, un système propriétaire, un outil auto-hébergé comme n8n ou une base de données non couverte par les plateformes no-code. Les webhooks donnent un contrôle total : vous codez l’endpoint récepteur et choisissez la façon dont la donnée est traitée, sans aucune contrainte de modèle ou de limites.
Pour les équipes qui intègrent le parsing documentaire à leurs propres logiciels ou outils internes, les webhooks sont la voie standard d’intégration.
Événements webhook supportés par Parseur
Parseur déclenche différents événements selon les cas :
Événement
Quand il est déclenché
Principal usage
Document traité
Lorsqu’un document est extrait intégralement
Usage généraliste : un payload par document avec tous les champs
Tables aplaties
Si un document contient des tables
Sortie « tableur » où chaque ligne de table devient un objet
Élément de table traité
Une fois par ligne de la table
Insérer chaque ligne indépendante dans une base de données
Échec d’export
Si un envoi webhook échoue
Veille d’erreur, notifications Slack/email
L’événement « Élément de table traité » est très utile pour les lignes d’une facture ou de commande : chaque ligne peut créer un enregistrement distinct, plutôt que de devoir traiter tout un tableau.
Ce que contient le payload JSON
Quand un document est traité, Parseur envoie un objet JSON à votre endpoint. Ce payload comprend :
Vos champs extraits sous forme clé-valeur (selon les noms définis dans votre modèle)
Les lignes de table sous forme de tableau d’objets, une entrée par ligne
Les métadonnées : ID du document, ID de la boîte aux lettres, horodatage du traitement, nom d’origine du fichier
La structure du JSON suit précisément votre template. Un champ nommé invoice_number dans Parseur arrive sous cette même clé dans le JSON. Les champs tableaux arrivent en tant que tableaux, chaque ligne avec les valeurs colonnes définies.
Pour voir le schéma de payload complet et la typologie des champs, consultez la documentation webhook.
Pas à pas : configurer les webhooks Parseur
Étape 1 : Téléchargez un document et définissez votre template d’extraction
Glissez-déposez un document dans votre boîte aux lettres, ou transférez un email à l’adresse de votre boîte Parseur. Créez une règle de transfert automatique pour automatiser et traiter vos documents à grande échelle.
Une fois reçu dans Parseur, surlignez les champs que vous souhaitez extraire et nommez-les. L’IA de Parseur appliquera ce modèle à tous les documents similaires à l’avenir.
Définissez les champs souhaités dans votre payload JSON
Étape 2 : Créez votre webhook
Allez dans Exporter, puis Webhook, puis Nouveau webhook. Collez l’URL de votre endpoint et choisissez l’événement déclencheur.
En mode test, utilisez webhook.site pour générer une URL temporaire qui journalise toutes les requêtes. Cela vous permet d’inspecter le format du JSON avant de connecter votre endpoint de production.
Utilisez webhook.site pour inspecter le payload avant la connexion finale
Collez cette URL dans Parseur dans le champ URL cible.
Ajoutez l’URL de votre endpoint et choisissez l’événement
Étape 3 : Ajoutez un en-tête d’authentification (recommandé)
Pour les endpoints de production, ajoutez un en-tête HTTP personnalisé avec un token ou secret partagé. Votre endpoint vérifiera cet en-tête avant de traiter le payload, évitant les requêtes non autorisées à votre système.
Étape 5 : Testez l’intégration
Retraitez un document dans votre boîte Parseur afin de déclencher la livraison webhook. Vérifiez les logs de votre endpoint ou webhook.site pour confirmer la réception et la structure du payload.
Vérifiez la structure JSON dans les logs de votre endpoint
Une fois le test validé, votre endpoint recevra automatiquement un payload JSON pour chaque document traité par Parseur.
Les équipes utilisent les webhooks Parseur pour connecter le parsing documentaire à des systèmes inaccessibles par les plateformes no-code :
Bases de données sur-mesure : Envoyez les lignes de factures directement dans PostgreSQL ou MySQL. Chaque événement « Élément de table traité » insère une ligne, votre schéma reste propre sans import de lots.
ERP internes : Les données extraites d’un bon de commande sont injectées directement dans l’API REST de l’ERP, sans pipeline d’import de fichiers.
Microservices : Déclenchez un service aval à chaque document traité, par exemple pour une étape de validation ou notifier la logistique dès qu’une commande arrive.
n8n auto-hébergé : Parseur sert de brique d’extraction documentaire dans un workflow n8n hébergé chez vous. Consultez notre guide d’intégration n8n pour la mise en place complète.
Routage CRM & leads : Envoyez les emails de leads directement dans l’API d’entrée de votre CRM, sans passer par Zapier.
Outils gratuits pour d’autres types de documents
Si vous souhaitez explorer le JSON généré à partir de documents types avant de coder votre intégration, ces convertisseurs vous montrent la structure en ligne :
Parseur est un logiciel de data extraction puissant pour extraire automatiquement des données d'emails, de PDFs et de documents et automatiser vos workflows.
Toutes les fonctionnalités de Parseur.
Qu’est-ce que Webhook ?
Un webhook est utilisé pour échanger des données entre applications et serveurs via leur API. Un webhook est un événement de notification (via HTTP POST) qui se déclenche dès qu’un nouveau document est parsé par Parseur et envoie les données parsées au format JSON.
Questions courantes sur l’utilisation des webhooks Parseur pour envoyer les données parsées des documents vers des applications et APIs personnalisées.
Un webhook Parseur est une requête HTTP POST que Parseur envoie à une URL que vous définissez à chaque fois qu’un document est traité. La requête contient les champs extraits dans un payload JSON. Votre application reçoit ainsi les données en temps réel et peut les traiter, les stocker ou les aiguiller comme vous le souhaitez.
Le payload JSON contient tous les champs extraits de votre document sous forme de paires clé-valeur, ainsi que des métadonnées comme l’ID du document, l’ID de la boîte aux lettres et l’horodatage du traitement. Les données des tables y figurent sous forme de tableaux d’objets, chaque ligne étant une entrée. La structure exacte dépend de vos champs de modèle. Consultez la documentation Parseur pour la référence complète du payload.
Parseur retente automatiquement les livraisons de webhook ayant échoué. Si votre endpoint est temporairement indisponible, la livraison sera réessayée. Vous pouvez aussi utiliser l’événement « Échec d’export » pour déclencher une alerte quand une livraison échoue, afin que votre équipe agisse rapidement.
Oui. Les instances n8n auto-hébergées se connectent à Parseur via des nœuds webhook génériques. Votre instance doit être accessible publiquement pour que Parseur puisse appeler le endpoint. Le connecteur Parseur natif est aussi disponible pour n8n Cloud.
Oui. L’événement « Élément de table traité » déclenche un appel webhook séparé pour chaque ligne d’un champ table. Pratique pour insérer chaque ligne de facture dans la base de données comme enregistrement unique, plutôt que de recevoir tout le tableau d’un coup.
Parseur prend en charge quatre événements déclencheurs de webhook. « Document traité » déclenche le payload JSON complet lorsque l’extraction d’un document est terminée. « Tables aplaties » envoie les données de tables sous forme aplatie, chaque ligne devenant un objet distinct. « Élément de table traité » se déclenche pour chaque ligne d’un champ table. « Échec d’export » se déclenche lorsqu’une tentative de livraison échoue, pratique pour la surveillance d’erreur et les alertes.
Oui. Parseur vous permet d’ajouter des en-têtes HTTP personnalisés à la requête webhook, dont un en-tête Authorization avec un token ou un secret partagé. Votre endpoint de réception pourra ensuite valider chaque requête avant traitement. C’est recommandé lorsque le webhook écrit vers des bases de données de production ou déclenche des workflows sensibles.
Utilisez un webhook lorsque vous connectez Parseur à une application personnalisée, un système interne propriétaire ou une base de données qui n’existe pas dans les bibliothèques d’apps Zapier/Make. Les webhooks vous donnent un contrôle total sur la réception et le traitement de la donnée. Si la destination est une app grand public comme Google Sheets, HubSpot ou Slack, Zapier ou Make sera plus rapide à configurer.
Oui. Des outils comme webhook.site offrent une URL temporaire qui donne le détail de toutes les requêtes entrantes afin d’inspecter la structure JSON avant de connecter votre propre système. Retraitez un document dans Parseur après avoir configuré le webhook pour déclencher un envoi test.
Oui. Parseur propose une REST API pour déposer des documents, récupérer les résultats parsés et administrer vos boîtes aux lettres. Les webhooks sont du push (Parseur appelle votre endpoint), l’API fonctionne en pull (vous interrogez Parseur). La plupart des intégrations temps réel sont en webhook ; l’API sert pour des lots ou des besoins de polling.
