Webhook 事件目錄

本頁列出您可以在 Wink 訂閱的所有 webhook 事件。設定說明請參閱 Webhook 整合指南 或 Webhook 管理頁面。

如何訂閱

1. 在您的後台中前往 Applications > Webhooks。
2. 建立 webhook 並選擇您想接收的事件。
3. 每當事件發生時，Wink 會向您的端點發送 HTTP POST。

完整設定步驟與最佳實踐，請參閱 Webhook 整合。

---

管理實體事件

管理實體（物業、加盟商、公司）及其管理的事件。

生命週期

事件	Key	說明
實體已建立	managing_entity.created	新的管理實體已建立。
實體已刪除	managing_entity.deleted	管理實體已被刪除。
狀態已更新	managing_entity.status.updated	實體狀態已變更。
審核中	account.under_review	實體帳戶正在審核中。

訂閱

事件	Key	說明
訂閱已配置	managing_entity.subscription.provisioned	新訂閱已配置。
訂閱已變更	managing_entity.subscription.changed	訂閱方案已變更。
訂閱發票已變更	managing_entity.subscription.invoice.changed	訂閱發票已更新。

管理者生命週期

事件	Key	說明
管理者已新增	managing_entity.manager.added	新管理者已被新增。
管理者邀請已發送	managing_entity.manager.invited	管理者邀請已發送。
管理者已移除	managing_entity.manager.removed	管理者已被移除。
管理者邀請已接受	managing_entity.manager.accepted	管理者邀請已被接受。
管理者邀請已拒絕	managing_entity.manager.rejected	管理者邀請已被拒絕。
所有權已設定	managing_entity.manager.owner.set	實體所有權已轉移。
管理者列表已更新	account.managers.update	管理者列表已變更。

實體資訊

事件	Key	說明
資訊已更新	managing_entity.information.updated	實體資訊已更新。
地址已更新	managing_entity.city.updated	實體地址/城市已變更。
名稱已更新	managing_entity.name.updated	實體名稱已變更。
URL 名稱已更新	managing_entity.url_name.updated	實體自訂 URL 已變更。
唯一 ID 已更新	managing_entity.unique_id.updated	實體唯一識別碼已變更。
管理關係已更新	managing_entity.managed_by.updated	實體的上層/管理關係已變更。
地點 ID 已更新	managing_entity.place_id.updated	實體的 Google 地點 ID 已變更。
帳戶代表已更新	managing_entity.account_representative.updated	帳戶代表已變更。
個人檔案圖片已更新	managing_entity.profile_picture.updated	實體個人檔案圖片已更新。
標誌已更新	managing_entity.logo.updated	實體標誌已更新。
詳細資料已更新	account.details.updated	帳戶詳細欄位已變更。
代理人已更新	managing_entity.agent.updated	實體代理人已修改。

通知

事件	Key	說明
代理人電子郵件通知	managing_entity.agent.email.notification	已向代理人發送電子郵件通知。
管理者電子郵件通知	managing_entity.manager.email.notification	已向管理者發送電子郵件通知。

帳戶任務

事件	Key	說明
任務已建立	account.task.create	新任務已新增至帳戶。
任務已更新	account.task.update	帳戶任務已修改。
任務已移除	account.task.remove	帳戶任務已被移除。
任務已完成	account.task.complete	帳戶任務已完成。
稅號任務已完成	account.task.tax_id.complete	稅號驗證任務已完成。

---

訂單事件

Wink 訂單生命週期事件，從建立到退款與付款。

核心訂單

事件	Key	說明
訂單已建立	booking.create	新訂單已建立。
訂單已取消	booking.cancelled	訂單已取消。
訂單失敗	booking.failed	訂單嘗試失敗。
訂單處理中	booking.processing	訂單付款正在處理中。
初始化請求	booking.initialize.request	訂單初始化已請求。
初始化完成	booking.initialize.complete	訂單初始化已完成。

退款

事件	Key	說明
退款請求	booking.refund.request	已提交退款請求。
退款錯誤	booking.refund.error	處理退款時發生錯誤。
部分退款	booking.refund.partial	已發出部分退款。
全額退款	booking.refund.full	已發出全額退款。

付款

事件	Key	說明
付款已建立	booking.payout.create	訂單付款已建立。
付款已完成	booking.payout.complete	付款已成功完成。
資金可用	booking.funds.available	訂單資金可供結算。
資金已入帳	booking.funds.ledgered	訂單資金已記錄於帳本。

評價

事件	Key	說明
評價已提交	booking.review.created	訂單的旅客評價已提交。
評價已回覆	booking.review.responded	物業已回覆訂單評價。

---

物業事件

物業檔案與內容事件，發送給該物業的 webhook 訂閱者。

