Danh mục Sự kiện Webhook

Trang này liệt kê mọi sự kiện webhook bạn có thể đăng ký trên Wink. Để biết hướng dẫn thiết lập, xem Hướng dẫn Tích hợp Webhook hoặc Trang quản lý Webhooks.

Cách đăng ký

1. Điều hướng đến Applications > Webhooks trong cổng thông tin của bạn.
2. Tạo một webhook và chọn các sự kiện bạn muốn nhận — hoặc để trống danh sách để nhận mọi sự kiện.
3. Wink gửi một HTTP POST có chữ ký đến điểm cuối của bạn mỗi khi sự kiện xảy ra. Xem Tích hợp Webhook để biết về phong bì, tiêu đề, xác minh chữ ký và thử lại.

Mọi loại sự kiện

Bảng này được tạo từ danh mục sự kiện của nền tảng vào thời điểm xây dựng, vì vậy luôn khớp với API. Các loại sự kiện được đánh dấu là đã gửi liên kết đến trang tham khảo của chúng trong Webhooks API, nơi tài liệu về chính xác phần thân JSON (WebhookEnvelope với object đặc thù cho sự kiện), các tiêu đề Wink-* và chính sách thử lại được ghi lại. Các loại sự kiện không được gửi tồn tại nội bộ (thanh toán, sổ cái, đồng bộ kênh quản lý, …) nhưng hiện không được gửi đến người đăng ký webhook.

Người nhận cho biết ai nhận sự kiện: SUPPLIER (khách sạn), AFFILIATE (đại lý bán lại có kênh bán hàng hoạt động với khách sạn), AGENT (đại lý du lịch đã đặt phòng) hoặc SELF (thực thể quản lý mà sự kiện liên quan). Mỗi người nhận nhận cùng một dạng payload; chi tiết theo vai trò nằm sau URL links.self trong payload.

account.*

Sự kiện	Mô tả	Đã gửi	Người nhận
account.details.updated	The account's details changed.	chưa gửi	—
account.managers.update	The account's manager list changed.	✓ đã gửi	SELF
account.task.complete	An onboarding task was completed.	chưa gửi	—
account.task.create	An onboarding task was created for the account.	chưa gửi	—
account.task.remove	An onboarding task was removed.	chưa gửi	—
account.task.tax_id.complete	The tax-id onboarding task was completed.	chưa gửi	—
account.task.update	An onboarding task was updated.	chưa gửi	—
account.under_review	The account was placed under review.	chưa gửi	—

activity.*

Sự kiện	Mô tả	Đã gửi	Người nhận
activity.created	An activity was created.	✓ đã gửi	AFFILIATE, SUPPLIER
activity.deleted	An activity was deleted.	✓ đã gửi	AFFILIATE, SUPPLIER
activity.updated	An activity was updated.	✓ đã gửi	AFFILIATE, SUPPLIER

add_on.*

Sự kiện	Mô tả	Đã gửi	Người nhận
add_on.created	An add-on was created.	✓ đã gửi	AFFILIATE, SUPPLIER
add_on.deleted	An add-on was deleted.	✓ đã gửi	AFFILIATE, SUPPLIER
add_on.updated	An add-on was updated.	✓ đã gửi	AFFILIATE, SUPPLIER

booking.*

Sự kiện	Mô tả	Đã gửi	Người nhận
booking.cancelled	A booking was cancelled.	✓ đã gửi	AFFILIATE, AGENT, SUPPLIER
booking.create	A booking was created (confirmed).	✓ đã gửi	AFFILIATE, AGENT, SUPPLIER
booking.failed	A booking attempt failed.	✓ đã gửi	AFFILIATE, AGENT, SUPPLIER
booking.funds.available	Funds for a booking became available for payout.	✓ đã gửi	AFFILIATE, AGENT, SUPPLIER
booking.funds.ledgered	Funds for a booking were added to the ledger.	✓ đã gửi	AFFILIATE, AGENT, SUPPLIER
booking.initialize.complete	A booking initialisation completed.	chưa gửi	—
booking.initialize.request	A booking initialisation (checkout) was requested.	chưa gửi	—
booking.payout.complete	A payout for a booking completed.	chưa gửi	—
booking.payout.create	A payout for a booking was created.	chưa gửi	—
booking.processing	A booking is being processed.	chưa gửi	—
booking.refund.error	A booking was refunded because of a processing error.	chưa gửi	—
booking.refund.full	A booking was fully refunded.	✓ đã gửi	AFFILIATE, AGENT, SUPPLIER
booking.refund.partial	A booking was partially refunded.	✓ đã gửi	AFFILIATE, AGENT, SUPPLIER
booking.refund.request	A refund was requested for a booking.	✓ đã gửi	AFFILIATE, AGENT, SUPPLIER
booking.review.created	A guest submitted a review for a booking.	✓ đã gửi	SUPPLIER
booking.review.responded	The hotel responded to a guest review.	✓ đã gửi	AFFILIATE, AGENT, SUPPLIER
booking.sync.failed	A booking-to-channel-manager synchronisation failed.	chưa gửi	—
booking.sync.run	A booking-to-channel-manager synchronisation run started.	chưa gửi	—

