ตั้งค่ากุญแจดิจิทัล QRLOCK

ตั้งค่าอย่างรวดเร็ว

เตรียมรายละเอียด QR Master กำหนดห้อง แล้วทดสอบลิงก์ของผู้เข้าพักหนึ่งรายการ วางแผนใช้เวลาประมาณ 15 นาที

คู่มือนี้ช่วยให้คุณเชื่อมต่อ QRLOCK และออกกุญแจห้องดิจิทัลแบบโฮสต์ผ่าน AVA

ข้อมูลอ้างอิงด่วน

งาน	สิ่งที่ต้องใช้	ทำที่ไหน
เชื่อมต่อ QRLOCK	QR Master SID, Auth Token และหมายเลขชุมชน	Settings → Room Access
จับคู่ห้อง	ID ห้อง PMS ที่ตรงกันทุกประการและห้อง QRLOCK	QRLOCK Room Mapping
ทดสอบการเข้าห้อง	การจองทดสอบและเครื่องอ่าน QRLOCK ที่เข้าถึงได้	รายละเอียดการเช็กอินหรือการจอง
จัดการการเข้าห้อง	คีย์ปัจจุบัน อีเมลผู้เข้าพัก หรือการดำเนินการของพนักงาน	การจองหรือ Access Codes

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

ตรวจสอบข้อกำหนดต่อไปนี้:

• บัญชี QRLOCK ของคุณมี QR Master SID
• คุณมี Auth Token ที่ตรงกัน
• คุณทราบ Community Number ของ QRLOCK
• สร้างห้อง QRLOCK แล้วและมีห้องพร้อมใช้งานในระบบของผู้ให้บริการ
• ID ห้อง PMS เป็นสตริงที่คงที่และไม่ซ้ำกัน
• ในสภาพแวดล้อมจริง AVA ใช้ต้นทางคีย์ผู้เข้าพักแบบ HTTPS สาธารณะ

เก็บข้อมูลรับรองไว้เป็นความลับ

AVA เข้ารหัสข้อมูลรับรอง QRLOCK และลิงก์ผู้เข้าพัก อย่าวางโทเค็นไว้ในภาพหน้าจอ ข้อความถึงฝ่ายสนับสนุน หรือบันทึกที่แชร์ร่วมกัน

ยืนยัน URL ของบริการคีย์ผู้เข้าพัก

ผู้ดูแลการติดตั้งของคุณต้องใช้ URL ของ Room Access Service ที่มีอยู่สำหรับลิงก์ผู้เข้าพัก AVA จะใช้ URL ของแอปพลิเคชันก็ต่อเมื่อไม่ได้กำหนดค่า Room Access URL

การตั้งค่า	การใช้งาน
Room Access Service URL (ROOM_ACCESS_BASE_URL)	ต้นทางหลักสำหรับ /guest-key และ /guest-key/client.js
Application URL (APP_BASE_URL)	ต้นทางสำรองเมื่อไม่ได้กำหนด Room Access URL

URL ที่เลือกต้องเป็นต้นทาง HTTPS สาธารณะในสภาพแวดล้อมจริง URL ต้องไม่มีพาธ คิวรี fragment หรือข้อมูลเข้าสู่ระบบ อย่าเพิ่มการตั้งค่าต้นทางผู้เข้าพักแยกต่างหาก

ขอให้ผู้ดูแลการติดตั้งยืนยันว่าเส้นทางผู้เข้าพักทั้งสองรายการโหลดได้ก่อนทดสอบการออกคีย์

เชื่อมต่อ QRLOCK

1. ไปที่ Settings → Room Access

2. เลือกตัวเลือกการเชื่อมต่อกุญแจดิจิทัล QR

3. เลือก QRLOCK เป็นผู้ให้บริการ

4. กรอก QR Master SID, Auth Token และ Community Number

5. เลือก Test Connection

6. บันทึกการเชื่อมต่อหลังจากการทดสอบสำเร็จ

   ✓ AVA แสดงสถานะ Connected ซ่อนโทเค็นที่บันทึกไว้ และโหลดรายการห้อง QRLOCK

