Webhook 事件目錄
本頁列出您可以在 Wink 訂閱的所有 webhook 事件。設定說明請參考 Webhook 整合指南 或 Webhook 管理頁面。
- 在您的後台中前往 Applications > Webhooks。
- 建立一個 webhook 並選擇您想接收的事件 — 或留空以接收所有事件。
- 每當事件發生時，Wink 會向您的端點發送簽名的 HTTP POST。請參閱 Webhook 整合 了解信封格式、標頭、簽名驗證及重試機制。
所有事件類型
Section titled “所有事件類型”此表格由平台事件目錄於建置時生成，因此始終與 API 保持一致。
標示為已送達的事件類型會連結至 Webhooks API 的參考頁面，該頁面
記錄了精確的 JSON 主體（WebhookEnvelope，包含事件特定的 object）、Wink-* 標頭及
重試政策。未送達的事件類型存在於內部（付款、帳本、渠道管理同步等），但目前不會送給 webhook 訂閱者。
接收者 表示誰會收到事件：SUPPLIER（飯店）、AFFILIATE（與飯店有活躍銷售渠道的轉售商）、AGENT（完成訂房的旅行社）或 SELF（事件所屬的管理實體）。每個接收者收到的有效載荷格式相同；角色特定的細節藏於有效載荷的 links.self URL。
account.*
| 事件 | 描述 | 已送達 | 接收者 |
|---|---|---|---|
account.details.updated | The account's details changed. | 未送達 | — |
account.managers.update | The account's manager list changed. | ✓ 已送達 | SELF |
account.task.complete | An onboarding task was completed. | 未送達 | — |
account.task.create | An onboarding task was created for the account. | 未送達 | — |
account.task.remove | An onboarding task was removed. | 未送達 | — |
account.task.tax_id.complete | The tax-id onboarding task was completed. | 未送達 | — |
account.task.update | An onboarding task was updated. | 未送達 | — |
account.under_review | The account was placed under review. | 未送達 | — |
activity.*
| 事件 | 描述 | 已送達 | 接收者 |
|---|---|---|---|
activity.created | An activity was created. | ✓ 已送達 | AFFILIATE, SUPPLIER |
activity.deleted | An activity was deleted. | ✓ 已送達 | AFFILIATE, SUPPLIER |
activity.updated | An activity was updated. | ✓ 已送達 | AFFILIATE, SUPPLIER |
add_on.*
| 事件 | 描述 | 已送達 | 接收者 |
|---|---|---|---|
add_on.created | An add-on was created. | ✓ 已送達 | AFFILIATE, SUPPLIER |
add_on.deleted | An add-on was deleted. | ✓ 已送達 | AFFILIATE, SUPPLIER |
add_on.updated | An add-on was updated. | ✓ 已送達 | AFFILIATE, SUPPLIER |
booking.*
| 事件 | 描述 | 已送達 | 接收者 |
|---|---|---|---|
booking.cancelled | A booking was cancelled. | ✓ 已送達 | AFFILIATE, AGENT, SUPPLIER |
booking.create | A booking was created (confirmed). | ✓ 已送達 | AFFILIATE, AGENT, SUPPLIER |
booking.failed | A booking attempt failed. | ✓ 已送達 | AFFILIATE, AGENT, SUPPLIER |
booking.funds.available | Funds for a booking became available for payout. | ✓ 已送達 | AFFILIATE, AGENT, SUPPLIER |
booking.funds.ledgered | Funds for a booking were added to the ledger. | ✓ 已送達 | AFFILIATE, AGENT, SUPPLIER |
booking.initialize.complete | A booking initialisation completed. | 未送達 | — |
booking.initialize.request | A booking initialisation (checkout) was requested. | 未送達 | — |
booking.payout.complete | A payout for a booking completed. | 未送達 | — |
booking.payout.create | A payout for a booking was created. | 未送達 | — |
booking.processing | A booking is being processed. | 未送達 | — |
booking.refund.error | A booking was refunded because of a processing error. | 未送達 | — |
booking.refund.full | A booking was fully refunded. | ✓ 已送達 | AFFILIATE, AGENT, SUPPLIER |
booking.refund.partial | A booking was partially refunded. | ✓ 已送達 | AFFILIATE, AGENT, SUPPLIER |
booking.refund.request | A refund was requested for a booking. | ✓ 已送達 | AFFILIATE, AGENT, SUPPLIER |
booking.review.created | A guest submitted a review for a booking. | ✓ 已送達 | SUPPLIER |
booking.review.responded | The hotel responded to a guest review. | ✓ 已送達 | AFFILIATE, AGENT, SUPPLIER |
booking.sync.failed | A booking-to-channel-manager synchronisation failed. | 未送達 | — |
booking.sync.run | A booking-to-channel-manager synchronisation run started. | 未送達 | — |
channel-manager.*
| 事件 | 描述 | 已送達 | 接收者 |
|---|---|---|---|
channel-manager.update | A channel manager pushed an update. | 未送達 | — |
channel-manager.update.availability | A channel manager pushed an availability update. | 未送達 | — |
channel-manager.update.rate | A channel manager pushed a rate update. | 未送達 | — |
email.*
| 事件 | 描述 | 已送達 | 接收者 |
|---|---|---|---|
email.correspondence | An email correspondence was recorded. | 未送達 | — |
internal.*
| 事件 | 描述 | 已送達 | 接收者 |
|---|---|---|---|
internal.payment.failed | A payment failed (internal). | 未送達 | — |
internal.payment.processing | A payment is processing (internal). | 未送達 | — |
internal.payment.succeeded | A payment succeeded (internal). | 未送達 | — |
ledger.*
| 事件 | 描述 | 已送達 | 接收者 |
|---|---|---|---|
ledger.entry.create | A ledger entry was created. | 未送達 | — |
managing_entity.*
| 事件 | 描述 | 已送達 | 接收者 |
|---|---|---|---|
managing_entity.account_representative.updated | The account representative changed. | 未送達 | — |
managing_entity.agent.email.notification | An email notification was sent to the account's agent. | 未送達 | — |
managing_entity.agent.updated | The account's travel-agent details changed. | 未送達 | — |
managing_entity.city.updated | The account's address or city changed. | ✓ 已送達 | SELF |
managing_entity.created | A managing entity (account) was created. | ✓ 已送達 | SELF |
managing_entity.deleted | The account was deleted. | ✓ 已送達 | SELF |
managing_entity.information.updated | The account's general information changed. | ✓ 已送達 | SELF |
managing_entity.logo.updated | The account's logo changed. | ✓ 已送達 | SELF |
managing_entity.managed_by.updated | The entity managing this account on its behalf changed. | ✓ 已送達 | SELF |
managing_entity.manager.accepted | An invited manager accepted the invitation. | 未送達 | — |
managing_entity.manager.added | A manager was added to the account. | ✓ 已送達 | SELF |
managing_entity.manager.email.notification | An email notification was sent to an account manager. | 未送達 | — |
managing_entity.manager.invited | A manager was invited to the account. | ✓ 已送達 | SELF |
managing_entity.manager.owner.set | The account owner was set. | ✓ 已送達 | SELF |
managing_entity.manager.rejected | An invited manager rejected the invitation. | 未送達 | — |
managing_entity.manager.removed | A manager was removed from the account. | ✓ 已送達 | SELF |
managing_entity.name.updated | The account's display name changed. | 未送達 | — |
managing_entity.place_id.updated | The account's Google Place ID changed. | ✓ 已送達 | SELF |
managing_entity.profile_picture.updated | The account's profile picture changed. | ✓ 已送達 | SELF |
managing_entity.status.updated | The account's platform status changed (e.g. approved, suspended). | ✓ 已送達 | SELF |
managing_entity.subscription.changed | The account's platform subscription changed. | 未送達 | — |
managing_entity.subscription.invoice.changed | The status of a subscription invoice changed. | ✓ 已送達 | SELF |
managing_entity.subscription.provisioned | A platform subscription was provisioned for the account. | ✓ 已送達 | SELF |
managing_entity.unique_id.updated | The account's short unique id changed. | ✓ 已送達 | SELF |
managing_entity.url_name.updated | The account's URL name (slug) changed. | ✓ 已送達 | SELF |
master_rate.*
| 事件 | 描述 | 已送達 | 接收者 |
|---|---|---|---|
master_rate.created | A master rate was created. | ✓ 已送達 | AFFILIATE, SUPPLIER |
master_rate.deleted | A master rate was deleted. | ✓ 已送達 | AFFILIATE, SUPPLIER |
master_rate.updated | A master rate was updated. | ✓ 已送達 | AFFILIATE, SUPPLIER |
meeting_room.*
| 事件 | 描述 | 已送達 | 接收者 |
|---|---|---|---|
meeting_room.created | A meeting room was created. | ✓ 已送達 | AFFILIATE, SUPPLIER |
meeting_room.deleted | A meeting room was deleted. | ✓ 已送達 | AFFILIATE, SUPPLIER |
meeting_room.updated | A meeting room was updated. | ✓ 已送達 | AFFILIATE, SUPPLIER |
payee.*
| 事件 | 描述 | 已送達 | 接收者 |
|---|---|---|---|
payee.create | A payee was created. | 未送達 | — |
payee.create.failure | Creating a payee failed. | 未送達 | — |
payee.update | A payee was updated. | 未送達 | — |
payee.update.failure | Updating a payee failed. | 未送達 | — |
perk.*
| 事件 | 描述 | 已送達 | 接收者 |
|---|---|---|---|
perk.deleted | A perk was deleted. | 未送達 | — |
perk.updated | A perk was updated. | 未送達 | — |
property.*
| 事件 | 描述 | 已送達 | 接收者 |
|---|---|---|---|
property.address.updated | A property's address changed. | ✓ 已送達 | AFFILIATE, SUPPLIER |
property.created | A property (hotel) was created. | ✓ 已送達 | AFFILIATE, SUPPLIER |
property.deleted | A property was deleted. | ✓ 已送達 | AFFILIATE, SUPPLIER |
property.geolocation.updated | A property's geolocation changed. | ✓ 已送達 | AFFILIATE, SUPPLIER |
property.name.updated | A property's name changed. | ✓ 已送達 | AFFILIATE, SUPPLIER |
property.policy.created | A property policy was created. | ✓ 已送達 | AFFILIATE, SUPPLIER |
property.policy.updated | A property policy changed. | ✓ 已送達 | AFFILIATE, SUPPLIER |
property.profile.updated | A property's profile changed. | ✓ 已送達 | AFFILIATE, SUPPLIER |
property.registered | A property completed registration. | ✓ 已送達 | AFFILIATE, SUPPLIER |
property.services.updated | A property's services/amenities changed. | ✓ 已送達 | AFFILIATE, SUPPLIER |
property.status.updated | A property's platform status changed. | ✓ 已送達 | AFFILIATE, SUPPLIER |
property.updated | A property was updated. | 未送達 | — |
property.welcome_text.updated | A property's welcome text changed. | ✓ 已送達 | AFFILIATE, SUPPLIER |
rate_modifier.*
| 事件 | 描述 | 已送達 | 接收者 |
|---|---|---|---|
rate_modifier.updated | A rate modifier was updated. | 未送達 | — |
rate_plan.*
| 事件 | 描述 | 已送達 | 接收者 |
|---|---|---|---|
rate_plan.created | A rate plan was created. | ✓ 已送達 | AFFILIATE, SUPPLIER |
rate_plan.deleted | A rate plan was deleted. | ✓ 已送達 | AFFILIATE, SUPPLIER |
rate_plan.updated | A rate plan was updated. | ✓ 已送達 | AFFILIATE, SUPPLIER |
restaurant.*
| 事件 | 描述 | 已送達 | 接收者 |
|---|---|---|---|
restaurant.created | A restaurant was created. | ✓ 已送達 | AFFILIATE, SUPPLIER |
restaurant.deleted | A restaurant was deleted. | ✓ 已送達 | AFFILIATE, SUPPLIER |
restaurant.updated | A restaurant was updated. | ✓ 已送達 | AFFILIATE, SUPPLIER |
room_type.*
| 事件 | 描述 | 已送達 | 接收者 |
|---|---|---|---|
room_type.created | A room type was created. | ✓ 已送達 | AFFILIATE, SUPPLIER |
room_type.deleted | A room type was deleted. | ✓ 已送達 | AFFILIATE, SUPPLIER |
room_type.updated | A room type was updated. | ✓ 已送達 | AFFILIATE, SUPPLIER |
sales_channel.*
| 事件 | 描述 | 已送達 | 接收者 |
|---|---|---|---|
sales_channel.created | A sales-channel relationship (supplier ↔ reseller) was created. | ✓ 已送達 | AFFILIATE, SUPPLIER |
sales_channel.deleted | A sales-channel relationship was deleted. | ✓ 已送達 | AFFILIATE, SUPPLIER |
sales_channel.updated | A sales-channel relationship was updated. | ✓ 已送達 | AFFILIATE, SUPPLIER |
spa.*
| 事件 | 描述 | 已送達 | 接收者 |
|---|---|---|---|
spa.created | A spa was created. | ✓ 已送達 | AFFILIATE, SUPPLIER |
spa.deleted | A spa was deleted. | ✓ 已送達 | AFFILIATE, SUPPLIER |
spa.updated | A spa was updated. | ✓ 已送達 | AFFILIATE, SUPPLIER |
special_rate.*
| 事件 | 描述 | 已送達 | 接收者 |
|---|---|---|---|
special_rate.created | A promotion (special rate) was created. | ✓ 已送達 | AFFILIATE, SUPPLIER |
special_rate.deleted | A promotion was deleted. | ✓ 已送達 | AFFILIATE, SUPPLIER |
special_rate.updated | A promotion was updated. | ✓ 已送達 | AFFILIATE, SUPPLIER |
- Webhook 整合指南 — 設定步驟與最佳實踐。
- Webhooks — 管理您的 webhook 訂閱。
- Applications — 管理 API 憑證。
- Build on Wink — 開發者平台概覽。