channel-manager.*

Sự kiện	Mô tả	Đã gửi	Người nhận
channel-manager.update	A channel manager pushed an update.	chưa gửi	—
channel-manager.update.availability	A channel manager pushed an availability update.	chưa gửi	—
channel-manager.update.rate	A channel manager pushed a rate update.	chưa gửi	—

email.*

Sự kiện	Mô tả	Đã gửi	Người nhận
email.correspondence	An email correspondence was recorded.	chưa gửi	—

internal.*

Sự kiện	Mô tả	Đã gửi	Người nhận
internal.payment.failed	A payment failed (internal).	chưa gửi	—
internal.payment.processing	A payment is processing (internal).	chưa gửi	—
internal.payment.succeeded	A payment succeeded (internal).	chưa gửi	—

ledger.*

Sự kiện	Mô tả	Đã gửi	Người nhận
ledger.entry.create	A ledger entry was created.	chưa gửi	—

managing_entity.*

Sự kiện	Mô tả	Đã gửi	Người nhận
managing_entity.account_representative.updated	The account representative changed.	chưa gửi	—
managing_entity.agent.email.notification	An email notification was sent to the account's agent.	chưa gửi	—
managing_entity.agent.updated	The account's travel-agent details changed.	chưa gửi	—
managing_entity.city.updated	The account's address or city changed.	✓ đã gửi	SELF
managing_entity.created	A managing entity (account) was created.	✓ đã gửi	SELF
managing_entity.deleted	The account was deleted.	✓ đã gửi	SELF
managing_entity.information.updated	The account's general information changed.	✓ đã gửi	SELF
managing_entity.logo.updated	The account's logo changed.	✓ đã gửi	SELF
managing_entity.managed_by.updated	The entity managing this account on its behalf changed.	✓ đã gửi	SELF
managing_entity.manager.accepted	An invited manager accepted the invitation.	chưa gửi	—
managing_entity.manager.added	A manager was added to the account.	✓ đã gửi	SELF
managing_entity.manager.email.notification	An email notification was sent to an account manager.	chưa gửi	—
managing_entity.manager.invited	A manager was invited to the account.	✓ đã gửi	SELF
managing_entity.manager.owner.set	The account owner was set.	✓ đã gửi	SELF
managing_entity.manager.rejected	An invited manager rejected the invitation.	chưa gửi	—
managing_entity.manager.removed	A manager was removed from the account.	✓ đã gửi	SELF
managing_entity.name.updated	The account's display name changed.	chưa gửi	—
managing_entity.place_id.updated	The account's Google Place ID changed.	✓ đã gửi	SELF
managing_entity.profile_picture.updated	The account's profile picture changed.	✓ đã gửi	SELF
managing_entity.status.updated	The account's platform status changed (e.g. approved, suspended).	✓ đã gửi	SELF
managing_entity.subscription.changed	The account's platform subscription changed.	chưa gửi	—
managing_entity.subscription.invoice.changed	The status of a subscription invoice changed.	✓ đã gửi	SELF
managing_entity.subscription.provisioned	A platform subscription was provisioned for the account.	✓ đã gửi	SELF
managing_entity.unique_id.updated	The account's short unique id changed.	✓ đã gửi	SELF
managing_entity.url_name.updated	The account's URL name (slug) changed.	✓ đã gửi	SELF

master_rate.*

Sự kiện	Mô tả	Đã gửi	Người nhận
master_rate.created	A master rate was created.	✓ đã gửi	AFFILIATE, SUPPLIER
master_rate.deleted	A master rate was deleted.	✓ đã gửi	AFFILIATE, SUPPLIER
master_rate.updated	A master rate was updated.	✓ đã gửi	AFFILIATE, SUPPLIER

meeting_room.*

Sự kiện	Mô tả	Đã gửi	Người nhận
meeting_room.created	A meeting room was created.	✓ đã gửi	AFFILIATE, SUPPLIER
meeting_room.deleted	A meeting room was deleted.	✓ đã gửi	AFFILIATE, SUPPLIER
meeting_room.updated	A meeting room was updated.	✓ đã gửi	AFFILIATE, SUPPLIER

payee.*

Sự kiện	Mô tả	Đã gửi	Người nhận
payee.create	A payee was created.	chưa gửi	—
payee.create.failure	Creating a payee failed.	chưa gửi	—
payee.update	A payee was updated.	chưa gửi	—
payee.update.failure	Updating a payee failed.	chưa gửi	—

perk.*

Sự kiện	Mô tả	Đã gửi	Người nhận
perk.deleted	A perk was deleted.	chưa gửi	—
perk.updated	A perk was updated.	chưa gửi	—