เครื่องอ่าน QR ที่รองรับ

AVA รองรับห้องเครื่องอ่าน QRALOCK และ QRLOCK ผ่านขั้นตอนกุญแจดิจิทัลนี้ ตระกูลรุ่น QR อื่น ๆ ยังไม่พร้อมใช้งาน

จับคู่ห้อง PMS กับห้อง QRLOCK

1. เปิด QRLOCK Room Mapping ในการตั้งค่ากุญแจดิจิทัล QR

2. เลือกห้อง PMS

3. เลือกห้อง QRLOCK ที่ตรงกันจากรายการ

4. บันทึกการจับคู่ที่รอดำเนินการ

5. ทำซ้ำกับทุกห้องที่ควรได้รับคีย์ QR

   ✓ AVA แสดงห้องเป็นห้องที่จับคู่แล้วและพร้อมออกคีย์

QRLOCK ใช้ห้อง PMS ร่วมกับผู้ให้บริการอื่นได้

คุณสามารถคงการจับคู่กับผู้ให้บริการ PIN สำหรับห้อง PMS เดียวกันไว้ได้ QRLOCK จะบันทึกและเปลี่ยนแปลงเฉพาะการจับคู่ QRLOCK การจับคู่กับผู้ให้บริการรายอื่นยังคงใช้ได้สำหรับขั้นตอนการเข้าห้องของผู้ให้บริการนั้น

ต้องจับคู่ทุกห้องอย่างชัดเจน

AVA จะไม่เดาห้อง QRLOCK จากชื่อที่คล้ายกัน ห้องที่ไม่ได้จับคู่หรือจับคู่ไม่ชัดเจนจะไม่สามารถรับคีย์ QR ได้

ส่งคีย์ QR ให้ผู้เข้าพัก

สำหรับการกำหนดห้อง QRLOCK ที่มีสิทธิ์ AVA จะออกคีย์หนึ่งรายการหลังจากกำหนดห้อง AVA จะบันทึกคีย์ก่อนเริ่มส่งอีเมล

1. ดำเนินการเช็กอินผู้เข้าพักให้เสร็จสิ้น

2. เปิด Room Information ของห้องที่เช็กอินแล้ว

3. ตรวจสอบสถานะการส่งคีย์ QR

4. ใช้การดำเนินการลิงก์ผู้เข้าพักเพื่อคัดลอกลิงก์เมื่อจำเป็น

   ✓ ผู้เข้าพักจะได้รับอีเมลข้อมูลห้องพร้อมคำแนะนำการใช้ QR

หลังจากออกคีย์โดยอัตโนมัติหรือโดยพนักงาน ให้ยืนยันว่าคีย์เดียวกันปรากฏในประวัติการเข้าห้อง จากนั้นเปิดลิงก์ผู้เข้าพักและยืนยันว่าหน้า QR แบบโฮสต์โหลดได้

การลองส่งอีเมลใหม่จะใช้คีย์เดิม ระบบจะไม่สร้างบัตรของผู้ให้บริการเพิ่ม

การ์ดห้องอาจแสดงสถานะ Pending, Sent หรือ Staff assistance required การที่อีเมลถูกส่งสำเร็จไม่ได้ยืนยันว่าผู้เข้าพักเปิดประตูแล้ว

ลิงก์จะเป็นไปตามช่วงเวลาที่การจองมีผล AVA แยกลิงก์ผู้เข้าพักออกจากรหัสเข้าห้อง PIN

ส่งข้อมูลห้องอีกครั้ง

ใช้ Email room information เมื่อผู้เข้าพักต้องการรายละเอียดปัจจุบันอีกครั้ง

1. เปิดการจองที่เช็กอินแล้วหรือการ์ดห้อง

2. เลือก Email room information

3. ยืนยันอีเมลส่วนตัวของผู้เข้าพัก

   ✓ AVA ส่งคีย์ QR เดิมและรายละเอียดห้องอีกครั้ง

การดำเนินการส่งอีเมลจะไม่ออกคีย์ใหม่ ใช้อีเมลส่วนตัว ไม่ใช่ที่อยู่พร็อกซีของ OTA

