자체 시스템으로 웹훅 보내기

이벤트

웹훅 연결하기

1. Foliant에서 설정 › 연동으로 이동합니다.
2. 웹훅에서 연결을 클릭합니다.
3. 설정을 입력합니다.

   필드	입력 내용
   엔드포인트 URL	Foliant가 이벤트를 보낼 주소입니다. https://example.com/webhooks/foliant처럼 HTTPS를 사용해야 합니다.
   서명 시크릿	선택 사항입니다. 시크릿을 설정하면 모든 요청에 서명이 추가되어 Foliant에서 보낸 요청인지 확인할 수 있습니다.
   이벤트	보낼 이벤트입니다. 기본적으로 두 이벤트가 모두 선택되어 있습니다.

4. 연결을 클릭합니다.

각 요청의 내용

{
  "id": "a unique delivery id",
  "event": "document.generated",
  "created_at": "2026-10-11T09:30:00+00:00",
  "shop": "your-store.myshopify.com",
  "data": { }
}

document.generated 데이터

• template: 템플릿의 uuid 및 name.
• document_type: invoice, credit_note, quote 또는 기타 문서의 경우 빈 값.
• order: 주문의 id, name 및 type(주문 또는 임시 주문).
• refund_id 및 fulfillment_id: 환불 또는 배송에 대한 문서인 경우.
• document_number 및 issued_at: 번호가 매겨진 문서인 경우.
• source: 생성 방식. 예: download, admin_download, export 또는 email.
• export: 내보내기에 포함된 경우 내보내기 ID.
• generated_at.

export.completed 데이터

• export: 내보내기의 uuid, order_type, template_uuids, orders 수, orders_skipped(선택된 후 삭제된 주문) 및 documents, requested_by(merchant 또는 customer), completed_at.
• download_url: 내보내기를 다운로드할 수 있는 링크, download_url_expires_at: 해당 링크가 만료되는 시점.
• download_expires_at: 내보내기 자체가 만료되는 시점.

헤더

서명 확인하기

응답 및 재시도

• 2xx 응답은 모두 전송 완료로 간주됩니다.
• 엔드포인트가 5xx 오류, 408 또는 429를 반환하거나 10초 이내에 응답하지 않으면 Foliant는 나중에 다시 시도합니다. 시도할 때마다 대기 시간이 길어지며 최대 5회까지 시도합니다.
• 그 외 4xx 응답은 최종 결과로 처리되며 Foliant는 재시도하지 않습니다.
• 각 이벤트는 문서 또는 내보내기당 한 번 전송됩니다. 전송에 성공한 후에는 재시도로 인해 중복 전송되지 않습니다.

관련 문서

• 연동 연결 및 관리하기
• 연동 활동
• Shopify Flow로 자동화하기
• PDF 내보내기