การแก้ปัญหา Smart Lock

Quick Fix

เริ่มด้วย Refresh Locks แล้วรัน Test PIN Generation สำหรับห้องเดียว ใช้เวลาประมาณ 2 นาที

คู่มือนี้ช่วยคุณแก้ปัญหา smart lock ที่พบบ่อยสำหรับ Igloohome, TTLock และ Wishome

Room-specific PINs

AVA ผูก PIN แต่ละอันกับห้องใน PMS ที่อยู่บน reservation สำหรับ PMS ที่ไม่ใช่ Opera AVA จะใช้ confirmation number ของห้องนั้นเองสำหรับการเข้าถึง smart-lock สำหรับ Opera OHIP แบบหลายห้อง AVA จะใช้หมายเลข sub-reservation ของแต่ละห้องตอนสร้าง smart-lock access หากผู้เข้าพักเปลี่ยนห้อง ให้รอ sync แล้วสร้าง PIN ใหม่ สำหรับ booking หลายห้อง แต่ละห้องจะใช้ sub-reservation หรือ room-level ID ของตัวเอง วิธีนี้ทำให้การสร้าง PIN แบบกลุ่มผูกกับห้องที่ถูกต้อง เมื่อเปิด lookup ใหม่ AVA ยังสามารถกู้ห้องที่เกี่ยวข้องใน booking family เดียวกันได้ ::

Igloohome updates faster

สำหรับ Igloohome AVA มักจะทำเครื่องหมาย PIN ที่เสร็จแล้วเป็น Successful ทันทีเมื่อ event เสร็จสิ้นมาถึง ถ้ายังเห็น pending ให้รีเฟรชหนึ่งครั้ง การ sweep ในพื้นหลังยังตรวจจับการอัปเดตที่ตกหล่นอยู่ ::

สรุปเร็ว

สิ่งที่เห็น	สาเหตุ	วิธีทำ
"Failed to generate lock code"	ปัญหาการเชื่อมต่อ vendor หรือล็อก offline	ตรวจสถานะ vendor + lock
PIN ที่ล้มเหลวกลับมาใช้ได้หลังรีเฟรช	AVA ลองสร้างใหม่ในการดึง reservation ครั้งถัดไป รวมทั้งห้องที่เกี่ยวข้องใน booking family เดียวกัน	รีเฟรช reservation
Manage PIN ถูกปิดใช้งาน	ห้องยังไม่ได้จัดสรร, ข้อมูลห้องยังไม่ซิงก์, หรือห้องไม่ถูกแมปกับ lock	เปิด Room Access แล้วรีเฟรช
สร้าง PIN แล้วใช้ไม่ได้กับ lock	PIN ยังไม่ซิงก์ไป lock หรือ bridge offline	ตรวจ PIN ในแอป vendor
สถานะงานค้าง pending หรือ partial	งาน vendor bridge ยังประมวลผลอยู่	รีเฟรชหนึ่งครั้งแล้วรอ
"PIN generation failed for all locks" (Smart Lock Setup)	vendor outage หรือเข้าถึงล็อกไม่ได้ทั้งหมด	ทดสอบใหม่หลังรีเฟรช
ไม่เห็น lock ใน Smart Lock Setup	ยังไม่เชื่อม vendor หรือยังไม่ซิงก์ lock	รีเฟรชหรือเชื่อมใหม่
"Operation not supported" หรือการทำงานถูกปิด	รุ่น lock หรือ vendor ไม่รองรับการทำงานนั้น	ตรวจความสามารถ
ผู้เข้าพักได้ door code ผิด	lock ถูกแมปกับห้องผิด หรือ reservation ชี้ไปห้อง PMS ผิด	ตรวจ room mapping และห้องใน reservation
Igloohome แสดง Not linked หลัง OAuth สำเร็จ	callback กลับมาแล้วแต่สถานะยังไม่รีเฟรช	รีเฟรชสถานะ Igloohome

Manage PIN ถูกปิดใช้งาน

สิ่งที่เห็น: ปุ่ม Manage PIN เป็นสีเทา หรือคุณไม่สามารถสร้าง PIN ให้ผู้เข้าพักได้

วิธีแก้:

1. ยืนยันว่าการจองมีการจัดสรรห้องแล้ว

2. หากห้องว่าง ให้จัดห้องใน PMS

3. รอ 1-2 นาทีให้ sync เสร็จ แล้วรีเฟรช AVA

4. ไปที่ Settings → Room Access และยืนยันว่าห้องถูกแมปกับ lock ใน Smart Lock Setup

5. หาก tooltip มีลิงก์ ให้เปิดเพื่อตรงไปที่ Settings → Room Access

   ✓ หลังห้องถูกจัดสรรและแมปแล้ว Manage PIN ควรพร้อมใช้งาน

Code generation failed

สิ่งที่เห็น: "Failed to generate lock code" ระหว่างเช็กอิน หรือ PIN ที่ใช้ไม่ได้

วิธีแก้:

1. รีเฟรช reservation หรือเปิดใหม่จาก lookup ถ้าผู้เข้าพักเช็กอินแล้ว

   • หากเป็น booking หลายห้อง ให้เปิด parent confirmation ด้วย

2. ตรวจว่า lock มีแบตเตอรี่และตอบสนองในแอป vendor

3. ใน AVA คลิก Refresh Locks

4. หากยังเป็นอยู่ ให้เชื่อม vendor ใหม่ใน Room Access

5. หากผู้เข้าพักรออยู่ ให้สร้างโค้ดด้วยมือจากแอป vendor หรือใช้กุญแจจริง

   ✓ AVA จะลองสร้าง smart-lock PIN ใหม่ในการดึง reservation ครั้งถัดไปสำหรับ stay ที่มีสิทธิ์

สถานะงานค้าง pending หรือ partial

สิ่งที่เห็น: smart-lock code แสดง pending หรือ partial หลังสร้าง

วิธีแก้:

1. รีเฟรช reservation หรือหน้า Access Codes หนึ่งครั้ง
2. หากเป็น Igloohome สถานะมักจะเปลี่ยนเป็น Successful ทันที
3. ถ้ายังเป็น pending หรือ partial ให้รอไม่เกิน 1 นาที
4. AVA จะตรวจงาน smart-lock ที่ใหม่กว่าก่อน backlog เก่า ดังนั้น PIN ผู้เข้าพักใหม่ควรเคลียร์ก่อน
5. ระหว่างรีเฟรช lookup เช็กอิน AVA จะตรวจงานที่ค้างก่อนส่ง code
6. AVA จะข้ามแถว Active ที่หมดอายุในประวัติ แม้ bridge field เก่าจะยังมีอยู่
7. AVA จะตรวจ vendor job ในพื้นหลังต่อเนื่อง ดังนั้น stay ปัจจุบันอาจกลายเป็น Successful โดยไม่ต้องทำอะไรเพิ่ม
8. ระหว่างรอเช็กอิน AVA จะรีเฟรชงาน smart-lock ที่ค้าง ซึ่งอาจทำให้เห็น PIN ที่พร้อมใช้เร็วขึ้น
9. หากเห็น partial ให้รอจนสถานะเสร็จก่อนแชร์ PIN
10. ถ้าสถานะยังเป็น pending เกิน 1 นาทีใน stay ปัจจุบัน ให้ลองสร้าง PIN ใหม่จาก reservation
11. หากเปลี่ยนเป็น Timed out หรือ Failed ให้ตรวจ vendor bridge และ reconnect vendor หากจำเป็น

PIN ที่สร้างแล้วใช้ไม่ได้กับ lock

สิ่งที่เห็น: AVA สร้าง PIN ได้สำเร็จ แต่ผู้เข้าพักใช้เปิดประตูไม่ได้

วิธีแก้:

1. ตรวจว่า PIN ตรงกันในแอป vendor

   • เปิดแอป smart lock ของ vendor (Igloohome, TTLock หรือ Wishome)
   • ตรวจว่า PIN ในแอปตรงกับที่ AVA สร้าง
   • หา reservation หรือช่วงเวลาที่ตรงกัน

2. หาก PIN ไม่ตรงหรือไม่แสดงในแอป vendor

   • สำหรับล็อกที่ไม่มี bridge: ปิดแล้วเปิดเครื่องโดยถอดและใส่แบตเตอรี่ใหม่
   • สำหรับล็อกที่มี bridge/gateway:
     • รีสตาร์ท bridge โดยถอดปลั๊ก 30 วินาทีแล้วเสียบกลับ
     • รอ 2-3 นาทีให้ bridge เชื่อมต่อใหม่
     • ยืนยันว่า bridge แสดงออนไลน์ในแอป vendor
   • หลังรีเซ็ต คลิก Refresh Locks ใน AVA
   • ลองสร้าง PIN ใหม่

3. หากปัญหายังอยู่

   • ตรวจระดับแบตเตอรี่ของ lock ในแอป vendor (แบตต่ำอาจทำให้ซิงก์มีปัญหา)
   • ยืนยันว่า lock มีการเชื่อมต่อกับ bridge อย่างเสถียรถ้ามี
   • ตรวจ firmware ของ lock ว่าเป็นเวอร์ชันล่าสุดในแอป vendor

ทดสอบ PIN ใน Smart Lock Setup ล้มเหลว

สิ่งที่เห็น: "PIN generation failed for all locks." ใน Smart Lock Setup

วิธีแก้:

1. คลิก Refresh Locks
2. ทดสอบห้องเดียวอีกครั้งด้วย Test PIN Generation
3. หากทดสอบทั้งหมดล้มเหลว ให้เชื่อม vendor ใหม่ใน Room Access

ไม่เห็น lock ใน Smart Lock Setup

สิ่งที่เห็น: Available Devices ว่าง

วิธีแก้:

1. ยืนยันว่าบัญชี vendor เชื่อมแล้ว
2. คลิก Refresh Locks
3. ตรวจว่า lock ปรากฏในแอป vendor และตรงกับ vendor ที่เลือก

ผู้เข้าพักได้ door code ผิด

สิ่งที่เห็น: ผู้เข้าพักได้รับ code สำหรับห้องผิดหลังเปลี่ยนห้องหรือเป็น booking หลายห้อง

วิธีแก้:

1. ไปที่ Settings → Room Access

2. เลื่อนไปที่ Smart Lock Setup

3. ยืนยันว่าการจองแสดง PMS room ที่ถูกต้อง

4. หากเป็น Opera OHIP booking ให้ยืนยันว่าแต่ละห้องมี sub-reservation room number ของตัวเอง

5. หากเป็น booking หลายห้อง ให้ยืนยันว่าแต่ละห้องมี sub-reservation ID ของตัวเอง

6. หากไม่ใช่ Opera ให้ยืนยันว่าแต่ละห้องมี confirmation number เฉพาะห้อง

7. เลือกห้องแล้วเอา lock ผิดออกถ้าจำเป็น

8. จัดสรร lock ที่ถูกต้อง

9. รอ sync แล้วรัน Refresh Locks และ Test PIN Generation อีกครั้ง

   ✓ lock ที่ถูกต้องจะปรากฏใน Assigned Devices

การทำงานไม่รองรับ

สิ่งที่เห็น: AVA แจ้งว่า lock หรือ vendor ไม่รองรับการทำงานที่พยายามทำ

สาเหตุ: รุ่น lock นั้นไม่รองรับฟีเจอร์นั้น หรือ vendor บล็อกไว้

วิธีแก้:

1. ไปที่ Settings → Room Access

2. คลิก Refresh Locks

3. ตรวจป้ายความสามารถใน Smart Lock Setup

4. ใช้รุ่น lock หรือ vendor อื่นหากการทำงานยังถูกปิดอยู่

   ✓ AVA จะแสดงเฉพาะการทำงานที่ lock ที่เชื่อมต่ออยู่ทำได้จริง

ปัญหาเฉพาะ Igloohome

Igloohome แสดง Not linked หลัง OAuth สำเร็จ

สิ่งที่เห็น: ทำ OAuth เสร็จแล้ว แต่ Igloohome Locks ยังแสดง Not linked

วิธีแก้:

1. ค้างอยู่ที่ Settings → Room Access หลัง OAuth กลับมา
2. รอสักครู่ให้สถานะรีเฟรช
3. รีเฟรชหน้าอีกครั้งถ้าสถานะไม่เปลี่ยน
4. ลิงก์บัญชีใหม่หากยังขึ้น Not linked

OAuth connection หมดอายุ

สิ่งที่เห็น: integration แสดง disconnected

วิธีแก้:

1. คลิก Disconnect ใน Igloohome Locks
2. คลิก Link Account
3. ทำ OAuth authorization ให้เสร็จ

ไม่เห็น lock

วิธีแก้:

1. ยืนยันว่า lock ถูก assign ให้ property ใน Igloohome แล้ว
2. กลับไป AVA แล้วคลิก Refresh Locks

ปัญหาเฉพาะ TTLock

Login failed

สิ่งที่เห็น: "Failed to connect TTLock account."

วิธีแก้:

1. ยืนยัน username และ password (แยกตัวพิมพ์เล็กใหญ่)
2. ตรวจว่าบัญชียัง active ในแอป TTLock
3. ลองใหม่หลัง 30 วินาที

lock ไม่ซิงก์

วิธีแก้:

1. เปิดแอป TTLock บนมือถือ
2. ซิงก์ lock แต่ละตัวโดยยืนใกล้ ๆ
3. กลับไป AVA แล้วคลิก Refresh Locks

ปัญหาเฉพาะ Wishome

ข้อมูลรับรองไม่ครบหรือ token หมดอายุ

สิ่งที่เห็น: "Wishome credentials incomplete" หรือคำเตือน token หมดอายุ

วิธีแก้:

1. กรอก Wishome Account Name และ Wishome Password ใหม่
2. ยืนยันว่า Offline Password Version ตรงกับการตั้งค่า Wishome ของคุณ
3. คลิก Connect Wishome Account

ยังติดอยู่?

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

• ❌ lock ทั้งหมดแสดง offline ทั้งที่การเชื่อมต่อดี
• ❌ ข้อมูลรับรอง vendor ถูกต้องแต่เชื่อมต่อไม่ได้
• ❌ PIN ล้มเหลวหลังลองซ้ำหลายครั้ง

ข้อมูลที่ควรแนบ:

• vendor ของ lock (Igloohome, TTLock หรือ Wishome)
• จำนวน lock ที่ได้รับผลกระทบ
• ภาพหน้าจอข้อความผิดพลาด

คู่มือที่เกี่ยวข้อง

• Smart Locks Overview
• Set Up Smart Lock Assignments
• Igloohome Setup
• TTLock Setup
• Wishome Setup