หากการส่งไม่พร้อมใช้งานชั่วคราว AVA จะลองส่งเจตนาการส่งเดิมอีกครั้ง

ออกหรือออกคีย์ใหม่ในฐานะพนักงาน

ใช้การควบคุมสำหรับพนักงานเมื่อไม่ได้ออกคีย์โดยอัตโนมัติ หรือต้องการคีย์ทดแทน

1. เปิดการจองใน Reservations หรือ Access Codes
2. เปิด Manage digital key
3. เลือก Issue เฉพาะเมื่อยังไม่มีคีย์ปัจจุบัน
4. เลือก Send เมื่อคีย์พร้อมใช้งาน
5. เลือก Copy guest link เพื่อแชร์ลิงก์ผู้เข้าพักปัจจุบันโดยตรง

การออกคีย์โดยพนักงานและการส่งอีเมลเป็นการดำเนินการแยกกัน AVA จะตรวจสอบห้องปัจจุบัน วันที่ หมายเลขโทรศัพท์ และการจับคู่ห้องก่อนออกคีย์

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

ถอนหรือออกคีย์ QR ใหม่

ถอนสิทธิ์การเข้าห้องเมื่อผู้เข้าพักเช็กเอาต์ก่อนกำหนดหรือสูญเสียสิทธิ์เข้าห้อง

1. เปิดรายละเอียดการเข้าห้องของห้องในการจอง

2. เลือก Withdraw สำหรับคีย์ QR ปัจจุบัน

3. ยืนยันการถอนสิทธิ์

4. หากการยกเลิกยังอยู่ระหว่างดำเนินการ ให้เลือก Retry cancellation หลังจากตัวเลือกให้ลองใหม่พร้อมใช้งาน

5. รอการยืนยันการยกเลิกจากผู้ให้บริการ

6. รีเฟรชสถานะแล้วเลือก Reissue

7. ยืนยันการสร้างใหม่

   ✓ AVA สร้างบัตรของผู้ให้บริการและลิงก์ผู้เข้าพักใหม่

อย่าลองออกคีย์ใหม่ซ้ำโดยไม่ตรวจสอบเมื่อสถานะไม่แน่ชัด

หาก AVA แสดงคีย์ที่ยังไม่คลี่คลายหรือถูกถอนสิทธิ์ ให้รอการกู้คืนโดยพนักงาน การส่งอัตโนมัติจะไม่แทนที่คีย์นั้นหากไม่มีการดำเนินการอย่างชัดเจน

ลิงก์ AVA เดิมยังคงถูกถอนสิทธิ์หลังจากออกคีย์ใหม่ ใช้เฉพาะลิงก์ผู้เข้าพักล่าสุด

พฤติกรรมเมื่อเช็กเอาต์

การเช็กเอาต์ยังคงใช้พฤติกรรมคีย์ QR เดิม พนักงานต้องถอนสิทธิ์การเข้าห้องสำหรับการออกก่อนกำหนด ช่วงเวลาที่บันทึกไว้ยังคงควบคุมการหมดอายุตามปกติ

ย้ายผู้เข้าพักไปห้องอื่น

AVA จะเชื่อมโยงการสร้างคีย์ QR กับการกำหนดห้อง

1. ดำเนินการย้ายห้องใน PMS ให้เสร็จสิ้น
2. รีเฟรชการจองใน AVA
3. รอให้ AVA ยืนยันห้องปลายทาง
4. ตรวจสอบสถานะการยกเลิกคีย์เดิม
5. ออกสิทธิ์การเข้าห้องสำหรับห้องปลายทางหลังจากการยกเลิกสำเร็จเท่านั้น

หากผู้เข้าพักกลับไปห้องเดิม ให้ใช้การดำเนินการ Reissue ที่ตรวจสอบ revision แล้ว อย่าดำเนินการย้ายห้องใน PMS ซ้ำหลังจากการยกเลิกล้มเหลว

สิ่งที่เห็น → วิธีแก้

การทดสอบการเชื่อมต่อ QRLOCK ล้มเหลว

