Wysyłaj wyodrębnione dane z dokumentów do dowolnej aplikacji przez Webhook
Zapier i Make świetnie sprawdzają się w większości automatycznych przepływów. Jeśli jednak chcesz wysłać dane do własnej aplikacji, wewnętrznej bazy czy systemu, którego nie znajdziesz w żadnym markecie, potrzebujesz bezpośredniego połączenia. Do tego służą właśnie webhooki Parseur.
Za każdym razem, gdy Parseur przetworzy dokument, wysyła żądanie HTTP POST pod Twój adres URL ze strukturalnymi danymi w formacie JSON. Twoja aplikacja natychmiast (w czasie rzeczywistym) otrzymuje czyste, uporządkowane dane i może je dowolnie przetwarzać, zgodnie z Twoimi wymaganiami. Bez pośredników, bez mapowania przez zewnętrzną platformę, bez opłat za każdą operację.
Według badania Parseur i QuestionPro z 2025 roku pracownicy spędzają ponad 9 godzin tygodniowo na ręcznym przeklejaniu danych z dokumentów do innych narzędzi, co generuje średni roczny koszt 28 500 USD na pracownika. Dla zespołów developerskich budujących własne automatyzacje dokumentów, webhook to najkrótsza droga z dokumentu do działania „na żywo”.
Kluczowe informacje
Parseur wysyła ustrukturyzowane dane JSON do dowolnego endpointa HTTP przez webhook za każdym razem, gdy dokument jest przetwarzany. Nie potrzeba żadnej platformy pośredniczącej.
Obsługiwane są cztery typy zdarzeń webhook: Przetworzono dokument, Spłaszczone tabele, Przetworzono pozycję tabeli oraz Eksport nieudany. Każdy ma inne zastosowanie.
Własne nagłówki HTTP pozwalają dodać tokeny uwierzytelniające lub współdzielone tajemnice dla bezpieczeństwa endpointa webhooka.
Webhooki działają z każdym celem: autorską aplikacją, bazami wewnętrznymi, ERP, self-hosted automation (np. n8n) i mikroserwisami.
Gdy celem jest popularna aplikacja – wybierz Zapier lub Make. Gdy nie jest – wybierz webhooki.
Webhook vs Zapier vs Make – kiedy co wybrać
Wszystkie trzy służą do przesyłania danych z Parseur do innych systemów. Najlepszy wybór zależy od docelowej aplikacji:
Zapier lub Make sprawdzą się najlepiej, gdy celem jest popularna aplikacja dostępna w ich bazie (Google Sheets, HubSpot, Salesforce, Slack, Airtable i tysiące innych). Konfiguracja przebiega szybciej i nie wymaga kodowania.
Webhook wybierz, jeśli celem jest autorska aplikacja, zamknięty system wewnętrzny, narzędzie self-hosted jak n8n lub baza, którą trudno obsłużyć w narzędziach no-code. Webhook daje pełną kontrolę: sam tworzysz endpoint, decydujesz co dzieje się z danymi i nie ograniczają Cię limity ani narzucony model danych.
Dla zespołów deweloperskich budujących własne workflow automatyzacji dokumentów, webhooki to standard integrowania.
Zdarzenia webhook obsługiwane przez Parseur
Parseur może wywołać różne zdarzenia, w zależności od potrzeb:
Zdarzenie
Kiedy uruchamiane
Najlepsze zastosowanie
Przetworzono dokument
Gdy dokument został w pełni wyodrębniony
Użycie ogólne: jeden ładunek na dokument ze wszystkimi polami
Spłaszczone tabele
Po przetworzeniu dokumentu z tabelami
Dane tabeli w formie „spłaszczonej” – każdy wiersz osobno
Przetworzono pozycję tabeli
Osobno dla każdego wiersza w polu tabeli
Dodawanie każdego wiersza jako osobnego rekordu w bazie
Eksport nieudany
Gdy nie uda się dostarczyć webhooka
Monitoring błędów i powiadomienia mailowe/Slack
Zdarzenie „Przetworzono pozycję tabeli” jest szczególnie przydatne przy pozycjach faktur lub tabelach zamówień, gdy chcesz stworzyć osobny rekord dla każdego wiersza zamiast grupowo przetwarzać całą tablicę.
Co zawiera ładunek JSON
Po przetworzeniu dokumentu, Parseur wysyła do Twojego endpointa obiekt JSON, który zawiera:
Wyodrębnione pola jako klucz-wartość (nazwy zgodne z tymi, które ustalisz w szablonie)
Wiersze tabelaryczne jako tablice obiektów, każdy wiersz to osobny obiekt
Metadane dokumentu: ID dokumentu, ID skrzynki, znacznik czasu przetwarzania, oryginalna nazwa pliku
Struktura dokładnie odzwierciedla Twój własny szablon – pole invoice_number w szablonie Parseur pojawi się jako invoice_number w przesłanym JSON. Pola tabelaryczne trafiają jako tablice, a każdy wiersz ma kolumny zgodne z szablonem.
Krok 1: Wgraj dokument i stwórz własny szablon do ekstrakcji
Przeciągnij i upuść dokument do skrzynki lub prześlij e-mail na adres skrzynki Parseur. Ustaw regułę automatycznego przesyłania e-maili, by przyjmować dokumenty masowo.
Gdy dokument pojawi się w Parseur, zaznacz interesujące Cię pola i nadaj im nazwy. Sztuczna inteligencja Parseur zastosuje szablon na przyszłość dla każdego podobnego dokumentu.
Define the fields you want in your JSON payload
Krok 2: Utwórz webhook
Wejdź w Eksport, potem Webhook, następnie Nowy webhook. Wklej swój adres endpointa i wybierz typ zdarzenia.
Jeśli najpierw chcesz przetestować integrację, użyj serwisu webhook.site, aby uzyskać tymczasowy publiczny URL, który loguje każde przychodzące żądanie. Pozwoli Ci to obejrzeć dokładny ładunek JSON zanim podłączysz właściwy endpoint produkcyjny.
Use webhook.site to inspect the payload before connecting your real endpoint
Wklej ten adres URL w Parseur w polu target URL.
Add your endpoint URL and choose the trigger event
Krok 3: Dodaj nagłówki autoryzacyjne (zalecane)
Przy endpointach produkcyjnych dodaj nagłówek HTTP z tokenem autoryzacyjnym lub współdzieloną tajemnicą. Twój endpoint weryfikuje nagłówek przed przetworzeniem danych, co chroni system przed nieautoryzowanymi żądaniami.
Krok 5: Przetestuj integrację
Przetwórz ponownie dokument w skrzynce Parseur, aby wymusić wysyłkę webhooka. Sprawdź logi endpointa lub webhook.site czy ładunek dotarł i czy ma oczekiwaną strukturę.
Verify the JSON payload structure in your endpoint logs
Gdy test wypadnie poprawnie, Twój endpoint będzie od teraz automatycznie otrzymywać ładunek JSON dla każdego nowego dokumentu przetworzonego przez Parseur.
Zespoły wykorzystują webhooki Parseur, by połączyć parsowanie dokumentów z systemami nieobsługiwanymi przez platformy no-code:
Własne bazy danych: Przesyłaj pozycje faktur bezpośrednio do PostgreSQL lub MySQL. Każde zdarzenie „Przetworzono pozycję tabeli” dodaje jeden wiersz bez wsadowych importów.
Wewnętrzne ERPy: Kieruj wyodrębnione zamówienia prosto do systemu ERP przez jego REST API bez konieczności importu plików.
Mikroserwisy: Uruchamiaj usługi downstream po przetwarzaniu dokumentu, np. walidację lub powiadomienia o nowym zamówieniu.
Self-hosted n8n: Użyj Parseur jako warstwy ekstrakcji w workflow n8n na własnej infrastrukturze. Pełny przewodnik integracji znajdziesz w instrukcji do n8n.
CRM i kwalifikacja leadów: Przekazuj lead e-mail bezpośrednio do endpointa API CRM, z pominięciem Zapiera.
Darmowe narzędzia dla wybranych typów dokumentów
Chcesz sprawdzić wyjściowy JSON z określonych dokumentów zanim zbudujesz integrację? Te konwertery pozwalają podejrzeć strukturę danych w przeglądarce:
Parseur to zaawansowane narzędzie do automatyzacji przetwarzania dokumentów. Umożliwia ekstrakcję danych z e-maili, plików PDF i innych dokumentów, automatyzując procesy biznesowe.
Zobacz wszystkie funkcje Parseur.
Czym jest Webhook?
Webhook służy do wymiany danych między aplikacjami i serwerami korzystając z ich API. Webhook to zdarzenie powiadomienia (wysyłane przez HTTP POST), które jest wywoływane za każdym razem, gdy Parseur przetworzy nowy dokument i przesyła wyodrębnione dane w formacie JSON.
Najczęstsze pytania dotyczące korzystania z webhooków Parseur do wysyłania wyodrębnionych danych z dokumentów do własnych aplikacji i API.
Webhook Parseur to żądanie HTTP POST wysyłane przez Parseur pod wskazany przez Ciebie adres URL za każdym razem, gdy dokument zostanie przetworzony. Żądanie zawiera wyodrębnione pola jako ładunek JSON. Twoja aplikacja otrzymuje dane w czasie rzeczywistym i może je dowolnie przetwarzać, przechowywać lub przesyłać dalej.
Ładunek JSON zawiera wyodrębnione pola z dokumentu jako pary klucz-wartość oraz metadane, takie jak identyfikator dokumentu, skrzynki i czas przetwarzania. Dane z tabel przekazywane są jako tablica obiektów, każdy wiersz to oddzielny wpis. Dokładna struktura zależy od pól szablonu. Zobacz pełną referencję ładunku w dokumentacji Parseur.
Parseur automatycznie ponawia próby dostarczenia nieudanych webhooków. Jeśli Twój endpoint jest czasowo niedostępny, dostawa zostanie powtórzona. Możesz też użyć zdarzenia Eksport nieudany, by wywoływać alerty na wypadek błędu, dzięki czemu Twój zespół szybko zareaguje.
Tak. Własne instancje n8n możesz połączyć z Parseur poprzez ogólne węzły webhook. Instancja n8n musi być dostępna publicznie, by Parseur mógł do niej dotrzeć. Dostępny jest także natywny konektor Parseur dla n8n Cloud.
Tak. Zdarzenie "Przetworzono pozycję tabeli" wywołuje osobne żądanie webhooka dla każdego wiersza w polu tabelarycznym. To przydatne, jeśli chcesz np. dodać każdy wiersz faktury jako odrębny rekord w bazie zamiast odbierać całe pole jako tablicę.
Parseur obsługuje cztery typy zdarzeń webhook. "Przetworzono dokument" wysyła pełny ładunek JSON po wyodrębnieniu dokumentu. "Spłaszczone tabele" przesyła dane tabel w formacie, w którym każdy wiersz to osobny obiekt. "Przetworzono pozycję tabeli" wywołuje webhook dla każdego wiersza osobno. "Eksport nieudany" uruchamia się po nieudanej próbie dostarczenia, co jest przydatne do monitorowania błędów i alertów.
Tak. Parseur umożliwia dodawanie własnych nagłówków HTTP do webhooka, w tym nagłówka Authorization z tokenem lub kluczem współdzielonym. Odbierający endpoint może wówczas zweryfikować każde przychodzące żądanie przed dalszym przetwarzaniem. To zalecana praktyka przy webhookach piszących do produkcyjnych baz lub uruchamiających wrażliwe procesy.
Webhooka używaj, gdy łączysz się z autorską aplikacją, wewnętrznym systemem lub bazą, do której nie ma gotowego konektora w Zapier czy Make. Webhook zapewnia pełną kontrolę sposobu odbioru i obróbki danych. Jeśli celem jest popularna aplikacja, np. Google Sheets, HubSpot lub Slack, skorzystaj z Zapier lub Make dla szybszej konfiguracji.
Tak. Narzędzia takie jak webhook.site dają publiczny adres URL do logowania każdego żądania, dzięki czemu obejrzysz strukturę JSON przed spięciem z systemem docelowym. Przetwórz ponownie dokument w Parseur po ustawieniu webhooka, aby uruchomić testową dostawę.
Tak. Parseur udostępnia REST API, które pozwala programistycznie wgrywać dokumenty, pobierać wyniki przetwarzania czy zarządzać skrzynkami. Webhook działa „push” (Parseur dzwoni do Ciebie), API jest „pull” (Ty pytasz Parseur). Większość integracji czasu rzeczywistego korzysta z webhooków; API przydaje się np. w zadaniach wsadowych lub gdy zależy Ci na cyklicznym pobieraniu wyników.
