การแก้ปัญหา Keycard Encoder

แก้เร็ว

ตรวจเครือข่ายและไฟก่อน แล้วลองเข้ารหัสการ์ดใบเดียวใหม่ ใช้เวลาประมาณ 2 นาที

คู่มือนี้ช่วยคุณแก้ปัญหา keycard encoder ที่พบบ่อย

อ้างอิงด่วน

What you see	Why it happens	Do this
Encoder not responding	ปัญหาไฟหรือเครือข่าย	Check connectivity
Cards not encoding	ปัญหาประเภทการ์ดหรืออุปกรณ์	Verify card and device
"UserCredentialsNotProvided.NotApplicable"	ข้อมูลรับรอง Saflok หายไปหรือไม่ครบ	Add Saflok credentials
Saflok/Ambiance encoding fails or times out	Windows Agent, Ambiance encoder service, หรืออุปกรณ์ offline	Restart Saflok/Ambiance encoder
"Please create a new keycard first, then use Duplicate for any extra cards."	Saflok หา active registration สำหรับการจองนี้ไม่พบ	Fix the missing first keycard
Multi-room Saflok/Ambiance card needs a room-level ID	ห้องที่เลือกยังไม่มี sub-reservation ของตัวเอง	Check the selected room
Encoder type change does not stick	การบันทึกก่อนหน้าทำให้สถานะ encoder ปนกัน	Re-save encoder type
"Test Connection" fails (Be-Tech) or agent stays offline	Base URL, adapter, หรือ service มีปัญหา	Fix Be-Tech connection
"Test Connection" fails (GreatLocks)	รายละเอียด server ที่บันทึกไว้หายหรือเก่า	Fix GreatLocks connection
"Service URL is required" (LockSDK)	โหมด direct ต้องมี Service URL แยกต่อ encoder	Add LockSDK service URL
LockSDK agent shows Not registered	ยังไม่มีอุปกรณ์ agent ต่อ encoder	Register LockSDK agent
Heartbeat Monitor turns off after save	การบันทึกไม่คงอยู่ใน session โรงแรมปัจจุบัน	Re-save Heartbeat Monitor
Heartbeat shows unreachable	agent offline หรือ tunnel มีปัญหา	Check agent status
Encoder stays unavailable	dynamic list ยังเห็น agent เป็น disconnected	Check live encoder status
Windows Agent shows Not connected	agent ไม่ได้รันหรือการติดตั้งไม่สมบูรณ์	Reconnect agent

Encoder not responding

สิ่งที่เห็น: encoder แสดง offline หรือไม่ตอบสนองใน AVA

วิธีแก้:

1. ตรวจไฟและสายของ encoder
2. ตรวจการเชื่อมต่อเครือข่ายระหว่าง kiosk และ encoder (เฉพาะ Direct Connection)
3. ยืนยันว่า server IP และ port ถูกต้อง
4. รีสตาร์ทซอฟต์แวร์ encoder

Cards not encoding

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

วิธีแก้:

1. ยืนยันว่าชนิดการ์ดตรงกับ encoder
2. ใส่การ์ดใหม่แล้วลองอีกครั้ง
3. ทดสอบด้วยการ์ดเปล่าใบใหม่
4. หากปิด Enable guest selection อยู่ ให้ตรวจว่า kiosk ถูก routing ไป encoder ที่ถูกต้อง
5. หากเปิด Enable guest selection อยู่ ให้ยืนยันว่าผู้เข้าพักเลือก encoder ที่ออนไลน์ที่ kiosk

Saflok/Ambiance encoding not working

สิ่งที่เห็น: การเข้ารหัส keycard ล้มเหลว หมดเวลา หรือ kiosk แจ้งว่าไม่ได้รับการตอบกลับจาก Saflok/Ambiance encoder

วิธีแก้: ทำตาม 3 ตรวจนี้ตามลำดับ แต่ละข้อจะตัดสาเหตุที่พบบ่อยออกไปก่อน

การกู้คืน Saflok อัตโนมัติ

หาก Saflok PMSI เริ่มช้าหรือรีสตาร์ทภายหลัง AVA จะตรวจความพร้อมใหม่ทุก 10 วินาที รอสักครู่แล้วรีเฟรชก่อนติดตั้ง agent ใหม่

