ตั้งค่าการส่ง Outbound Webhook

ตั้งค่าแบบเร็ว

โรงแรมส่วนใหญ่ใช้เวลา 5 ถึง 10 นาที

คู่มือนี้ช่วยให้คุณส่งเหตุการณ์ JSON guest_verified หลังจาก guest verification และ PMS sync สำเร็จ

ไปที่: Settings → Outbound Webhook

ส่วนหัวลายเซ็น

ทุกการส่งจะมี X-Vouch-Signature ระบบรับปลายทางควรตรวจสอบส่วนหัวนี้ก่อนเชื่อถือ payload

ข้อมูลอ้างอิงแบบย่อ

การตั้งค่า	ควบคุมอะไร	สิ่งที่คุณเห็น
Enabled	เปิดหรือปิดการส่ง outbound webhook	สวิตช์จะค้างอยู่หลังบันทึก
Webhook URL	URL ปลายทางสำหรับการส่ง	AVA ยอมรับ URL ของ receiver
Headers	ส่วนหัว auth แบบคงที่สำหรับ receiver	ค่าความลับจะยังถูกปิดหลังบันทึก
Payload Fields	ฟิลด์ผู้เข้าพักที่ถูกส่ง	ใน delivery จะมีเฉพาะฟิลด์ที่เลือกไว้
Max attempts	จำนวนครั้งที่ลองซ้ำเมื่อส่งล้มเหลว	ค่าจะอยู่ระหว่าง 1 ถึง 10
HMAC signing secret	ใช้เซ็น payload ในแต่ละครั้ง	หากเปิดใช้หรือทดสอบ จะบันทึกไม่ได้ถ้าไม่มี secret
Send Test	ส่ง delivery ทดสอบหนึ่งครั้ง	เทสล่าสุดจะปรากฏใน Delivery Logs
Delivery Logs	สถานะการส่งล่าสุดและ payload	เห็น 10 ระเบียนต่อหน้า พร้อมสถานะ จำนวนครั้ง HTTP status response body รายละเอียด payload และการเปลี่ยนหน้า

ก่อนเริ่มต้น

ยืนยันพื้นฐานเหล่านี้:

• คุณมีสิทธิ์ settings:write
• คุณทราบ URL ของ receiver
• คุณทราบส่วนหัว auth แบบคงที่
• คุณมี HMAC signing secret
• คุณทราบว่าฝั่งรับต้องการฟิลด์ผู้เข้าพักใดบ้าง

secret ที่บันทึกแล้วจะถูกปิดไว้

ค่าของ header และ signing secret ที่บันทึกแล้วจะยังถูกซ่อนไว้ คลิกไอคอนดินสอเมื่อคุณต้องการแทนที่ค่าเหล่านี้

ตอนที่ระบบส่ง

AVA จะส่ง webhook หลัง guest verification สำเร็จ ชื่อเหตุการณ์คือ guest_verified AVA จะไม่ส่ง webhook ถ้า PMS sync ล้มเหลว

คำขอใช้ JSON POST AVA จะใส่ส่วนหัวคงที่ของคุณในทุกการส่ง

ตั้งค่า Webhook

เปิดใช้งาน

1. ไปที่ Settings → Outbound Webhook

2. เปิด Enabled

3. กรอก Webhook URL

4. คลิก Save

   ✓ AVA จะเก็บ endpoint นี้ไว้สำหรับการส่งครั้งต่อไป

เพิ่มส่วนหัวแบบกำหนดเอง

ใช้ headers เมื่อ receiver ต้องการการยืนยันตัวตนแบบคงที่ AVA จะส่งไปใน JSON POST ทุกครั้ง ตัวอย่างเช่น คุณส่ง Authorization: token api_key:api_secret ได้

1. คลิก Add

2. กรอกชื่อ header

3. กรอกค่าของ header

4. เปิด Secret สำหรับค่าที่เป็นความลับ

5. คลิก Save

   ✓ Secret headers จะยังถูกปิดไว้หลังบันทึก

เลือกฟิลด์ payload

เลือกฟิลด์ที่ receiver ต้องการจากการ์ด Payload Fields ตัวเลือกที่พบบ่อย ได้แก่ หมายเลขยืนยัน วันที่ รายละเอียดติดต่อผู้เข้าพัก สัญชาติ หมายเลขเอกสาร และ marketing consent

1. เลือกฟิลด์ที่ต้องการส่ง

2. ยกเลิกฟิลด์ที่ receiver ไม่ต้องใช้

3. คลิก Save

   ✓ ใน delivery ถัดไปจะมีเฉพาะฟิลด์ที่เลือกไว้

ตั้งค่าจำนวนครั้งที่ลองซ้ำและ signing secret

ใช้การลองซ้ำเมื่อการส่งล้มเหลวชั่วคราว กำหนด signing secret เพื่อให้ receiver ตรวจ payload ได้

1. กรอกค่าใน Max attempts

2. ใช้ค่าระหว่าง 1 ถึง 10

3. กรอก HMAC signing secret

4. คลิก Save

   ✓ AVA จะลองซ้ำเมื่อเจอ 429, 5xx และ timeout ✓ ข้อผิดพลาดด้าน validation และ authentication จะค้างอยู่ใน log โดยไม่ลองซ้ำ

แทนที่ secret ที่บันทึกไว้

ใช้เมื่อมี secret ของ header หรือ signing secret อยู่แล้ว คุณไม่สามารถเปิดดูค่าเดิมได้

