Zapier와 Make는 대부분의 자동화용 앱 연동에 적합합니다. 그러나 목적지가 커스텀 애플리케이션, 사내 데이터베이스, 또는 어떠한 앱 마켓플레이스에도 없는 고유 시스템이라면 직접 연결이 필요합니다. 이럴 때 Parseur 웹훅이 가장 강력한 솔루션입니다.
Parseur가 문서를 처리할 때마다, 사용자가 제어하는 URL로 HTTP POST 요청을 발송하고 추출 데이터를 JSON으로 넘깁니다. 귀하의 앱에서는 실시간으로 깔끔하고 구조화된 데이터를 받고, 원하는 방식으로 자유롭게 처리할 수 있습니다. 추가 중개 플랫폼, 써드파티 매핑, 건별 요금제 없이 바로 연결됩니다.
2025년 Parseur와 QuestionPro 공동 설문에 따르면, 직원 1명당 매주 9시간 이상을 문서에서 데이터를 추출하여 다른 툴로 옮기는데 쓰며, 연간 평균 비용이 $28,500에 달합니다. 자사 제품에 문서 자동화를 내장하는 개발팀에는 웹훅이 최단 지연, 실시간 데이터 전달 루트입니다.
주요 요약
Parseur는 문서 처리시마다 모든 HTTP 엔드포인트에 구조화된 JSON을 웹훅으로 전송합니다. 중개 플랫폼 없이 바로 전달됩니다.
지원 이벤트는 총 4종: Document Processed, Flattened Tables, Table Item Processed, Export Failed. 각각 다른 용도에 맞게 활용할 수 있습니다.
커스텀 HTTP 헤더를 추가해 인증 토큰이나 공유 시크릿으로 웹훅 엔드포인트를 보호할 수 있습니다.
웹훅은 모든 종류의 목적지 — 커스텀 앱, 사내 DB, ERP, 자체 호스팅 자동화(n8n 등), 마이크로서비스까지 사용할 수 있습니다.
목적지가 대표적인 SaaS 앱이라면 Zapier나 Make가 더 쉽고 빠릅니다. 그렇지 않다면 웹훅을 사용하세요.
웹훅 vs Zapier vs Make: 언제 어떤 방식을 쓸까?
셋 모두 Parseur 데이터를 외부 시스템으로 보내는 방법입니다. 도달하고자 하는 목적지 유형에 따라 선택하세요.
Zapier나 Make 사용 목적지가 구글 시트, HubSpot, Salesforce, Slack, Airtable 같이 이미 미리 연동된 SaaS 앱(수천 종)에 있다면, 가장 빠르게 연결할 수 있습니다. 코딩 없이 몇 분이면 설정 완료!
웹훅 사용 목적지가 커스텀 앱, 자체 내부 시스템, 자체 호스팅 툴(n8n 등), 또는 노코드 플랫폼이 다루지 못하는 데이터베이스라면 웹훅이 정답입니다. 웹훅은 엔드포인트 코드도 직접 만들고, 데이터 흐름, 구조, 처리 기준 모두 팀이 원하는 대로 만들 수 있습니다. 타 플랫폼의 데이터 구조나 속도 제한에도 영향을 받지 않습니다.
사내 도구, 자사 제품에 문서 자동화를 직접 내장하려는 팀에 웹훅이 표준 연동 방식입니다.
Parseur가 지원하는 웹훅 이벤트 종류
여러 목적에 맞춰, Parseur는 서로 다른 트리거 이벤트를 지원합니다.
이벤트
트리거 시점
대표 활용 사례
Document Processed
문서가 완전히 파싱될 때
일반적인 연동 전체 필드가 한 번에 포함된 페이로드
Flattened Tables
표가 포함된 문서 파싱 시
표 데이터가 행마다 개별 객체로 평탄화된 구조로 전달
Table Item Processed
테이블 필드의 각 행마다
테이블 각 행을 별도 DB 레코드로 저장할 때
Export Failed
웹훅 전달 실패 시
에러 모니터링, Slack/이메일 알림 등
특히 ‘Table Item Processed’는 인보이스 항목이나 주문 테이블에서 각 행을 별도 레코드로 저장하고자 할 때 매우 유용합니다.
JSON 페이로드에 포함되는 내용
문서가 처리되면 Parseur는 엔드포인트(웹훅)에 JSON 객체를 전송합니다. 이 페이로드에는 다음이 포함됩니다.
추출한 각 필드가 키-값 쌍 형태로(사용자가 직접 정의한 템플릿 필드명과 매칭)
표 데이터는 객체 배열이며 각 행이 하나의 객체(행)로 구성됨
문서 메타데이터: 문서 ID, 메일함 ID, 처리 시각, 원본 파일명 등
최종 구조는 귀하의 Parseur 템플릿을 그대로 반영합니다. 예를 들어 Parseur 템플릿에서 invoice_number로 지정했다면, JSON에서도 동일하게 invoice_number라는 필드로 제공됩니다. 표 필드는 배열로 오며, 각 행은 사용자 정의 열 값이 채워진 별도의 객체입니다.
Parseur 웹훅을 이용하여 추출한 문서 데이터를 커스텀 앱 및 API로 전송하는 과정에서 자주 묻는 질문을 소개합니다.
Parseur 웹훅은 문서가 처리될 때마다 Parseur가 사용자가 지정한 URL로 보내는 HTTP POST 요청입니다. 요청 본문에는 추출된 데이터 필드가 JSON으로 포함되어 있으며, 귀하의 애플리케이션이 이를 실시간으로 받아 원하는 방식으로 처리·저장·전달할 수 있습니다.
페이로드는 사용자가 추출한 필드가 키-값 쌍으로 포함되며, 문서 ID, 메일함 ID, 처리 시각 등 메타데이터도 함께 포함됩니다. 표 데이터는 객체의 배열로 제공되며, 각 행이 하나의 객체가 됩니다. 구체적인 구조는 사용자 템플릿에 따라 달라집니다. 전체 페이로드 구성을 Parseur 공식 문서에서 확인하실 수 있습니다.
Parseur는 실패한 웹훅 전달을 자동 재시도합니다. 엔드포인트가 임시 장애일 경우에도 재시도를 거칩니다. 또한 Export Failed 이벤트를 활용해 알림을 트리거하면, 담당자가 즉시 대응할 수 있습니다.
네. 자체 호스팅 n8n 인스턴스에서도 Parseur와 연동할 수 있습니다. n8n에서 웹훅 노드로 연결하면 되고, 이 엔드포인트가 Parseur에서 접근 가능한 공개 URL이어야 합니다. 클라우드용 n8n에는 Parseur 네이티브 커넥터도 있습니다.
네. "테이블 항목 처리 완료(Table Item Processed)" 이벤트를 사용하면 테이블 필드의 각 행마다 개별적으로 웹훅을 트리거할 수 있습니다. 예를 들어 인보이스의 각 항목을 별도의 DB 레코드로 입력해야 할 때 유용합니다.
Parseur는 네 가지 웹훅 트리거 이벤트를 지원합니다. "문서 처리 완료(Document Processed)"는 문서가 추출될 때 전체 JSON 페이로드를 전송합니다. "플래튼 테이블(Flattened Tables)"은 각 테이블의 행마다 별도의 객체로 변환된 표 데이터를 보냅니다. "테이블 항목 처리 완료(Table Item Processed)"는 테이블 필드의 각 행마다 별도로 트리거됩니다. "내보내기 실패(Export Failed)"는 전달이 실패했을 때 발생하며, 에러 모니터링 및 알림에 유용합니다.
네, 가능합니다. 사용자는 웹훅 요청에 커스텀 HTTP 헤더를 추가할 수 있으며, Authorization 헤더에 토큰 또는 공유 비밀값도 넣을 수 있습니다. 수신 엔드포인트에서 헤더를 검증한 후만 처리하도록 할 수 있습니다. 민감한 데이터나 프로덕션 DB로 전송하는 경우 강력히 권장합니다.
Zapier나 Make에서 제공하지 않는 커스텀 앱, 사내 시스템, 독립 DB 등과 연결할 때 웹훅을 사용합니다. 웹훅은 데이터 수신 방식과 후속 처리 제어에 완전한 자유가 있습니다. 구글 시트, HubSpot, Slack 등 주요 SaaS 앱이라면 Zapier나 Make가 더 빠르고 간편합니다.
네. webhook.site 등 서비스를 사용하면 임시 공개 URL로 요청을 받아볼 수 있어, 실제 연동 전 페이로드를 직접 확인하고 테스트할 수 있습니다. Parseur에서 문서를 다시 처리해 바로 테스트해보세요.
네. Parseur REST API를 이용하면 문서 업로드, 결과 조회, 메일함 관리까지 모두 가능합니다. 웹훅은 사용자의 엔드포인트로 Parseur가 데이터를 '푸시'하는 방식이고, API는 사용자가 Parseur 서버에 결과를 '풀링'하는 방식입니다. 실시간 연동은 대개 웹훅, 배치 처리가 필요하면 API가 적합합니다.