1. ตรวจว่า Windows Agent เชื่อมต่ออยู่ใน AVA

1. ไปที่ Settings → Room Access → Keycard Encoding

2. หา card Windows Agent ของ encoder นี้

3. ยืนยันว่าสถานะแสดง Connected และเวลา Last Seen ล่าสุด

   

4. หาก agent เป็น Not connected ให้ทำตาม Windows Agent not connected ก่อน หาก Saflok PMSI ยังเริ่มทำงานอยู่ ให้รอ 10 วินาทีแล้วรีเฟรชก่อนติดตั้งใหม่

2. ตรวจว่า encoder ออนไลน์ใน Ambiance

หาก agent เชื่อมต่ออยู่แต่ยังเข้ารหัสไม่ได้ ให้เข้าสู่ระบบ Ambiance server แล้วตรวจอุปกรณ์ encoder

1. เปิด Ambiance แล้วไปที่ Device Management → Encoders

2. หา encoder ของ kiosk นี้ (เช่น encoder Vouch)

3. ยืนยันว่า Status เป็น Online

   

4. หาก encoder แสดง Offline ให้ไปขั้นตอนที่ 3 เพื่อรีสตาร์ท service

3. รีสตาร์ท Ambiance Encoder Service

หาก encoder offline ใน Ambiance ให้รีสตาร์ท encoder service บนเครื่องที่ติดตั้ง Ambiance server

1. ที่เครื่องที่รัน Ambiance server ให้กด Windows หรือคลิกเมนู Start

2. พิมพ์ services manager แล้วเปิด Ambiance Services Manager

3. ในรายการบริการ เลือก Ambiance Encoder Service

   

4. คลิกปุ่ม Stop (สี่เหลี่ยมสีแดง)

5. รอสักครู่จนสถานะบริการเปลี่ยนเป็น Stopped

6. คลิกปุ่ม Start (ปุ่มเล่นสีแดง)

7. ยืนยันว่า State กลับเป็น Running

8. กลับไปที่ Ambiance Device Management → Encoders และยืนยันว่า encoder เป็น Online

9. ลองเข้ารหัสการ์ดทดสอบจาก kiosk

ทำไมการรีสตาร์ทช่วยได้

service ของ encoder อาจหลุดการเชื่อมต่อกับ encoder จริงหลังเครือข่ายกระตุกหรือปล่อยทิ้งไว้นาน การหยุดแล้วเริ่มใหม่จะบังคับให้เชื่อมต่ออีกครั้ง

Saflok duplicate keycard needs a first keycard

สิ่งที่เห็น: AVA แสดง "Please create a new keycard first, then use Duplicate for any extra cards."

สาเหตุ: Saflok หา active registration หรือ keycard record สำหรับ reservation นี้ไม่พบ การ์ดแบบ duplicate ต้องมี keycard ใบแรกที่สร้างสำเร็จก่อน AVA จะเพิ่มใบอื่นได้

วิธีแก้:

1. สร้าง keycard ใบแรกสำหรับ reservation
2. รอให้การเข้ารหัสใบแรกเสร็จสมบูรณ์
3. เลือก Duplicate หลังมี keycard ใบแรกแล้วเท่านั้น
4. หาก error กลับมาอีกครั้ง ยืนยันว่า reservation ยังมี active registration ใน Ambiance
5. ลองส่งคำขอ duplicate อีกครั้ง

สิ่งที่ไม่ควรเห็น

ไม่ควรเห็น ReservationNotFound แบบดิบหรือรายละเอียด SOAP fault ในข้อความ

Saflok/Ambiance multi-room keycards need a room-level reservation ID

สิ่งที่เห็น: คุณพยายามเข้ารหัสการ์ดสำหรับหนึ่งห้องใน stay หลายห้อง แล้ว AVA หยุด flow

สาเหตุ: การ์ด duplicate ของ Saflok/Ambiance ใช้ sub-reservation ID ของห้องที่เลือก หากห้องนั้นยังไม่มี ID ของตัวเอง คุณจะเห็น error แบบ fail-fast

วิธีแก้:

1. เปิด reservation แล้วเลือกแถวห้องที่ต้องการตรง ๆ
2. รอ PMS sync หากเพิ่ง split หรือย้ายห้อง
3. ยืนยันว่าห้องมีอยู่เป็น sub-reservation ของตัวเองใน PMS
4. ลอง Encode Keycard อีกครั้ง

