การรวม Webhook

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

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

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

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

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

การตั้งค่า webhook

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

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

Wink รองรับเหตุการณ์หลากหลายประเภท เหตุการณ์ทั่วไปได้แก่:

การจองถูกสร้าง — การจองใหม่ได้รับการยืนยันแล้ว
การจองถูกยกเลิก — การจองถูกยกเลิก
การชำระเงินเสร็จสมบูรณ์ — การชำระเงินได้รับการดำเนินการแล้ว
การจองถูกอัปเดต — รายละเอียดการจองมีการเปลี่ยนแปลง

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

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

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

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

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

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

Webhooks — เอกสารอ้างอิงเต็มรูปแบบสำหรับการจัดการ webhook
Applications — จัดการข้อมูลรับรอง API ของคุณ
Developers > APIs — เอกสาร API ฉบับเต็ม