การรวมระบบ Webhook

Webhook ช่วยให้ระบบของคุณได้รับการแจ้งเตือนแบบเรียลไทม์เมื่อเกิดเหตุการณ์ต่างๆ บนบัญชี Wink ของคุณ — การจองใหม่ การยกเลิก การอัปเดตการชำระเงิน และอื่นๆ คู่มือนี้จะแนะนำวิธีการตั้งค่าและแนวทางปฏิบัติที่ดีที่สุด

กลุ่มเป้าหมาย

คู่มือนี้สำหรับนักพัฒนาที่รวม Wink เข้ากับระบบภายนอก เช่น ระบบจัดการทรัพย์สิน (PMS), ตัวจัดการช่องทาง, CRM หรือแดชบอร์ดที่กำหนดเอง

วิธีการทำงานของ webhook

1. คุณลงทะเบียน URL webhook บน Wink
2. เมื่อเกิดเหตุการณ์ (เช่น การจองใหม่) Wink จะส่ง HTTP POST ไปยัง URL ของคุณ
3. เซิร์ฟเวอร์ของคุณประมวลผล payload และตอบกลับด้วย 200 OK

การตั้งค่า webhook

1. เข้าสู่ระบบบัญชีของคุณ (Extranet, Studio หรือ TripPay — ทั้งหมดรองรับ webhook)
2. ไปที่ Applications แล้วเลือก Webhooks ดูที่ Webhooks
3. คลิก Create webhook
4. กรอก ชื่อ (เช่น “PMS Booking Sync”)
5. กรอก URL webhook — จุดปลาย HTTPS บนเซิร์ฟเวอร์ของคุณ
6. เลือกเหตุการณ์ — เลือกเหตุการณ์เฉพาะที่ต้องการสมัครรับ หรือปล่อยว่างเพื่อรับทุกเหตุการณ์
7. สลับ Enabled เป็นเปิด
8. คลิก Save

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

Wink รองรับ ประเภทเหตุการณ์ webhook กว่า 64 ประเภท ในหมวดหมู่ต่างๆ รวมถึงการจัดการบัญชี สัญญาการจอง การชำระเงิน การอัปเดตตัวจัดการช่องทาง และการจัดการหน่วยงาน ตัวอย่างเหตุการณ์ทั่วไปได้แก่:

หมวดหมู่	ตัวอย่าง
การจอง	booking.create, booking.cancelled
สัญญาการจอง	booking.contract.created, booking.contract.processing, booking.contract.cancelled
การชำระเงิน	internal.payment.succeeded, internal.payment.failed
การคืนเงิน	booking.contract.refund.partial, booking.contract.refund.full
ตัวจัดการช่องทาง	channel-manager.update.rate, channel-manager.update.availability
บัญชี	account.create, account.status.updated

สำหรับรายการเหตุการณ์ทั้งหมดพร้อมคำอธิบาย ดูที่ Webhook Events Catalog

ดูเหตุการณ์ทั้งหมดกว่า 64 ประเภท

เคล็ดลับ

เริ่มต้นด้วยการสมัครรับทุกเหตุการณ์ในช่วงพัฒนา เมื่อคุณเข้าใจ payload แล้ว ให้จำกัดเฉพาะเหตุการณ์ที่ระบบของคุณต้องการเท่านั้น

แนวทางปฏิบัติที่ดีที่สุด

• ใช้ HTTPS — Wink ส่ง payload ไปยังจุดปลาย HTTPS เท่านั้น
• ตอบกลับอย่างรวดเร็ว — ส่งกลับ 200 OK ทันทีที่ได้รับ payload ทำการประมวลผลหนักๆ แบบอะซิงโครนัส
• ความสามารถในการทำซ้ำได้ (Idempotency) — ตัวจัดการของคุณควรทำงานแบบ idempotent Wink อาจส่งซ้ำหากไม่ได้รับการตอบกลับ 200
• ตรวจสอบแหล่งที่มา — ยืนยันว่า request ที่เข้ามามาจาก Wink ก่อนประมวลผล
• บันทึกข้อมูล — บันทึก payload webhook ทุกครั้งที่ได้รับ เพื่อช่วยแก้ไขปัญหาการรวมระบบได้ง่ายขึ้น

การหยุดชั่วคราวและการลบ

คุณสามารถ ปิดใช้งาน webhook โดยไม่ต้องลบ ซึ่งจะหยุดการส่งข้อมูลเพื่อให้คุณแก้ไขปัญหาโดยไม่สูญเสียการตั้งค่า เมื่อพร้อมแล้วให้เปิดใช้งานอีกครั้ง

การลบ webhook จะลบถาวร การรวมระบบที่พึ่งพา webhook นั้นจะหยุดรับการแจ้งเตือนทันที

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

• Webhook Events Catalog — รายการเหตุการณ์ทั้งหมดกว่า 64 ประเภท
• Webhooks — เอกสารอ้างอิงการจัดการ webhook แบบเต็ม
• Applications — จัดการข้อมูลรับรอง API ของคุณ
• Developers > APIs — เอกสาร API แบบเต็ม