ตั้งค่า Mews PMS Integration
โรงแรมส่วนใหญ่ต้องใช้เพียง Access Token เท่านั้น ใช้เวลาประมาณ 10 นาที
คู่มือนี้ช่วยให้คุณเชื่อมต่อ AVA กับ Mews เพื่อให้ reservation และรายละเอียดผู้เข้าพักซิงก์อย่างถูกต้อง
ตำแหน่งที่หาได้
Settings → Essentials → Property Management System (PMS) Integrationข้อมูลอ้างอิงแบบย่อ
| การตั้งค่า | ควบคุมอะไร | ใช้เมื่อใด |
|---|---|---|
| Access Token | เชื่อมต่อ AVA กับ Mews | ใช้ตลอด |
| Advanced → Client Token | ข้อมูลรับรองการเชื่อมต่อขั้นสูง | ใช้เฉพาะเมื่อซัพพอร์ตขอ |
| Advanced → Client ID | ตัวระบุที่พักของคุณใน Mews | ใช้เฉพาะเมื่อซัพพอร์ตขอ |
| Advanced → Demo Mode | ใช้ sandbox endpoints สำหรับทดสอบ | ใช้เฉพาะสภาพแวดล้อมทดสอบ |
| Reservation comments | ดึง service order notes ของ Mews เข้า AVA | เมื่อ AVA อ่าน reservation |
| Room payment waiver | ใช้ invoice ที่ส่งกลับมาเพื่อตัดสินการยกเว้น | เมื่อ invoice ระบุว่า room payment ถูก waive |
| Payment waiver keywords | แสดงฟิลด์คีย์เวิร์ดยกเว้นในตั้งค่าการชำระเงินของ AVA | เฉพาะเมื่อการเชื่อมต่อ Mews รองรับ keyword-waiver |
ก่อนเริ่มต้น
คุณต้องมี:
- เข้าถึงส่วน admin ของ Mews
- Access Token / Token ID สำหรับการเชื่อมต่อ AVA
- สิทธิ์ admin เพื่ออัปเดตการตั้งค่า PMS ใน AVA
หากคุณไม่มี Access Token ให้ติดต่อผู้ดูแล Mews หรือฝ่ายซัพพอร์ตของ AVA
วิธีขอ Mews Access Token
ทำตามขั้นตอนเหล่านี้ใน Mews:
-
เข้าสู่ระบบ Mews PMS
-
คลิก Marketplace ในแถบด้านข้าง

-
คลิก My Subscriptions

-
หา Vouch AVA Front Desk Agent
-
คลิก Edit
-
เปิดส่วน Access Token
-
คัดลอก Token ID

