콘텐츠로 이동
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는 계정 관리, 예약 계약, 결제, 채널 매니저 업데이트, 엔터티 관리 등 다양한 카테고리에서 64개 이상의 웹훅 이벤트 유형을 지원합니다. 일반적인 이벤트는 다음과 같습니다:

카테고리예시
예약booking.create, booking.cancelled
예약 계약booking.contract.created, booking.contract.processing, booking.contract.cancelled
결제internal.payment.succeeded, internal.payment.failed
환불booking.contract.refund.partial, booking.contract.refund.full
채널 매니저channel-manager.update.rate, channel-manager.update.availability
계정account.create, account.status.updated

모든 이벤트 유형과 설명이 포함된 전체 목록은 Webhook Events Catalog를 참조하세요.

64개 이상의 모든 이벤트 유형 보기

모범 사례

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

일시 중지 및 삭제

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

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

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

추가 자료

섹션 제목: “추가 자료”