콘텐츠로 이동
Wink

웹훅 통합

웹훅은 Wink 계정에서 이벤트가 발생할 때 실시간 알림을 받을 수 있도록 시스템에 전달합니다 — 새 예약, 취소, 결제 업데이트 등. 이 가이드는 설정 방법과 모범 사례를 안내합니다.

대상

섹션 제목: “대상”

이 가이드는 Wink를 외부 시스템(예: PMS, 채널 관리자, CRM 또는 맞춤 대시보드)과 통합하는 개발자를 위한 것입니다.

웹훅 작동 방식

섹션 제목: “웹훅 작동 방식”
  1. Wink에 웹훅 URL을 등록합니다.
  2. 이벤트가 발생하면(예: 새 예약) Wink가 HTTP POST를 해당 URL로 전송합니다.
  3. 서버가 페이로드를 처리하고 200 OK로 응답합니다.

웹훅 설정하기

섹션 제목: “웹훅 설정하기”
  1. 계정에 로그인합니다(Extranet, Studio 또는 TripPay — 모두 웹훅을 지원합니다).
  2. Applications로 이동한 후 Webhooks를 선택합니다. Webhooks를 참조하세요.
  3. Create webhook을 클릭합니다.
  4. 이름을 입력합니다(예: “PMS 예약 동기화”).
  5. 웹훅 URL을 입력합니다 — 서버의 HTTPS 엔드포인트입니다.
  6. 이벤트 선택 — 구독할 특정 이벤트를 선택하거나 모두 받으려면 비워 둡니다.
  7. Enabled를 켭니다.
  8. Save를 클릭합니다.

이벤트 유형

섹션 제목: “이벤트 유형”

Wink는 다양한 이벤트 유형을 지원합니다. 일반적인 이벤트는 다음과 같습니다:

  • 예약 생성됨 — 새 예약이 확정되었습니다.
  • 예약 취소됨 — 예약이 취소되었습니다.
  • 결제 완료됨 — 결제가 처리되었습니다.
  • 예약 업데이트됨 — 예약 세부 정보가 변경되었습니다.

모범 사례

섹션 제목: “모범 사례”
  • HTTPS 사용 — Wink는 HTTPS 엔드포인트에만 페이로드를 전송합니다.
  • 빠른 응답 — 페이로드를 받으면 즉시 200 OK를 반환하세요. 무거운 처리는 비동기적으로 수행하세요.
  • 멱등성 — 핸들러는 멱등성을 가져야 합니다. Wink는 200 응답을 받지 못하면 재전송할 수 있습니다.
  • 출처 검증 — 처리 전에 요청이 Wink에서 온 것인지 확인하세요.
  • 로깅 — 받은 모든 웹훅 페이로드를 기록하세요. 통합 문제를 디버깅하는 데 매우 유용합니다.

일시 중지 및 삭제

섹션 제목: “일시 중지 및 삭제”

웹훅을 삭제하지 않고 비활성화할 수 있습니다. 이렇게 하면 구성을 유지한 채 알림 전송을 일시 중지하여 문제를 해결할 수 있습니다. 준비가 되면 다시 활성화하세요.

웹훅을 삭제하면 영구적으로 제거됩니다. 해당 웹훅에 의존하는 통합은 알림을 더 이상 받지 못합니다.

추가 자료

섹션 제목: “추가 자료”