Saflok credentials not provided

สิ่งที่เห็น: "UserCredentialsNotProvided.NotApplicable" ปรากฏระหว่างการเข้ารหัส keycard

วิธีแก้:

1. ไปที่ Settings → Room Access → Keycard Encoding
2. ตั้ง Encoder Type เป็น Saflok
3. กรอก Username และ Password ใน Encoder Credentials
4. หากเปิด direct communication ให้กรอก PMSI Server URL
5. คลิก Save
6. คลิก Test Connection แล้วเข้ารหัสการ์ดทดสอบ 1 ใบ

Encoder type change does not stick

สิ่งที่เห็น: เลือก encoder type หนึ่งแล้ว แต่อีกประเภทหนึ่งยัง active อยู่

วิธีแก้:

1. ไปที่ Settings → Room Access → Keycard Encoding
2. ใน Keycard Encoder Settings เลือก encoder type ที่ต้องการ
3. คลิก Save เพียงครั้งเดียวแล้วรอข้อความสำเร็จ
4. รีเฟรชหน้าและยืนยันว่ามี active แค่ encoder type นั้น
5. หากปัญหาเกิดซ้ำ ให้สลับประเภท บันทึก แล้วสลับกลับและบันทึกอีกครั้ง

Be-Tech test connection fails

สิ่งที่เห็น: "Test Connection" ล้มเหลวหรือปุ่มยังถูกปิดใช้งาน

ใช้กรณีที่คุณตั้งค่า direct Base URL ไว้จริง หากคาดว่าจะใช้ Windows Agent ให้ล้าง URL แบบ direct แล้วบันทึกใหม่

วิธีแก้:

1. ยืนยันว่า Base URL เริ่มด้วย http:// หรือ https://
2. ตรวจว่า Be-Tech service กำลังทำงานบนเครื่อง workstation ของ encoder
3. ตรวจว่า workstation กับ kiosk อยู่ในเครือข่ายเดียวกัน
4. หากใช้ Windows Agent ให้ยืนยันว่าการ์ด agent เป็น Connected
5. กรอก Hotel Name, Chain No, Workstation, และ Reader No ใหม่
6. คลิก Test Connection อีกครั้ง

GreatLocks test connection fails

สิ่งที่เห็น: Test Connection ล้มเหลวหลังแก้รายละเอียด server ของ GreatLocks

วิธีแก้:

1. ไปที่ Settings → Room Access → Keycard Encoding
2. ยืนยันว่า GreatLocks server มี XHLSI Server IP Address และ TCP Port
3. คลิก Save อีกครั้ง
4. หากอัปเดตจากการตั้งค่าเก่า ให้คง server record เดิมไว้
5. คลิก Test Connection อีกครั้ง

LockSDK service URL is required

สิ่งที่เห็น: บันทึกถูกบล็อกหรือฟอร์ม encoder แสดง "Service URL is required."

วิธีแก้:

1. ไปที่ Settings → Room Access → Keycard Encoding
2. เลือก LockSDK
3. เปิด Physical Encoder Devices แล้วแก้ encoder
4. กรอก Service URL ที่ถูกต้อง เช่น http://127.0.0.1:8092
5. คลิก Save แล้วรัน Test Connection

LockSDK agent not registered

สิ่งที่เห็น: การ์ด encoder ของ LockSDK แสดง Not registered ใน Windows Agent

วิธีแก้:

1. ยืนยันว่ามี LockSDK encoder ใน Physical Encoder Devices
2. ไปที่ Windows Agent แล้วหาการ์ด encoder
3. คลิก Download Windows Agent หากการ์ดยังใหม่ หรือ Reinstall หากมีอยู่แล้ว
4. แตกแพ็กเกจแล้วรันไฟล์ .bat บนเครื่อง Windows ที่เชื่อมต่ออยู่
5. รีเฟรชสถานะและยืนยันว่าการ์ดเปลี่ยนจาก Not registered เป็น Connected หรือ Not connected
6. ใช้ Advanced options เฉพาะสำหรับ View Logs, Rotate Secret, หรือ Delete Rotate Secret จะเปิดกล่องยืนยันก่อนที่ AVA จะตัดการเชื่อมต่อ agent ปัจจุบัน

