웹훅이 무엇인가요?

**웹훅(Webhook)**은 아주 간단하게 말하면 ‘어떤 일이 생길 때 자동으로 알려줘’라고 외부 도구에게 메시지를 보내는 기능이에요.

간단히 예를 들어 보면

누군가 내 상품을 구매했을 때 슬랙이나 카카오톡으로 [결제 완료] 메시지가 오게 만든다든지

멤버십 결제를 취소했을 때 자동으로 구글 시트에 기록되게 한다든지 할 때 필요한 게 바로 웹훅이에요.

웹훅은 어떻게 작동하나요?

<aside>

• 어떤 일이 생기면 (= 트리거 이벤트 발생)
• 어디로 보낼지 미리 설정한 주소로 (= 내가 설정한 URL)
• 자동으로 데이터가 전송돼요 (=JSON 형태의 정보) </aside>

래피드에서는 다음 4가지 상황을 ‘어떤 일’로 볼 수 있어요

래피드에서 웹훅 연결하는 방법

<aside>

• 상품(혹은 멤버십) 관리 페이지 → 외부 툴 연동 탭으로 이동
• 웹훅의 [연결하기] 버튼 클릭
• 데이터를 보내고 싶은 URL 입력 후 저장 → 연동 완료! </aside>

이 과정에서 조심해야 할 점은

1. URL은 반드시 데이터를 받을 준비가 되어있어야 해요
   • 웹훅을 수신할 URL은 HTTP 또는 HTTPS 프로토콜을 사용해야 해요
   • JSON 형식의 데이터를 POST 방식으로 받아야 해요
   • 응답은 5초 이내에 성공 상태 코드(2XX)를 반환해야 해요
2. 만약 오류가 발생했다면 [연동 오류 자세히 보기]를 확인해요
   • 오류 메시지를 확인하고, 문제를 해결했다면 연동을 해제하고 다시 연결하면 돼요