วาง token ลงใน AVA ทันทีเพื่อไม่ให้หาย
ขั้นตอนการตั้งค่า
ขั้นตอนที่ 1: เลือก Mews
- ไปที่ Settings → Essentials → PMS Integration
- คลิกการ์ด Mews
- ฟอร์มตั้งค่า Mews จะปรากฏขึ้น
ขั้นตอนที่ 2: กรอก Access Token
- วาง Token ID จาก Mews ลงในฟิลด์ Access Token
- token จะถูกซ่อนหลังบันทึกเพื่อความปลอดภัย
หากคุณกลับมาอีกครั้งแล้วเห็นอักขระที่ถูกปกปิด ให้ปล่อยไว้ตามเดิมแล้วคลิก Save AVA จะเก็บ Access Token, Client Token และ Client ID ที่บันทึกไว้
ถ้าคุณต้องใช้การตั้งค่า Mews แบบ Advanced (เฉพาะซัพพอร์ต)
- คลิก Advanced
- กรอกค่าที่ซัพพอร์ตให้มา:
- Client Token
- Client ID
- ไม่บังคับ: เปิด Demo Mode หากคุณกำลังทดสอบกับ sandbox endpoints
อย่าเปลี่ยนค่า Advanced เว้นแต่ซัพพอร์ตบอกให้ทำ ค่าที่ผิดอาจทำให้การซิงก์หยุด
ขั้นตอนที่ 3: บันทึก
- คลิก Save ที่ด้านล่างของหน้า
- มองหาข้อความสำเร็จ
- ฟิลด์ Access Token จะแสดง placeholder เพื่อปกป้องความลับ
หลังจากเชื่อมต่อแล้วจะเกิดอะไรขึ้น
- ✅ AVA จะเริ่มใช้ข้อมูล Mews สำหรับการจองและรายละเอียดผู้เข้าพัก
- ✅ ฟิลด์ Access Token จะแสดงอักขระที่ถูกปกปิด
- ✅ ใช้ Edit Token หากต้องการอัปเดต token ภายหลัง
- ℹ️ AVA จะคงค่า Demo Mode ปัจจุบันไว้เมื่อคุณบันทึกฟิลด์ Mews อื่น
- ℹ️ ระบบ production จะไม่บังคับให้ Demo Mode เป็น OFF
- ✅ ชื่อบริษัท Mews จะเติมป้ายชื่อแหล่งการจองเมื่อ AVA ระบุได้
- ✅ การจองของ Mews จะถูกถือว่าเป็น hotel collect ใน AVA
- ✅ สถานะล็อกห้อง Do Not Move จะซิงก์กับ Mews
- ✅ AVA จะข้ามห้อง Mews ที่ถูกบล็อกระหว่างการจัดห้องอัตโนมัติ และลองห้องสะอาดอื่นแทนเมื่อทำได้
- ✅ AVA จะดึงหมายเหตุ service order ของ Mews เข้าไปในหมายเหตุการจอง
- ✅ หมายเหตุที่ตรงกันสามารถยกเว้น room payment ได้เมื่อ invoice ส่งสัญญาณการยกเว้นกลับมา
- ✅ AVA จะโหลดรายละเอียด invoice แบบเต็มก่อนตรวจการยกเว้นในการอ่านการจองแบบเดี่ยว
- ✅ AVA จะยังแสดงห้อง Mews ที่ยังไม่ได้จัดสรรใน multi-room bookings
ผลต่อผู้เข้าพักและพนักงาน
- แบบฟอร์มผู้เข้าพักปรับตามกฎของ Mews ฟิลด์ที่ต้องกรอกและฟิลด์ที่ซ่อนจะเปลี่ยนตามการตั้งค่า Mews ดังนั้นผู้เข้าพักจะเห็นเฉพาะสิ่งที่จำเป็น
- การค้นหาการจองใช้ Mews หากไม่ได้ตั้งค่า Mews ขั้นตอนค้นหาผู้เข้าพักจะล้มเหลว
- ป้ายแหล่งที่มาของการจองสามารถแสดงชื่อบริษัท Mews ได้ หาก AVA ระบุชื่อบริษัทได้ ระบบจะใช้ชื่อนั้นแทน company ID ดิบ
- แหล่งที่มาของ Mews ตอนนี้เริ่มเป็น hotel collect ซึ่งทำให้ป้ายแหล่งที่มาสอดคล้องกับสัญญาการจองที่ AVA ได้รับ
- ห้องที่ล็อกไว้จะยังล็อกอยู่ใน AVA หาก Mews ทำเครื่องหมายว่าการจองถูกล็อก Streamliner จะแสดงไอคอนล็อกในมุมมองเปลี่ยนห้อง
- หมายเหตุ service order จะกลายเป็นหมายเหตุการจอง พนักงานสามารถตรวจข้อความหมายเหตุระหว่างค้นหาการจองได้
- room payment ที่ถูก waive ยังอธิบายได้ เมื่อ Mews ระบุว่า invoice ถูก waive AVA จะแสดงข้อความหมายเหตุเป็นเหตุผลของการยกเว้น
- payment waiver keywords ขึ้นกับความสามารถของระบบ หาก Mews ส่งข้อมูลนี้ออกมา AVA จะแสดงฟิลด์คำหลักการยกเว้นในตั้งค่าการชำระเงิน
อีเมลการจองร่วมสร้างผู้เข้าพักแยกกัน
หากผู้เข้าพักสองคนใช้อีเมลการจองเดียวกัน AVA จะสร้างลูกค้า Mews แยกกัน AVA จะนำลูกค้าเดิมกลับมาใช้ก็ต่อเมื่อหมายเลขเอกสารตรงกับระเบียนที่มีอยู่ หาก AVA มีการอ้างอิงผู้เข้าพักของ Mews แบบตรงอยู่แล้ว ระบบจะอัปเดตผู้เข้าพักคนนั้นต่อไป
AVA จะจับคีย์เวิร์ด waiver แบบทั้งคำ
PAID จะไม่ตรงกับ UNPAID
การแก้ไขปัญหา
ข้อผิดพลาด "Access Token is required"
สิ่งที่คุณเห็น: "Access Token is required"
วิธีแก้:
- วาง Token ID จาก Mews
- คลิก Save อีกครั้ง
- ✓ ข้อผิดพลาดจะหายไปเมื่อบันทึกสำเร็จ
บันทึก token แล้วแต่ไม่มีข้อมูลซิงก์
สิ่งที่คุณเห็น: บันทึก token แล้ว แต่ reservation ไม่ปรากฏ
วิธีแก้:
- รอ 10-15 นาทีสำหรับการซิงก์ครั้งแรก
- รีเฟรชหน้าและยืนยันว่าเลือก Mews อยู่
- ขอให้ผู้ดูแล Mews ยืนยันว่า subscription ของ AVA ยังใช้งานอยู่
- ติดต่อฝ่ายซัพพอร์ตของ AVA หากปัญหายังต่อเนื่อง
ฟิลด์ที่ถูกปกปิดกลับมาอีกหลังรีโหลด
สิ่งที่คุณเห็น: Access Token หรือฟิลด์ advanced แสดงอักขระที่ถูกปกปิดหลังรีโหลดหน้า
วิธีแก้:
- ปล่อยค่าที่ถูกปกปิดไว้ตามเดิม
- คลิก Save อีกครั้ง
- ✓ AVA จะเก็บข้อมูลรับรอง Mews ที่บันทึกไว้
หา Client Token, Client ID หรือ Demo Mode ไม่เจอ
สิ่งที่คุณเห็น: ไม่เห็นฟิลด์ Client Token, Client ID หรือ Demo Mode
วิธีแก้:
- คลิก Advanced
- ✓ ฟิลด์ advanced จะปรากฏในส่วน Advanced
เปิด Demo Mode อยู่ แต่การซิงก์ดูผิดปกติ
สิ่งที่คุณเห็น: reservation หายไปหรือมีข้อมูลทดสอบที่ไม่คาดคิด
วิธีแก้:
- ปิด Demo Mode
- คลิก Save
- รีเฟรชหน้าและตรวจสถานะการเชื่อมต่อ
- ติดต่อซัพพอร์ตหากปัญหายังต่อเนื่อง
Demo Mode ไม่ตรงหลังบันทึก
สิ่งที่คุณเห็น: ช่องทำเครื่องหมาย Demo Mode เปลี่ยนหลังรีเฟรช หรือไม่ตรงกับค่าที่บันทึกใน Mews
วิธีแก้:
- เปิด Advanced
- ตรวจค่า Demo Mode
- บันทึกเฉพาะการเปลี่ยนที่คุณต้องการ
- รีเฟรชหน้า
- ติดต่อซัพพอร์ตหากช่องทำเครื่องหมายยังไม่ตรงกับ config ที่บันทึกไว้
ห้องไม่แสดงใน room change
สิ่งที่คุณเห็น: ห้องหายไปจาก Allow move room
วิธีแก้:
- ตรวจ reservation ใน Mews
- เอาล็อกห้องออกถ้าห้องควรย้ายได้
- รีเฟรช reservation ใน AVA
- ลองเปลี่ยนห้องอีกครั้ง
ห้องถูกบล็อกใน Mews
สิ่งที่คุณเห็น: การเช็กอินหรือเปลี่ยนห้องแสดง "space is blocked" หรือ "room unavailable"
วิธีแก้:
- รอให้ AVA ลองห้อง clean อื่น
- กำหนดห้องอื่นใน Mews หากไม่มีห้อง clean ที่ใช้ได้
- รีเฟรช AVA แล้วลองอีกครั้ง
รายการตรวจสอบการยืนยัน
- เลือก Mews ใน Select PMS Provider
- กรอกและบันทึก Access Token โดยไม่มีข้อผิดพลาด
- ฟิลด์ Access Token แสดงอักขระที่ถูกปกปิดหลังรีเฟรช
- reservation เริ่มซิงก์จาก Mews
ยังติดปัญหาอยู่?
ติดต่อ success@vouch-technologies.com หาก:
- ❌ การซิงก์ไม่เริ่มหลัง 15 นาที
- ❌ คุณพบข้อผิดพลาดตอนบันทึกที่แก้ไม่ได้
- ❌ คุณต้องใช้การตั้งค่า Advanced แต่ไม่มีค่า
ข้อมูลที่ช่วยได้:
- ภาพหน้าจอของส่วน PMS Integration
- ผู้ให้บริการ PMS ของคุณ (Mews)
- ข้อความ error แบบตรงตัว ถ้ามี