สิ่งที่เห็น: Test Connection ล้มเหลวหรือไม่มีรายการห้อง QRLOCK โหลดขึ้นมา

วิธีแก้:

1. ตรวจสอบ QR Master SID และ Community Number
2. วาง Auth Token อีกครั้งโดยไม่มีช่องว่างเกินมา
3. ยืนยันว่าบัญชี QRLOCK ของคุณมองเห็นชุมชนและห้องต่าง ๆ
4. บันทึกข้อมูลรับรอง แล้วเรียกใช้ Test Connection อีกครั้ง

ห้องไม่สามารถรับคีย์ QR ได้

สิ่งที่เห็น: การดำเนินการกุญแจดิจิทัล QR ใช้ไม่ได้สำหรับการจองรายการหนึ่ง

วิธีแก้:

1. ยืนยันว่าการจองมีห้องที่กำหนดไว้
2. เปิด QRLOCK Room Mapping
3. จับคู่ห้อง PMS ที่ตรงกันทุกประการกับห้อง QRLOCK หนึ่งห้อง
4. รีเฟรชการจองแล้วลองอีกครั้ง

ลิงก์ผู้เข้าพักถูกถอนสิทธิ์หรือใช้ไม่ได้

สิ่งที่เห็น: ลิงก์เดิมแจ้งว่าไม่สามารถเข้าห้องได้ หรือลิงก์ทดแทนไม่ปรากฏ

วิธีแก้:

1. ยืนยันสถานะคีย์ QR ล่าสุดในการจอง
2. อย่าใช้ลิงก์เก่าซ้ำหลังจากถอนสิทธิ์หรือออกคีย์ใหม่
3. หากยืนยันการยกเลิกแล้ว ให้เลือก Reissue
4. แชร์เฉพาะลิงก์ที่สร้างใหม่

อีเมลคีย์ QR ไม่มาถึง

สิ่งที่เห็น: การ์ดห้องแสดงสถานะอีเมลที่รอดำเนินการหรือล้มเหลว

วิธีแก้:

1. ยืนยันว่าผู้เข้าพักมีอีเมลส่วนตัว

2. ยืนยันว่าที่อยู่นั้นไม่ใช่ที่อยู่พร็อกซีของ OTA

3. รอให้การลองส่งใหม่เสร็จสิ้น

4. เลือก Email room information หลังจากรีเฟรชสถานะ

5. ใช้ Copy guest link หากผู้เข้าพักต้องการเข้าห้องทันที

   ✓ คีย์ QR ปัจจุบันยังคงเดิมระหว่างที่ระบบลองส่งอีเมลใหม่

การออกคีย์ QR แสดงข้อผิดพลาดของบริการ

สิ่งที่เห็น: การออกคีย์โดยอัตโนมัติหรือโดยพนักงานแสดง 503 และไม่มีแถวประวัติหรือลิงก์อีเมลปรากฏ

วิธีแก้:

1. ขอให้ผู้ดูแลการติดตั้งยืนยันว่ากำหนดค่า Room Access Service URL แล้ว

2. ยืนยันว่า /guest-key และ /guest-key/client.js โหลดได้จาก URL สาธารณะนั้น

3. ยืนยันว่า URL ไม่มีพาธ คิวรี fragment หรือข้อมูลเข้าสู่ระบบ

4. ลองออกคีย์อีกครั้งหลังจากรีลีสของ Room Access Service ทำงานปกติ

5. ยืนยันว่ามีแถวใหม่ในประวัติการเข้าห้อง ลิงก์ผู้เข้าพัก และการส่งอีเมล

   ✓ AVA ตรวจสอบเส้นทางผู้เข้าพักก่อนสร้างคีย์ของผู้ให้บริการ

การจับคู่ QRLOCK ขัดแย้งกับผู้ให้บริการรายอื่น

สิ่งที่เห็น: ผู้ให้บริการสมาร์ทล็อกรายเก่าใช้ห้อง PMS เดียวกันอยู่แล้ว

วิธีแก้:

1. เปิด QRLOCK Room Mapping ในการตั้งค่ากุญแจดิจิทัล QR

