การแก้ปัญหา Smart Lock
เริ่มด้วย Refresh Locks จากนั้นเรียกใช้ Test PIN Generation สำหรับหนึ่งห้อง โดยปกติใช้เวลาประมาณ 2 นาที
คู่มือนี้ช่วยแก้ปัญหาทั่วไปของ smart lock สำหรับ Igloohome, TTLock และ Wishome
AVA จะผูก PIN แต่ละรายการกับห้อง PMS ในการจอง สำหรับการตั้งค่า PMS ที่ไม่ใช่ Opera AVA จะใช้ confirmation number ของห้องนั้นเองสำหรับการเข้าถึง smart-lock สำหรับการจองหลายห้องด้วย Opera OHIP AVA จะใช้หมายเลขห้องของ sub-reservation แต่ละรายการเมื่อสร้างการเข้าถึง smart-lock หากผู้เข้าพักเปลี่ยนห้อง ให้รอการซิงก์แล้วสร้าง PIN ใหม่ สำหรับการจองหลายห้อง แต่ละห้องจะใช้ sub-reservation หรือ room-level ID ของตัวเอง การทำเช่นนี้ทำให้การสร้าง PIN แบบกลุ่มผูกกับห้องที่ถูกต้อง เมื่อเปิด lookup อีกครั้ง AVA ยังสามารถกู้คืนห้องที่เกี่ยวข้องใน booking family เดียวกันได้ การจองแบบ day-use และแบบค้างคืนที่อยู่รวมกันจะใช้ช่วงเวลาของห้องแยกกัน AVA จะไม่คัดลอกช่วงเวลาหมดอายุของห้องหนึ่งไปใช้กับอีกห้องหนึ่งอีกต่อไป สำหรับ Mews AVA จะอ่านวันที่เข้าพักตาม timezone ของที่พักก่อนสร้างช่วงเวลาของ PIN
AVA จะถือว่าค่าการจองที่มีเฉพาะวันที่เป็นวันที่ตามปฏิทินใน timezone ที่โรงแรมกำหนดไว้ ตัวอย่างเช่น วันที่เช็กเอาต์ของสิงคโปร์คือวันที่ 3 สิงหาคม ช่วงเวลาจะสิ้นสุดในวันที่ 3 สิงหาคม ค่าที่มีวันที่และเวลาแบบเต็มจะถูกแปลงเป็น timezone ของโรงแรมก่อนที่ AVA จะสร้างช่วงเวลาของ PIN AVA จะใช้ช่วงเวลาเดียวกันนี้กับ PIN ที่สร้างขึ้น, PIN แบบกำหนดเอง และ PIN แบบกำหนดเองสุ่ม
ข้อมูลอ้างอิงด่วน
| สิ่งที่เห็น | สาเหตุ | วิธีดำเนินการ |
|---|---|---|
| "Failed to generate lock code" | ปัญหาการเชื่อมต่อ vendor หรือ lock ออฟไลน์ | ตรวจสอบสถานะ vendor + lock |
| PIN ที่ล้มเหลวเริ่มใช้งานได้หลังรีเฟรช | AVA ลองสร้างใหม่เมื่อดึงข้อมูลการจองครั้งถัดไป รวมถึงห้องที่เกี่ยวข้องใน booking family เดียวกัน | รีเฟรชการจอง |
| ห้อง day-use ได้ช่วงเวลาหมดอายุไม่ถูกต้อง | วันที่ในการจองไม่ตรงกันหรือ timezone ไม่ตรงกัน | ตรวจสอบวันที่เฉพาะห้อง |
| PIN หมดอายุในวันที่ตามปฏิทินไม่ถูกต้อง | timezone ของโรงแรมหรือช่วงเวลาของ PIN เก่า | ตรวจสอบวันที่หมดอายุของ PIN |
| PIN แบบกำหนดเองมีความยาวต่างจากที่คาดไว้ | ขีดจำกัดที่ vendor รองรับแตกต่างกัน | ตรวจสอบขีดจำกัด PIN ของ vendor |
| Manage PIN ถูกปิดใช้งาน | ยังไม่ได้จัดสรรห้อง, ข้อมูลห้องยังไม่ซิงก์ หรือห้องยังไม่ได้แมปกับ lock | เปิด Room Access แล้วรีเฟรช |
| สร้าง PIN แล้วแต่ใช้กับ lock ไม่ได้ | PIN ยังไม่ซิงก์ไปยัง lock หรือ bridge ออฟไลน์ | ตรวจสอบ PIN ในแอป vendor |
| สถานะการดำเนินการยังเป็น pending หรือแสดง partial | งานของ vendor bridge ยังอยู่ระหว่างประมวลผล | รอแล้วรีเฟรช |
| "PIN generation failed for all locks" (Smart Lock Setup) | vendor ขัดข้องหรือไม่สามารถเข้าถึง lock ได้ทั้งหมด | ทดสอบอีกครั้งหลังรีเฟรช |
| ไม่มี lock ปรากฏใน Smart Lock Setup | ยังไม่ได้เชื่อม vendor หรือยังไม่มีการซิงก์ lock | รีเฟรชหรือเชื่อมต่อใหม่ |
| "Operation not supported" หรือการดำเนินการถูกปิดใช้งาน | รุ่น lock หรือ vendor ไม่รองรับการดำเนินการนั้น | ตรวจสอบความสามารถ |
| ผู้เข้าพักได้รับ door code ไม่ถูกต้อง | แมป lock กับห้องผิด หรือการจองชี้ไปยังห้อง PMS ผิด | ตรวจสอบการแมปห้องและห้องในการจอง |
| Igloohome แสดง Not linked หลัง OAuth สำเร็จ | callback กลับมาแล้วแต่สถานะยังไม่รีเฟรช | รีเฟรชสถานะ Igloohome |
Manage PIN ถูกปิดใช้งาน
สิ่งที่เห็น: ปุ่ม Manage PIN เป็นสีเทา หรือไม่สามารถสร้าง PIN ให้ผู้เข้าพักได้
วิธีแก้:
-
ยืนยันว่าการจองมีการจัดสรรห้องแล้ว
-
หากช่องห้องว่าง ให้จัดสรรห้องใน PMS
-
รอ 1-2 นาทีให้การซิงก์เสร็จ แล้วรีเฟรช AVA
-
ไปที่ Settings → Room Access และยืนยันว่าห้องถูกแมปกับ lock ใน Smart Lock Setup
-
หาก tooltip มีลิงก์ ให้เปิดลิงก์นั้นเพื่อไปยัง Settings → Room Access โดยตรง
✓ หลังจัดสรรและแมปห้องแล้ว Manage PIN ควรพร้อมใช้งาน
การสร้างรหัสล้มเหลว
สิ่งที่เห็น: พบข้อความ "Failed to generate lock code" ระหว่างเช็กอิน หรือ PIN ใช้งานไม่ได้
หาก Access Details แสดง errorCode, retriable หรือ vendor ให้ใช้ข้อมูลนั้นประกอบด้วย
วิธีแก้:
-
รีเฟรชการจองหรือเปิดใหม่จาก reservation lookup หากผู้เข้าพักเช็กอินแล้ว
- หากเป็นการจองหลายห้อง ให้เปิด parent confirmation ด้วย
-
ตรวจสอบว่า lock มีแบตเตอรี่และตอบสนองในแอป vendor
-
ใน AVA คลิก Refresh Locks
-
หากยังมีปัญหา ให้เชื่อมต่อ vendor ใหม่ใน Room Access
-
หากผู้เข้าพักกำลังรอ ให้สร้างรหัสด้วยตนเองจากแอป vendor หรือใช้กุญแจจริง
✓ AVA จะลองสร้าง PIN ของ smart-lock ใหม่เมื่อดึงข้อมูลการจองครั้งถัดไปสำหรับ stay ที่มีสิทธิ์
ช่วงเวลาการเข้าถึงของ day-use ไม่ถูกต้อง
สิ่งที่เห็น: การจองแบบผสมทำให้ห้องหนึ่งมีเวลาหมดอายุไม่ถูกต้อง หรือห้อง day-use ใช้ช่วงเวลาเดียวกับห้องค้างคืน
วิธีแก้:
-
รีเฟรชการจองใน AVA
-
ยืนยันว่าแต่ละห้องมีหมายเลขห้องและวันที่เข้าพักถูกต้องใน PMS
-
หากใช้ Mews ให้ตรวจสอบ timezone ของที่พักใน Settings → Essentials → Hotel Basic Details
-
สร้าง PIN ใหม่หากยังแสดงช่วงเวลาไม่ถูกต้อง
✓ แต่ละห้องควรแสดงช่วงเวลาหมดอายุของตัวเอง
วันที่หมดอายุของ PIN ไม่ถูกต้อง
สิ่งที่เห็น: PIN หมดอายุในวันตามปฏิทินถัดจากวันที่เช็กเอาต์ในการจอง
วิธีแก้:
-
ไปที่ Settings → Essentials → Hotel Basic Details
-
ยืนยันว่า Timezone ของโรงแรมตรงกับ timezone ท้องถิ่นของที่พัก
-
ยืนยันวันที่เช็กเอาต์ของการจองใน PMS
-
สร้าง PIN ใหม่จากการจองหลังแก้ไข timezone หรือการจองแล้ว
-
เพิกถอน PIN เก่าหากยังมีช่วงเวลาการใช้งานไม่ถูกต้อง
✓ PIN ใหม่จะหมดอายุในวันที่เช็กเอาต์ตาม timezone ของโรงแรม
การเปลี่ยนลักษณะการทำงานนี้จะไม่อัปเดต PIN ที่ vendor สร้างไว้แล้ว ให้เพิกถอนหรือสร้าง PIN เหล่านั้นใหม่แยกต่างหาก
ความยาว PIN แบบกำหนดเองไม่ถูกต้อง
สิ่งที่เห็น: PIN แบบกำหนดเองที่สร้างขึ้นมีความยาวต่างจากการตั้งค่าที่บันทึกไว้
วิธีแก้:
-
ตรวจสอบช่วงที่ vendor รองรับ:
- Igloohome: 4–6 หลัก
- TTLock: 4–9 หลัก
- Wishome: 6–10 หลัก
-
หากความยาวที่เลือกอยู่นอกช่วงดังกล่าว AVA จะปรับ PIN ที่สร้างขึ้นโดยอัตโนมัติ
-
สร้าง PIN ใหม่จากการจอง
✓ PIN แบบกำหนดเองใหม่จะใช้ความยาวที่ vendor รองรับ
สถานะการดำเนินการค้างเป็น pending หรือ partial
สิ่งที่เห็น: รหัส smart-lock แสดง pending หรือ partial หลังสร้าง
วิธีแก้:
- รอไม่เกิน 1 นาที แล้วรีเฟรชการจองหรือหน้า Access Codes
- AVA จะตรวจงาน smart-lock ใหม่ก่อนรายการค้างเก่า ดังนั้น PIN ของผู้เข้าพักล่าสุดควรเสร็จก่อน
- ระหว่างการรีเฟรช lookup เช็กอิน AVA จะตรวจงานที่ค้างอีกครั้งก่อนส่งคืนรหัส
- AVA จะข้ามแถว Active ในประวัติที่หมดอายุ แม้ยังมี bridge fields เก่าอยู่
- AVA จะตรวจงานของ vendor ต่อในเบื้องหลัง ดังนั้น stay ปัจจุบันอาจเปลี่ยนเป็น Successful ได้โดยไม่ต้องดำเนินการเพิ่มเติม
- ระหว่างรอเช็กอิน AVA จะรีเฟรชงาน smart-lock ที่ค้างด้วย ซึ่งอาจทำให้ PIN ที่พร้อมใช้งานปรากฏเร็วขึ้น
- หากเห็น partial ให้รอจนสถานะเสร็จสมบูรณ์ก่อนแชร์ PIN
- หากสถานะยังเป็น pending นานกว่า 1 นาทีใน stay ปัจจุบัน ให้ลองสร้าง PIN จากการจองใหม่
- หากสถานะเปลี่ยนเป็น Timed out หรือ Failed ให้ตรวจสอบ vendor bridge และเชื่อมต่อ vendor ใหม่หากจำเป็น
PIN ที่สร้างแล้วใช้กับ lock ไม่ได้
สิ่งที่เห็น: AVA สร้างรหัส PIN สำเร็จ แต่ผู้เข้าพักใช้ PIN ปลดล็อกประตูไม่ได้
วิธีแก้:
-
ตรวจสอบว่า PIN ตรงกันในแอป vendor:
- เปิดแอป smart lock ของ vendor (Igloohome, TTLock หรือ Wishome)
- ตรวจสอบว่า PIN ที่แสดงในแอป vendor ตรงกับ PIN ที่ AVA สร้าง
- ค้นหาการจองหรือช่วงเวลาที่ตรงกัน
-
หาก PIN ไม่ตรงกันหรือไม่แสดงในแอป vendor:
- สำหรับ lock ที่ไม่มี bridge: ปิดแล้วเปิด lock ใหม่โดยถอดและใส่แบตเตอรี่กลับเข้าไป
- สำหรับ lock ที่มี bridge/gateway:
- รีสตาร์ท bridge โดยถอดปลั๊ก 30 วินาที แล้วเสียบกลับ
- รอ 2-3 นาทีให้ bridge เชื่อมต่อใหม่
- ตรวจสอบว่า bridge แสดงสถานะออนไลน์ในแอป vendor
- หลังรีเซ็ต ให้คลิก Refresh Locks ใน AVA
- ลองสร้าง PIN ใหม่
-
หากยังมีปัญหา:
- ตรวจระดับแบตเตอรี่ของ lock ในแอป vendor (แบตเตอรี่ต่ำอาจทำให้เกิดปัญหาการซิงก์)
- ตรวจสอบว่า lock เชื่อมต่อกับ bridge ได้อย่างเสถียร (หากมี)
- ตรวจสอบว่า firmware ของ lock เป็นเวอร์ชันล่าสุดในแอป vendor
การทดสอบ PIN ล้มเหลวใน Smart Lock Setup
สิ่งที่เห็น: พบข้อความ "PIN generation failed for all locks." ใน Smart Lock Setup
วิธีแก้:
- คลิก Refresh Locks
- ทดสอบห้องเดียวอีกครั้งด้วย Test PIN Generation
- หากการทดสอบทั้งหมดล้มเหลว ให้เชื่อมต่อ vendor ใหม่ใน Room Access
ไม่มี lock ปรากฏใน Smart Lock Setup
สิ่งที่เห็น: Available Devices ว่างเปล่า
วิธีแก้:
- ยืนยันว่าบัญชี vendor เชื่อมต่อแล้ว
- คลิก Refresh Locks
- ตรวจสอบว่า lock ปรากฏในแอป vendor และตรงกับ vendor ที่เลือก
ผู้เข้าพักได้รับ door code ไม่ถูกต้อง
สิ่งที่เห็น: ผู้เข้าพักได้รับรหัสสำหรับห้องผิดหลังเปลี่ยนห้องหรือจากการจองหลายห้อง
วิธีแก้:
-
ไปที่ Settings → Room Access
-
เลื่อนไปที่ Smart Lock Setup
-
ยืนยันว่าการจองแสดง PMS room ที่ถูกต้อง
-
หากเป็นการจอง Opera OHIP ให้ยืนยันว่าแต่ละห้องมีหมายเลขห้องของ sub-reservation ของตัวเอง
-
หากเป็นการจองหลายห้อง ให้ยืนยันว่าแต่ละห้องมี sub-reservation ID ของตัวเอง
-
หากเป็นการจองที่ไม่ใช่ Opera ให้ยืนยันว่าแต่ละห้องมี confirmation number เฉพาะห้องของตัวเอง
-
เลือกห้องแล้วนำ lock ที่ไม่ถูกต้องออก หากจำเป็น
-
จัดสรร lock ที่ถูกต้อง
-
รอการซิงก์ จากนั้นเรียกใช้ Refresh Locks และ Test PIN Generation อีกครั้ง
✓ lock ที่ถูกต้องจะปรากฏใน Assigned Devices
ไม่รองรับการดำเนินการ
สิ่งที่เห็น: AVA แจ้งว่า lock หรือ vendor ไม่รองรับการดำเนินการที่ลองใช้
สาเหตุ: รุ่น lock นั้นไม่รองรับฟีเจอร์ดังกล่าว หรือ vendor บล็อกการดำเนินการนั้น
วิธีแก้:
-
ไปที่ Settings → Room Access
-
คลิก Refresh Locks
-
ตรวจสอบป้ายความสามารถใน Smart Lock Setup
-
ใช้ lock รุ่นอื่นหรือ vendor อื่น หากการดำเนินการยังคงถูกปิดใช้งาน
✓ AVA จะแสดงเฉพาะการดำเนินการที่ lock ที่เชื่อมต่อสามารถดำเนินการได้
ปัญหาเฉพาะของ Igloohome
Igloohome แสดง Not linked หลัง OAuth สำเร็จ
สิ่งที่เห็น: ดำเนินการ OAuth เสร็จแล้ว แต่ Igloohome Locks ยังคงแสดง Not linked
วิธีแก้:
- อยู่ที่ Settings → Room Access ต่อหลัง OAuth กลับมา
- รอสักครู่เพื่อให้สถานะรีเฟรช
- รีเฟรชหน้าเว็บหนึ่งครั้งหากสถานะไม่เปลี่ยน
- เชื่อมโยงบัญชีใหม่หากยังแสดง Not linked
การเชื่อมต่อ OAuth หมดอายุ
สิ่งที่เห็น: การผสานการทำงานแสดงสถานะ disconnected
วิธีแก้:
- คลิก Disconnect ใน Igloohome Locks
- คลิก Link Account
- ดำเนินการอนุญาต OAuth ให้เสร็จ
ไม่พบ lock
วิธีแก้:
- ยืนยันว่า lock ถูกจัดสรรให้ property ใน Igloohome แล้ว
- กลับไปที่ AVA แล้วคลิก Refresh Locks
ปัญหาเฉพาะของ TTLock
เข้าสู่ระบบไม่สำเร็จ
สิ่งที่เห็น: "Failed to connect TTLock account."
วิธีแก้:
- ยืนยัน username และ password (ตัวพิมพ์เล็กใหญ่มีผล)
- ตรวจสอบว่าบัญชียัง active ในแอป TTLock
- ลองอีกครั้งหลังผ่านไป 30 วินาที
Lock ไม่ซิงก์
วิธีแก้:
- เปิดแอป TTLock บนมือถือ
- ซิงก์ lock แต่ละตัวโดยยืนอยู่ใกล้ lock นั้น
- กลับไปที่ AVA แล้วคลิก Refresh Locks
ปัญหาเฉพาะของ Wishome
ข้อมูลรับรองไม่ครบหรือ token หมดอายุ
สิ่งที่เห็น: พบข้อความ "Wishome credentials incomplete" หรือคำเตือนว่า token หมดอายุ
วิธีแก้:
- ป้อน Wishome Account Name และ Wishome Password อีกครั้ง
- ยืนยันว่า Offline Password Version ตรงกับการตั้งค่า Wishome ของคุณ
- คลิก Connect Wishome Account
ยังติดอยู่ใช่ไหม?
ติดต่อ success@vouch-technologies.com หาก:
- ❌ lock ทั้งหมดแสดงออฟไลน์แม้การเชื่อมต่อจะดี
- ❌ ข้อมูลรับรองของ vendor ถูกต้องแต่การเชื่อมต่อล้มเหลว
- ❌ PIN ใช้งานไม่ได้หลังลองซ้ำหลายครั้ง
ข้อมูลที่ควรแนบ:
- vendor ของ lock (Igloohome, TTLock หรือ Wishome)
- จำนวน lock ที่ได้รับผลกระทบ
- ภาพหน้าจอข้อความแสดงข้อผิดพลาด