Invia i dati estratti dai documenti a qualsiasi app tramite Webhook
Zapier e Make coprono bene la maggior parte dei casi d'uso dell'automazione. Ma quando la destinazione è un'applicazione personalizzata, un database interno o un sistema che non si trova in nessun marketplace, serve una connessione diretta. Qui entrano in gioco i webhook Parseur.
Ogni volta che Parseur elabora un documento, invia una richiesta HTTP POST a un URL scelto da te, con tutti i campi estratti come payload JSON. La tua applicazione riceve dati strutturati in tempo reale e li processa come necessario. Nessun intermediario, nessuna interfaccia di terze parti, nessun costo per task.
Secondo un sondaggio Parseur e QuestionPro del 2025, i dipendenti trascorrono oltre 9 ore a settimana a spostare dati da documenti verso altri strumenti, con un costo medio di $28.500 per dipendente ogni anno. Per i team di sviluppo che stanno integrando l'automazione documentale nei propri prodotti, i webhook sono il percorso più rapido dal documento elaborato al sistema live.
Punti chiave
Parseur invia JSON strutturati a qualsiasi endpoint HTTP tramite webhook, ogni volta che un documento viene processato. Nessuna piattaforma intermedia necessaria.
Sono supportati quattro tipi di eventi: Documento Processato, Tabelle Appiattite, Elemento Tabella Processato, Esportazione Fallita. Ognuno copre un caso d'uso diverso.
Gli header HTTP personalizzati ti permettono di aggiungere token di autenticazione o segreti condivisi per proteggere il tuo endpoint webhook.
I webhook funzionano per qualunque destinazione: app personalizzate, database interni, ERP, strumenti di automazione self-hosted come n8n e microservizi.
Usa Zapier o Make se la tua destinazione è un'app mainstream. Usa invece i webhook se non lo è.
Webhook vs Zapier vs Make: quando scegliere ciascuno
Tutti e tre sono modi per inviare i dati Parseur ad altri sistemi. La scelta giusta dipende dalla destinazione:
Usa Zapier o Make se la tua destinazione è un'applicazione mainstream già nelle loro librerie (Google Sheets, HubSpot, Salesforce, Slack, Airtable e migliaia di altre). Il setup è rapido e non richiede codice.
Usa un webhook se la tua destinazione è un'applicazione personalizzata, un sistema interno proprietario, uno strumento self-hosted come n8n o un database non supportato dalle piattaforme no-code. I webhook ti danno il pieno controllo: scrivi tu l'endpoint di ricezione, decidi il flusso dei dati e non sei limitato dal modello dati o dai limiti di quelle piattaforme.
Per i team che integrano l'automazione documentale nei propri prodotti o strumenti interni, i webhook sono la standard.
Eventi webhook supportati da Parseur
Parseur può inviare eventi diversi a seconda delle tue esigenze:
Evento
Quando viene attivato
Ideale per
Documento Processato
Al termine dell’estrazione di un documento
Tuttofare: un payload per documento con tutti i campi
Tabelle Appiattite
Quando viene processato un documento con tabelle
Output stile foglio di calcolo con le righe appiattite
Elemento Tabella Processato
Una volta per ogni riga di un campo tabella
Inserire ogni voce come record separato in un database
Esportazione Fallita
Se una consegna webhook fallisce
Monitoraggio errori e avvisi email/Slack
L'evento "Elemento Tabella Processato" è particolarmente utile per le voci di fatture o le tabelle ordini, in cui vuoi che ogni riga generi un record distinto invece di processare l'intero array insieme.
Cosa contiene il payload JSON
Quando un documento viene processato, Parseur invia un oggetto JSON al tuo endpoint. Il payload include:
I campi estratti come coppia chiave-valore (nomi dei campi come da template creato)
Righe tabellari come array di oggetti, un oggetto per riga
Metadati del documento: ID documento, ID casella, timestamp di elaborazione e nome file originale
La struttura rispecchia il tuo template. Un campo chiamato invoice_number nel template Parseur arriverà come invoice_number nel JSON. I campi tabella arrivano come array, ciascuna riga contiene i valori di colonna che hai definito.
Per la struttura completa del payload e i tipi di campo, consulta la documentazione webhook.
Passo-passo: come configurare i webhook Parseur
Passo 1: Carica un documento e definisci il tuo template di estrazione
Trascina un documento nella tua casella Parseur, oppure inoltra un’email all’indirizzo email Parseur. Configura una regola di inoltro automatico per elaborare documenti scalando automaticamente.
Quando il documento appare su Parseur, evidenzia i campi che vuoi estrarre e assegnagli un nome. L’IA di Parseur applicherà il template a tutti i documenti simili futuri.
Definisci i campi che vuoi nel tuo payload JSON
Passo 2: Crea il tuo webhook
Vai su Esporta, poi Webhook, quindi Nuovo Webhook. Incolla l’URL dell’endpoint e scegli l’evento trigger.
Se vuoi prima testare l’integrazione, usa webhook.site per ottenere un URL pubblico temporaneo che registra ogni richiesta in arrivo. Questo ti permette di vedere esattamente la struttura del payload JSON prima di collegarlo al tuo endpoint produttivo.
Usa webhook.site per ispezionare il payload prima di collegare l’endpoint reale
Incolla l’URL su Parseur nel campo URL di destinazione.
Aggiungi l’URL dell’endpoint e scegli l’evento trigger
Passo 3: Aggiungi header di autenticazione (consigliato)
Per gli endpoint di produzione, aggiungi un header HTTP personalizzato con un token di autorizzazione o un segreto condiviso. Il tuo endpoint dovrà validare l’header prima di processare il payload per prevenire richieste non autorizzate.
Passo 5: Testa l’integrazione
Rielabora un documento nella casella Parseur per attivare la consegna del webhook. Verifica i log dell’endpoint o su webhook.site che il payload sia arrivato e rispetti la struttura prevista.
Verifica la struttura del payload JSON nei log dell’endpoint
Quando il test è superato, il tuo endpoint riceverà automaticamente un payload JSON per ogni documento processato da Parseur.
I team usano i webhook Parseur per collegare l’estrazione dati a sistemi che le piattaforme no-code non gestiscono direttamente:
Database personalizzati: Importa direttamente i dettagli delle fatture in PostgreSQL o MySQL. Ogni evento "Elemento Tabella Processato" inserisce una riga, evitando import batch.
ERP interni: Invio diretto dei dati estratti da ordini o acquisti a un ERP tramite la sua REST API, senza pipeline di import file.
Microservizi: Attiva servizi downstream appena un documento viene processato, per esempio per validazione o per notificare una logistica all’arrivo di un nuovo ordine.
n8n self-hosted: Usa Parseur come livello OCR/estrazione dati in flussi n8n ospitati su tua infrastruttura. Qui la guida completa all'integrazione n8n.
CRM e instradamento lead: Invia i dati di email di lead direttamente all’API inbound di un CRM, senza passare da Zapier.
Strumenti gratuiti per tipi di documenti specifici
Se vuoi controllare il risultato JSON per certi tipi di documenti prima di integrare, questi convertitori gratuiti ti mostrano la struttura direttamente nel browser:
Per la documentazione API Parseur completa e la schema dei payload webhook, consulta la guida API di estrazione dati.
Cos'è Parseur?
Parseur è un potente software di elaborazione documenti che estrae dati da email, PDF e altri documenti per automatizzare i tuoi flussi di lavoro.
Scopri tutte le funzionalità di Parseur
Cos'è Webhook?
Un webhook viene utilizzato per scambiare dati tra applicazioni e server tramite le loro API. Un webhook è un evento di notifica (tramite HTTP POST) che viene attivato ogni volta che un nuovo documento viene analizzato da Parseur e invia i dati estratti in formato JSON.
Domande comuni sull'uso dei webhook Parseur per inviare i dati dei documenti elaborati ad applicazioni o API personalizzate.
Un webhook Parseur è una richiesta HTTP POST che Parseur invia a un URL da te specificato ogni volta che un documento viene elaborato. La richiesta contiene i campi estratti come payload JSON. La tua applicazione riceve i dati in tempo reale e può processarli, salvarli o indirizzarli come desideri.
Il payload JSON contiene i campi estratti dal documento come coppie chiave-valore, oltre a metadati come ID del documento, ID della casella di posta e timestamp di elaborazione. I dati delle tabelle sono inclusi come array di oggetti, una voce per riga. La struttura precisa dipende dai campi configurati nel modello. Consulta la documentazione Parseur per la struttura del payload completa.
Parseur ritenta automaticamente le consegne dei webhook fallite. Se il tuo endpoint non è temporaneamente disponibile, la consegna viene ripetuta. Puoi anche sfruttare l'evento Esportazione Fallita per inviare un avviso in caso di errore, così il tuo team potrà intervenire tempestivamente.
Sì. Istanza n8n self-hosted può collegarsi a Parseur usando i nodi webhook generici. L’istanza n8n deve essere accessibile pubblicamente affinché Parseur possa raggiungere l'endpoint webhook. Il connettore nativo Parseur è disponibile anche per n8n Cloud.
Sì. L'evento "Elemento Tabella Processato" attiva una chiamata webhook separata per ogni riga di un campo tabella. Questo è utile, ad esempio, per inserire ogni voce di una fattura come un record separato in database, invece di ricevere tutte le righe in un unico array.
Parseur supporta quattro tipi di eventi per i webhook. "Documento Processato" viene attivato con tutto il payload JSON quando un documento viene estratto. "Tabelle Appiattite" invia dati tabellari in un formato in cui ogni riga è un oggetto separato. "Elemento Tabella Processato" viene attivato separatamente per ogni riga di un campo tabellare. "Esportazione Fallita" si attiva quando un tentativo di consegna non va a buon fine, utile per il monitoraggio degli errori e per gli avvisi.
Sì. Parseur consente di aggiungere header HTTP personalizzati alla richiesta webhook, incluso un header Authorization con token o segreto condiviso. Il tuo endpoint di ricezione può così validare ogni richiesta in arrivo prima dell'elaborazione. Questo è l'approccio consigliato per i webhook che scrivono su database di produzione o attivano flussi di lavoro critici.
Usa un webhook quando devi collegarti a un'applicazione personalizzata, sistema interno proprietario o database non presente nelle librerie di app di Zapier o Make. I webhook ti danno controllo totale su come ricevere e gestire i dati. Se la destinazione è un'app diffusa come Google Sheets, HubSpot o Slack, Zapier o Make sono più rapidi da configurare.
Sì. Strumenti come webhook.site ti danno un URL pubblico temporaneo che registra ogni richiesta in arrivo, così puoi ispezionare la struttura del payload JSON prima di collegarlo al tuo sistema reale. Rielabora un documento su Parseur dopo aver configurato il webhook per eseguire un test.
Sì. Parseur dispone di una REST API per caricare documenti da codice, recuperare risultati estratti e gestire le caselle. I webhook sono push-based (Parseur chiama il tuo endpoint), l’API è pull-based (tu chiami Parseur). La maggior parte delle integrazioni real time usa i webhook; l’API è utile per workflow batch o per il polling dei risultati.