事件	Key	說明
物業已建立	property.created	新物業已建立。
物業已更新	property.updated	物業詳細資料已更新。
物業已刪除	property.deleted	物業已被移除。
物業已註冊	property.registered	物業已完成註冊。
狀態已更新	property.status.updated	物業外部狀態已變更。
名稱已更新	property.name.updated	物業名稱已變更。
地址已更新	property.address.updated	物業地址已更新。
地理位置已更新	property.geolocation.updated	物業地理位置已更新。
檔案已更新	property.profile.updated	物業檔案內容已變更。
服務已更新	property.services.updated	物業服務/設施列表已變更。
歡迎文字已更新	property.welcome_text.updated	物業歡迎訊息已變更。
政策已建立	property.policy.created	新物業政策已建立。
政策已更新	property.policy.updated	物業政策已更新。

---

庫存事件

物業內庫存項目事件，發送給該物業的 webhook 訂閱者。

房型

事件	Key	說明
房型已建立	room_type.created	新房型已新增。
房型已更新	room_type.updated	房型已修改。
房型已刪除	room_type.deleted	房型已移除。

價格方案

事件	Key	說明
價格方案已建立	rate_plan.created	新價格方案已建立。
價格方案已更新	rate_plan.updated	價格方案已修改。
價格方案已刪除	rate_plan.deleted	價格方案已移除。

主價格

事件	Key	說明
主價格已建立	master_rate.created	新主價格已建立。
主價格已更新	master_rate.updated	主價格已修改。
主價格已刪除	master_rate.deleted	主價格已移除。

附加項目

事件	Key	說明
附加項目已建立	add_on.created	新附加項目已建立。
附加項目已更新	add_on.updated	附加項目已修改。
附加項目已刪除	add_on.deleted	附加項目已移除。

會議室

事件	Key	說明
會議室已建立	meeting_room.created	新會議室已新增。
會議室已更新	meeting_room.updated	會議室已修改。
會議室已刪除	meeting_room.deleted	會議室已移除。

餐廳

事件	Key	說明
餐廳已建立	restaurant.created	新餐廳已新增。
餐廳已更新	restaurant.updated	餐廳已修改。
餐廳已刪除	restaurant.deleted	餐廳已移除。

水療中心

事件	Key	說明
水療中心已建立	spa.created	新水療中心已新增。
水療中心已更新	spa.updated	水療中心已修改。
水療中心已刪除	spa.deleted	水療中心已移除。

活動

事件	Key	說明
活動已建立	activity.created	新活動已新增。
活動已更新	activity.updated	活動已修改。
活動已刪除	activity.deleted	活動已移除。

---

銷售渠道事件

連結供應商與加盟商的分銷渠道事件。發送給供應商與加盟商的 webhook 訂閱者。

事件	Key	說明
銷售渠道已建立	sales_channel.created	新銷售渠道已建立。
銷售渠道已更新	sales_channel.updated	銷售渠道已修改。
銷售渠道已刪除	sales_channel.deleted	銷售渠道已移除。

---

特殊價格事件

物業促銷與議價價格事件。

事件	Key	說明
特殊價格已建立	special_rate.created	新特殊價格已建立。
特殊價格已更新	special_rate.updated	特殊價格已修改。
特殊價格已刪除	special_rate.deleted	特殊價格已移除。
價格修正已更新	rate_modifier.updated	價格修正已更新。

---

付款對象事件

與付款對象（收款人）管理相關的事件。

事件	Key	說明
付款對象已建立	payee.create	新付款對象已成功建立。
付款對象建立失敗	payee.create.failure	付款對象建立失敗。
付款對象已更新	payee.update	付款對象已更新。
付款對象更新失敗	payee.update.failure	付款對象更新失敗。

---

付款事件

TripPay 內部付款處理事件。

事件	Key	說明
付款成功	internal.payment.succeeded	付款已成功處理。
付款處理中	internal.payment.processing	付款正在處理中。
付款失敗	internal.payment.failed	付款處理失敗。

---

渠道管理事件

與渠道管理器價格與可用性推送相關的事件。

事件	Key	說明
價格更新	channel-manager.update.rate	渠道管理器已推送價格更新。
可用性更新	channel-manager.update.availability	渠道管理器已推送可用性更新。
一般更新	channel-manager.update	一般渠道管理器更新。

---

帳本事件

與財務帳本條目相關的事件。

事件	Key	說明
帳本條目已建立	ledger.entry.create	新帳本條目已記錄。

---

電子郵件事件

事件	Key	說明
電子郵件往來	email.correspondence	已發送外寄電子郵件。

---

事件數量摘要

類別	數量
管理實體事件	33
訂單事件	16
物業事件	13
庫存事件（房型、價格方案、主價格、附加項目、設施）	24
銷售渠道事件	3
特殊價格事件	4
付款對象事件	4
付款事件	3
渠道管理事件	3
帳本事件	1
電子郵件事件	1
總計	105

提示

開發期間建議先訂閱所有事件。當您了解系統所需的有效負載後，再縮小訂閱範圍以減少雜訊。

延伸閱讀

• Webhook 整合指南 — 設定步驟與最佳實踐。
• Webhooks — 管理您的 webhook 訂閱。
• Applications — 管理 API 憑證。
• Build on Wink — 開發者平台概覽。