본문으로 건너뛰기

Webhook으로 알림 받기

인보이스 발행, 결제 전기, 재고 부족 등이 발생할 때마다 서명된 메시지를 다른 앱으로 보냅니다.

5분 분량 실제 화면, 가상의 샘플 데이터 22 10월 2026 업데이트

이 페이지의 내용

Webhook은 회사에서 어떤 일이 발생할 때 앱 주소로 POST하는 메시지로, 다른 앱이 계속 확인할 필요가 없게 해 줍니다.

  1. 1단계: 엔드포인트 추가

    관리 → 설정 → API 및 Webhook의 웹훅에서 엔드포인트 추가를 클릭하세요.

  2. 2단계: 주소 입력

    엔드포인트 URL(공개 https:// 주소여야 함)과 선택적으로 설명을 입력하세요.

  3. 3단계: 이벤트 선택

    이벤트에서 필요한 항목을 선택하거나 나중에 추가되는 것을 포함한 모든 이벤트를 선택하세요.

  4. 4단계: 서명 시크릿 복사

    저장하면 서명 시크릿이 한 번 표시됩니다. 수신 앱에 복사해 두면 각 메시지가 실제로 당사에서 왔는지 확인할 수 있습니다.

  5. 5단계: 테스트

    테스트 이벤트 보내기를 클릭하고 전송 로그를 확인하세요.

사용 가능한 이벤트

  • 연락처: 연락처가 생성되거나 업데이트됨.
  • 인보이스: 발행, 전액 결제, 무효화. 견적서: 수락됨.
  • 결제: 지급 또는 수금이 전기됨.
  • 매입 청구서: 수령(전기), 전액 결제. 경비: 경비가 기록됨.
  • 재고: 품목이 재주문 수준 이하로 떨어짐.
  • 휴가: 휴가 신청이 생성됨.

전송 및 재시도

  • 앱은 10초 이내에 2xx 상태로 응답해야 합니다. 그 외의 응답은 실패로 간주됩니다.
  • 실패한 전송은 몇 시간에 걸쳐 최대 6회 자동으로 재시도되며, 매번 대기 시간이 길어집니다.
  • 관리로 엔드포인트를 열면 전송 로그를 볼 수 있습니다: 각 이벤트의 페이로드, 서버의 응답 및 배송 완료, 실패 또는 대기 중 상태. 다시 보내려면 다시 보내기를 클릭하세요.
  • 일시 중지하려면 이 엔드포인트로 이벤트 전송 선택을 해제하고, 삭제하려면 제거를 클릭하세요. 오랫동안 계속 실패하는 엔드포인트는 자동으로 꺼집니다.

서명 확인

각 전송에는 X-Webhook-Signature: t=<timestamp>,v1=<signature> 헤더가 있습니다. 서명 시크릿으로 "<timestamp>.<raw body>"의 HMAC-SHA256을 계산하여 v1과 비교하고, 5분보다 오래된 타임스탬프는 거부하세요. X-Webhook-Id는 재시도 간에 동일하므로 중복을 무시하는 데 사용하세요.

제품에 대해 질문하기

소프트웨어로 할 수 있는 일, 작업 방법, 지원하는 국가와 언어를 물어보세요. 답변은 이 가이드를 바탕으로 합니다.

생각 중…

지금은 AI 어시스턴트를 사용할 수 없습니다. 가이드를 검색하거나 저희 팀에 문의하세요. 지원팀 문의

AI는 실수할 수 있습니다. 링크된 가이드를 확인하세요.

아직 도움이 필요하신가요?

지원팀이 모든 메시지를 읽고 알기 쉬운 말로 답변합니다.

지원팀 문의
AI와 채팅