1. คลิกไอคอนดินสอข้าง secret ที่ถูกปิดไว้

2. กรอกค่าใหม่

3. คลิก Save

   ✓ ค่าที่บันทึกจะยังถูกปิดไว้หลัง save

ส่งการทดสอบ

ใช้ delivery ทดสอบหลังจากบันทึกการตั้งค่าแล้ว การทดสอบจะใช้ค่าที่บันทึกล่าสุด และจะใช้ HMAC signing secret ที่บันทึกไว้ด้วย

1. คลิก Send Test

2. รอข้อความสำเร็จ

3. เปิด Delivery Logs เพื่อยืนยันว่ามีแถวใหม่ปรากฏ

   ✓ แถวล่าสุดจะแสดง test delivery

ต้องบันทึกก่อน

ถ้าคุณเปลี่ยนอะไรบนหน้า ให้บันทึกก่อนส่งทดสอบ AVA จะปิดปุ่มทดสอบไว้จนกว่าการเปลี่ยนแปลงที่ยังไม่บันทึกจะถูกเคลียร์

ตรวจ Delivery Logs

Delivery logs ช่วยให้คุณตรวจสอบความพยายามส่งล่าสุด แต่ละหน้าจะแสดง 10 แถว แต่ละแถวจะแสดงสถานะการส่ง เวลา จำนวนครั้ง HTTP status และรายละเอียด คุณยังเปิดดู request payload และ response body ได้ ใช้ตัวควบคุมหน้าเพื่อเลื่อนไปยัง delivery ที่เก่าหรือใหม่กว่า

สถานะ	หมายความว่าอย่างไร
delivered	receiver ยอมรับการส่งแล้ว
processing	AVA ยังจัดการการส่งอยู่
retrying	AVA จะลองอีกครั้งภายหลัง
pending	AVA จัดคิวการส่งไว้แล้ว
failed	AVA หยุดลองซ้ำแล้ว

1. คลิก Refresh delivery logs เพื่อโหลดรายการปัจจุบันใหม่

2. ใช้ First page, Previous, Next, หรือ Last page เมื่อมีผลลัพธ์มากขึ้น

3. เปิดแถวเพื่อดูรายละเอียด response

4. ขยาย View request payload หากต้องการ JSON ที่ส่งไป

   ✓ ตัวนับหน้าจะแสดง Page X of Y เมื่อมีหลายหน้า ✓ ตัวควบคุมยังใช้ได้จนกว่าจะถึงหน้าแรกหรือหน้าสุดท้าย

รายละเอียดที่ถูกปกปิด

ค่าที่เป็นความลับจะยังถูกปกปิดในมุมมอง log ใช้รายละเอียด payload เฉพาะตอนแก้ปัญหา

การแก้ปัญหา

หน้าไม่โหลด

สิ่งที่เห็น: คุณเห็น Unable to load outbound webhook settings

วิธีแก้:

1. คลิก Retry
2. รีเฟรชหน้า
3. ยืนยันว่าคุณอยู่ใน property ที่ถูกต้อง
4. ลองอีกครั้งหลังเข้าสู่ระบบใหม่ถ้าจำเป็น

บันทึกล้มเหลวเมื่อเปิด webhook

สิ่งที่เห็น: บันทึกล้มเหลวหลังคุณเปิด Enabled

วิธีแก้:

1. กรอก HMAC signing secret
2. บันทึกอีกครั้ง
3. ถ้ามีอยู่แล้ว ให้แทนที่แทนการลบ

ปุ่ม Send Test ยังปิดอยู่

สิ่งที่เห็น: Send Test ถูกปิดใช้งานหลังคุณแก้หน้า

วิธีแก้:

1. คลิก Save ก่อน
2. รอข้อความสำเร็จ
3. ลอง Send Test อีกครั้ง
4. ยืนยันว่าคุณมีสิทธิ์แก้การตั้งค่า

URL ของ webhook ถูกปฏิเสธ

สิ่งที่เห็น: บันทึกหรือทดสอบล้มเหลวสำหรับบาง URL ปลายทาง

วิธีแก้:

1. ใช้ URL HTTPS ที่เข้าถึงได้จากภายนอก
2. เอา address แบบ private, reserved, loopback และ site-local ออก
3. ลองใหม่ด้วย receiver ที่เปิดสาธารณะ

Delivery logs ว่างเปล่า

สิ่งที่เห็น: Delivery Logs ยังไม่มีแถว

วิธีแก้:

1. คลิก Send Test
2. รอเหตุการณ์ guest verification
3. คลิก Refresh delivery logs
4. ตรวจอีกครั้งหลัง check-in ที่ตรงเงื่อนไขถัดไป
5. ใช้ Last page หากต้องการข้ามไปยัง delivery ที่เก่ากว่าอย่างรวดเร็ว

ยังติดอยู่?

ติดต่อ success@vouch-technologies.com หาก:

• ❌ หน้ายังไม่โหลดหลังลอง retry แล้ว
• ❌ บันทึกล้มเหลวหลังคุณเพิ่ม HMAC signing secret
• ❌ delivery ทดสอบไม่ปรากฏใน logs

แนบข้อมูลเหล่านี้:

• ภาพหน้าจอของข้อผิดพลาด
• โหมด identity management ของ Opera
• เวลาที่ปัญหาเริ่มเกิดขึ้น
• ขั้นตอนที่คุณลองไปแล้ว