Bỏ qua để đến nội dung
Wink

Tích hợp Webhook

Webhook cho phép hệ thống của bạn nhận thông báo thời gian thực khi có sự kiện xảy ra trên tài khoản Wink của bạn — đặt phòng mới, hủy phòng, cập nhật thanh toán và nhiều hơn nữa. Hướng dẫn này sẽ dẫn bạn qua các bước thiết lập và các thực hành tốt nhất.

Đối tượng

Phần tiêu đề “Đối tượng”

Hướng dẫn này dành cho các nhà phát triển tích hợp Wink với các hệ thống bên ngoài như hệ thống quản lý bất động sản (PMS), quản lý kênh, CRM hoặc bảng điều khiển tùy chỉnh.

Cách webhook hoạt động

Phần tiêu đề “Cách webhook hoạt động”
  1. Bạn đăng ký một URL webhook trên Wink.
  2. Khi có sự kiện xảy ra (ví dụ: một đặt phòng mới), Wink sẽ gửi một HTTP POST đến URL của bạn.
  3. Máy chủ của bạn xử lý payload và phản hồi với 200 OK.

Thiết lập webhook

Phần tiêu đề “Thiết lập webhook”
  1. Đăng nhập vào tài khoản của bạn (Extranet, Studio hoặc TripPay — tất cả đều hỗ trợ webhook).
  2. Điều hướng đến Applications rồi đến Webhooks. Xem Webhooks.
  3. Nhấn Create webhook.
  4. Nhập tên (ví dụ: “Đồng bộ Đặt phòng PMS”).
  5. Nhập URL webhook của bạn — điểm cuối HTTPS trên máy chủ của bạn.
  6. Chọn sự kiện — Chọn các sự kiện cụ thể để đăng ký, hoặc để trống để nhận tất cả các sự kiện.
  7. Bật Enabled.
  8. Nhấn Save.

Các loại sự kiện

Phần tiêu đề “Các loại sự kiện”

Wink hỗ trợ hơn 64 loại sự kiện webhook thuộc các danh mục bao gồm quản lý tài khoản, hợp đồng đặt phòng, thanh toán, cập nhật quản lý kênh và quản lý thực thể. Các sự kiện phổ biến bao gồm:

Danh mụcVí dụ
Đặt phòngbooking.create, booking.cancelled
Hợp đồng đặt phòngbooking.contract.created, booking.contract.processing, booking.contract.cancelled
Thanh toáninternal.payment.succeeded, internal.payment.failed
Hoàn tiềnbooking.contract.refund.partial, booking.contract.refund.full
Quản lý kênhchannel-manager.update.rate, channel-manager.update.availability
Tài khoảnaccount.create, account.status.updated

Để xem danh sách đầy đủ các loại sự kiện kèm mô tả, xem Danh mục Sự kiện Webhook.

Xem tất cả hơn 64 loại sự kiện

Thực hành tốt nhất

Phần tiêu đề “Thực hành tốt nhất”
  • Sử dụng HTTPS — Wink chỉ gửi payload đến các điểm cuối HTTPS.
  • Phản hồi nhanh — Trả về 200 OK ngay khi nhận payload. Thực hiện các xử lý nặng một cách bất đồng bộ.
  • Tính idempotent — Bộ xử lý của bạn nên idempotent. Wink có thể thử gửi lại nếu không nhận được phản hồi 200.
  • Xác thực nguồn — Xác minh các yêu cầu đến là từ Wink trước khi xử lý.
  • Ghi nhật ký — Ghi lại mọi payload webhook bạn nhận được. Điều này giúp việc gỡ lỗi tích hợp dễ dàng hơn nhiều.

Tạm dừng và xóa

Phần tiêu đề “Tạm dừng và xóa”

Bạn có thể vô hiệu hóa một webhook mà không cần xóa nó. Điều này tạm dừng việc gửi thông báo để bạn có thể khắc phục sự cố mà không mất cấu hình. Khi sẵn sàng, bật lại.

Xóa webhook sẽ xóa vĩnh viễn nó. Bất kỳ tích hợp nào dựa vào webhook đó sẽ ngừng nhận thông báo.

Đọc thêm

Phần tiêu đề “Đọc thêm”