2. เลือกห้อง PMS และห้อง QRLOCK ที่ตรงกันทุกประการ

3. บันทึกการจับคู่ QRLOCK โดยไม่ลบการจับคู่กับผู้ให้บริการ PIN

4. ยืนยันว่าการจับคู่ของผู้ให้บริการทั้งสองรายยังมองเห็นได้ในพื้นที่ตั้งค่าของตนเอง

   ✓ QRLOCK ใช้การจับคู่ของตนเอง ขณะที่ผู้ให้บริการ PIN ยังคงใช้การจับคู่ของตนเอง

หากยังบันทึกไม่ได้ ให้รีเฟรชหน้าแล้วลองอีกครั้งหนึ่ง อย่ารีเซ็ตการจับคู่ของผู้ให้บริการ PIN เพื่อแก้ข้อขัดแย้งกับ QRLOCK

การย้ายห้องขัดขวางการออกคีย์ทดแทน

สิ่งที่เห็น: AVA แจ้งว่าต้องกู้คืนโดยพนักงานก่อนออกคีย์

วิธีแก้:

1. รีเฟรชการจองหลังจาก PMS ยืนยันห้องปลายทาง

2. เปิดสถานะคีย์ QR ของห้องเดิม

3. ยืนยันว่าการยกเลิกกับผู้ให้บริการสำเร็จ

4. ตรวจสอบการจับคู่ห้องปลายทาง

5. เลือก Reissue เฉพาะเมื่อ AVA เปิดให้ใช้งาน

   ✓ AVA สร้างคีย์ทดแทนหนึ่งรายการสำหรับสถานะปลายทางที่ยืนยันแล้ว

ห้องที่เลือกไม่สามารถใช้การดำเนินการกุญแจดิจิทัล

สิ่งที่เห็น: Issue, Reissue หรือ Send ใช้ไม่ได้สำหรับห้องหนึ่ง

วิธีแก้:

1. ยืนยันว่าห้องที่เลือกไม่อยู่ในสถานะสิ้นสุดใน PMS
2. เลือกห้องที่ยังใช้งานอยู่จากการจองเมื่อเหมาะสม
3. ตรวจสอบสถานะและประวัติที่มีอยู่ของห้องในสถานะสิ้นสุด
4. ถอนสิทธิ์การเข้าห้องเฉพาะเมื่อผู้เข้าพักไม่ควรเข้าห้องนั้นอีกต่อไป

สแกน QR ได้แต่ประตูไม่เปิด

สิ่งที่เห็น: หน้าแบบโฮสต์แสดงรหัส QR แต่เครื่องอ่านปฏิเสธรหัส

วิธีแก้:

1. ยืนยันว่าผู้เข้าพักใช้ลิงก์ล่าสุด
2. ตรวจสอบช่วงเวลาที่การจองมีผลและเวลาปัจจุบัน
3. ยืนยันว่าการจับคู่ห้อง QRLOCK ตรงกับห้องจริง
4. ทดสอบเครื่องอ่านด้วยแอป QRLOCK หรือเครื่องมือของผู้ให้บริการ
5. ใช้วิธีเข้าห้องสำรองของโรงแรมระหว่างตรวจสอบปัญหา

ยังแก้ไม่ได้ใช่ไหม

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

• ❌ ข้อมูลรับรองยังใช้ไม่ได้หลังจากตรวจสอบแล้ว
• ❌ ห้องที่จับคู่แล้วไม่สามารถออกคีย์ QR ได้
• ❌ การยกเลิกหรือการออกคีย์ใหม่ยังไม่คลี่คลาย

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

• ชื่อโรงแรมและหมายเลขห้อง
• รุ่น QRLOCK และหมายเลขชุมชน
• ภาพหน้าจอสถานะที่ไม่มีข้อมูลรับรอง
• ID การจองและเวลาที่เริ่มเกิดปัญหา

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

• ภาพรวมสมาร์ทล็อก
• ตั้งค่าการกำหนดสมาร์ทล็อก
• การแก้ไขปัญหาสมาร์ทล็อก