Heartbeat Monitor turns off after save

สิ่งที่เห็น: เปิด Heartbeat Monitor, คลิก Save, แล้วมันปิดกลับเอง

วิธีแก้:

1. ไปที่ Settings → Room Access → Keycard Encoding
2. เปิด Encoding Options → Advanced options
3. เปิด Heartbeat Monitor
4. คลิก Save เพียงครั้งเดียวแล้วรอข้อความสำเร็จ
5. รีเฟรชหน้าและยืนยันว่า Heartbeat Monitor ยังเปิดอยู่
6. หากยังปิดอยู่ ให้ทำตาม Settings Not Saving After Switching Hotels

Heartbeat failures

สิ่งที่เห็น: Heartbeat Monitor แสดง unreachable

วิธีแก้:

1. ยืนยันว่า agent กำลังรันบน kiosk/PC
2. ตรวจ Registered Agents ว่าออนไลน์และ tunnel เข้าถึงได้
3. ตรวจ logs ของ agent เพื่อหาข้อผิดพลาด
4. ติดตั้ง agent ใหม่หากจำเป็น

Live encoder status does not match

สิ่งที่เห็น: encoder ดูเหมือนตั้งค่าแล้ว แต่ AVA ยังทำเครื่องหมายว่าใช้งานไม่ได้ใน reservation modal

สาเหตุ: AVA จะแสดง online ก็ต่อเมื่อ agent เชื่อมต่อและ tunnel เข้าถึงได้เท่านั้น สถานะเดียวกันนี้ใช้ตัดสิน dynamic encoder selection

วิธีแก้:

1. ตรวจ Registered Agents สำหรับการ์ด encoder นั้น
2. ยืนยันว่า device เชื่อมต่อและ tunnel เข้าถึงได้
3. แก้ปัญหา agent หรือเครือข่ายก่อน
4. รีเฟรช Settings → Room Access
5. ลองเข้ารหัสอีกครั้ง
6. ตรวจบรรทัด Status: ในหน้าการตั้งค่าอีกครั้ง

Windows Agent not connected

สิ่งที่เห็น: สถานะแสดง Not connected หรือ "Never online."

วิธีแก้:

1. เปิด zip ที่ดาวน์โหลดแล้วรัน download-installer.bat
2. รอให้ดาวน์โหลด installer .exe แล้วรันไฟล์นั้น
3. ยืนยันว่า Windows PC มีอินเทอร์เน็ต
4. คลิก Reinstall บนการ์ด agent ใน Windows Agent หากจำเป็น
5. หากเป็น Be-Tech setup ให้ยืนยันว่า local adapter service ทำงานอยู่ด้วย สถานะ Be-Tech อาจใช้เวลาสูงสุด 5 นาทีจึงจะรีเฟรชหลังรีสตาร์ท
6. รีเฟรชสถานะ Registered Agents
7. กลับไปที่ Settings → Room Access และยืนยันว่า Status: เปลี่ยนเป็น online

รายชื่อ encoder แบบ dynamic

เมื่อ agent เชื่อมต่อและ tunnel เข้าถึงได้ รายชื่อ encoder แบบ dynamic ควรแสดง Online หากการ์ด encoder ชั้นในยังดู offline ให้รีเฟรชหน้าและตรวจ agent ก่อน

Kiosk routing rules not showing

สิ่งที่เห็น: หา routing rules ใน Kiosk to Encoder Routing ไม่เจอ

วิธีแก้:

1. ตรวจว่า Enable guest selection เปิดอยู่หรือไม่
2. ปิดมันเพื่อให้แสดง routing rules แบบ manual
3. เพิ่มอุปกรณ์อย่างน้อยหนึ่งตัวใน Physical Encoder Devices

ยังติดอยู่?

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

• ❌ encoder ยัง offline หลังตรวจไฟและเครือข่าย
• ❌ เข้ารหัสการ์ดไม่ผ่านหลาย kiosk
• ❌ heartbeat ยัง unhealthy เกิน 30 นาที

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

• ประเภท encoder และรุ่น
• ภาพหน้าจอ Registered Agents และ Heartbeat Monitor
• เวลาที่ปัญหาเริ่มเกิดขึ้น

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

• Keycard Encoders Overview
• Set Up Keycard Encoders
• Keycard Guest Instructions