property.*

Sự kiện	Mô tả	Đã gửi	Người nhận
property.address.updated	A property's address changed.	✓ đã gửi	AFFILIATE, SUPPLIER
property.created	A property (hotel) was created.	✓ đã gửi	AFFILIATE, SUPPLIER
property.deleted	A property was deleted.	✓ đã gửi	AFFILIATE, SUPPLIER
property.geolocation.updated	A property's geolocation changed.	✓ đã gửi	AFFILIATE, SUPPLIER
property.name.updated	A property's name changed.	✓ đã gửi	AFFILIATE, SUPPLIER
property.policy.created	A property policy was created.	✓ đã gửi	AFFILIATE, SUPPLIER
property.policy.updated	A property policy changed.	✓ đã gửi	AFFILIATE, SUPPLIER
property.profile.updated	A property's profile changed.	✓ đã gửi	AFFILIATE, SUPPLIER
property.registered	A property completed registration.	✓ đã gửi	AFFILIATE, SUPPLIER
property.services.updated	A property's services/amenities changed.	✓ đã gửi	AFFILIATE, SUPPLIER
property.status.updated	A property's platform status changed.	✓ đã gửi	AFFILIATE, SUPPLIER
property.updated	A property was updated.	chưa gửi	—
property.welcome_text.updated	A property's welcome text changed.	✓ đã gửi	AFFILIATE, SUPPLIER

rate_modifier.*

Sự kiện	Mô tả	Đã gửi	Người nhận
rate_modifier.updated	A rate modifier was updated.	chưa gửi	—

rate_plan.*

Sự kiện	Mô tả	Đã gửi	Người nhận
rate_plan.created	A rate plan was created.	✓ đã gửi	AFFILIATE, SUPPLIER
rate_plan.deleted	A rate plan was deleted.	✓ đã gửi	AFFILIATE, SUPPLIER
rate_plan.updated	A rate plan was updated.	✓ đã gửi	AFFILIATE, SUPPLIER

restaurant.*

Sự kiện	Mô tả	Đã gửi	Người nhận
restaurant.created	A restaurant was created.	✓ đã gửi	AFFILIATE, SUPPLIER
restaurant.deleted	A restaurant was deleted.	✓ đã gửi	AFFILIATE, SUPPLIER
restaurant.updated	A restaurant was updated.	✓ đã gửi	AFFILIATE, SUPPLIER

room_type.*

Sự kiện	Mô tả	Đã gửi	Người nhận
room_type.created	A room type was created.	✓ đã gửi	AFFILIATE, SUPPLIER
room_type.deleted	A room type was deleted.	✓ đã gửi	AFFILIATE, SUPPLIER
room_type.updated	A room type was updated.	✓ đã gửi	AFFILIATE, SUPPLIER

sales_channel.*

Sự kiện	Mô tả	Đã gửi	Người nhận
sales_channel.created	A sales-channel relationship (supplier ↔ reseller) was created.	✓ đã gửi	AFFILIATE, SUPPLIER
sales_channel.deleted	A sales-channel relationship was deleted.	✓ đã gửi	AFFILIATE, SUPPLIER
sales_channel.updated	A sales-channel relationship was updated.	✓ đã gửi	AFFILIATE, SUPPLIER

spa.*

Sự kiện	Mô tả	Đã gửi	Người nhận
spa.created	A spa was created.	✓ đã gửi	AFFILIATE, SUPPLIER
spa.deleted	A spa was deleted.	✓ đã gửi	AFFILIATE, SUPPLIER
spa.updated	A spa was updated.	✓ đã gửi	AFFILIATE, SUPPLIER

special_rate.*

Sự kiện	Mô tả	Đã gửi	Người nhận
special_rate.created	A promotion (special rate) was created.	✓ đã gửi	AFFILIATE, SUPPLIER
special_rate.deleted	A promotion was deleted.	✓ đã gửi	AFFILIATE, SUPPLIER
special_rate.updated	A promotion was updated.	✓ đã gửi	AFFILIATE, SUPPLIER

Mẹo

Bắt đầu bằng cách đăng ký tất cả các sự kiện trong quá trình phát triển. Khi bạn hiểu được payload nào hệ thống của bạn cần, hãy thu hẹp đăng ký để giảm nhiễu. Gửi cho mình một sự kiện thử từ Applications > Webhooks (hoặc POST …/webhook/{id}/test) để xác nhận điểm cuối và kiểm tra chữ ký trước khi hoạt động chính thức.

Đọc thêm

• Hướng dẫn Tích hợp Webhook — Các bước thiết lập và thực hành tốt nhất.
• Webhooks — Quản lý đăng ký webhook của bạn.
• Applications — Quản lý thông tin xác thực API.
• Phát triển trên Wink — Tổng quan nền tảng dành cho nhà phát triển.