แคตตาล็อกเหตุการณ์ Webhook

หน้านี้แสดงรายการเหตุการณ์ webhook ทุกประเภทที่คุณสามารถสมัครรับบน Wink สำหรับคำแนะนำการตั้งค่า ดูที่ คู่มือการรวม Webhook หรือ หน้าการจัดการ Webhooks

วิธีการสมัครรับ

1. ไปที่ Applications > Webhooks ในพอร์ทัลของคุณ
2. สร้าง webhook และเลือกเหตุการณ์ที่คุณต้องการรับ — หรือปล่อยให้รายการว่างเพื่อรับทุกเหตุการณ์
3. Wink จะส่ง HTTP POST ที่ลงลายมือชื่อไปยัง endpoint ของคุณทุกครั้งที่เกิดเหตุการณ์ ดูที่ Webhook Integration สำหรับข้อมูลเกี่ยวกับซองจดหมาย, headers, การตรวจสอบลายเซ็น และการลองใหม่

ทุกประเภทเหตุการณ์

ตารางนี้ถูกสร้างจากแคตตาล็อกเหตุการณ์ของแพลตฟอร์มในเวลาสร้าง จึงตรงกับ API เสมอ ประเภทเหตุการณ์ที่ระบุว่าได้ส่งจะลิงก์ไปยังหน้าข้อมูลอ้างอิงใน Webhooks API ซึ่ง บันทึกข้อมูล JSON body ที่แน่นอน (WebhookEnvelope พร้อม object เฉพาะเหตุการณ์), headers Wink-* และ นโยบายการลองใหม่ ประเภทเหตุการณ์ที่ไม่ได้ส่งมีอยู่ภายใน (การชำระเงิน, ledger, การซิงค์ channel-manager, …) แต่ไม่ได้ส่งไปยังผู้สมัครรับ webhook ในปัจจุบัน

ผู้รับ หมายถึงผู้ที่ได้รับเหตุการณ์: SUPPLIER (โรงแรม), AFFILIATE (ผู้ขายต่อที่มีช่องทางขายที่ใช้งานกับโรงแรม), AGENT (ตัวแทนท่องเที่ยวที่ทำการจอง) หรือ SELF (หน่วยงานที่จัดการซึ่งเหตุการณ์เกี่ยวข้อง) ผู้รับแต่ละรายจะได้รับ payload รูปแบบเดียวกัน; รายละเอียดเฉพาะบทบาทจะอยู่เบื้องหลัง URL links.self ของ payload

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

เคล็ดลับ

เริ่มต้นด้วยการสมัครรับทุกเหตุการณ์ในช่วงพัฒนา เมื่อคุณเข้าใจว่า payload ใดที่ระบบของคุณต้องการ ให้จำกัดการสมัครรับเพื่อลดเสียงรบกวน ส่งเหตุการณ์ทดสอบให้ตัวเองจาก Applications > Webhooks (หรือ POST …/webhook/{id}/test) เพื่อยืนยัน endpoint และการตรวจสอบลายเซ็นก่อนใช้งานจริง

การอ่านเพิ่มเติม

• คู่มือการรวม Webhook — ขั้นตอนการตั้งค่าและแนวทางปฏิบัติที่ดีที่สุด
• Webhooks — จัดการการสมัครรับ webhook ของคุณ
• Applications — จัดการข้อมูลรับรอง API
• Build on Wink — ภาพรวมแพลตฟอร์มสำหรับนักพัฒนา