ตั้งค่า Keycard Encoders

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

เลือกประเภท encoder เลือกวิธีเชื่อมต่อ (ถ้ามี) แล้วเพิ่ม encoder เผื่อเวลาประมาณ 15 นาที

คู่มือนี้ช่วยคุณตั้งค่าการเข้ารหัส keycard แบบ encoder-first สำหรับใช้งานที่ kiosk หรือหน้าเคาน์เตอร์ ตอนนี้ครอบคลุมการตั้งค่า Be-Tech Windows Agent ด้วย Be-Tech ใช้ Windows Agent เป็นค่าเริ่มต้น เว้นแต่คุณจะกำหนด Base URL แบบ direct Kiosk routing ตอนนี้อยู่ที่ Settings → Kiosk keycard ที่เชื่อมต่อกับ PMS จะค้นหา encoder terminal จากผู้ให้บริการ PMS ก่อนที่คุณจะเพิ่มอุปกรณ์ การตั้งค่า Be-Tech Windows Agent สามารถกู้คืน client หรือ service ที่หยุดทำงานหลัง Windows รีสตาร์ทหรือหยุดด้วยตนเอง

สรุปอ้างอิง

งาน	ทำอะไร	คลิกที่ไหน
Select method	เปิดใช้งาน keycard encoding	Room Access → Keycard Encoding
Choose encoder type	เลือกระบบล็อกของคุณ	Encoder Type
Choose connection method	Direct หรือ Windows Agent (Saflok/Be-Tech/GreatLocks)	Advanced options → Enable direct communication
Configure encoder	เพิ่มเซิร์ฟเวอร์หรือข้อมูลรับรอง	ช่องเฉพาะแต่ละประเภท
Add encoders	ลงทะเบียนอุปกรณ์จริงด้วย encoder ID จริง	Physical Encoder Devices
Load PMS encoders	ดึง terminal ที่พร้อมใช้งานจาก PMS	Physical Encoder Devices → Load Encoders
Enable PMS card reading	อนุญาตให้ Entitlements อ่าน keycard จริงของ PMS	Enable physical keycard reading
Choose kiosk routing	ควบคุมกฎ routing เฉพาะ kiosk	Settings → Kiosk → Device Routing
Download Windows Agent	ดาวน์โหลด bootstrap package สำหรับ agent	Windows Agent
Check agent version	แสดงสถานะเวอร์ชันที่ติดตั้งและเวอร์ชันล่าสุด	Windows Agent
Update agent	เปิด modal คำแนะนำการอัปเดต	Update
Manage agent cards	การ์ดหลักแสดงการติดตั้ง อัปเดต หรือ reinstall	Windows Agent
Advanced agent actions	ดู logs, rotate secrets หรือลบ agents	Advanced options
Set encoding defaults	จำนวนการ์ดต่อการเข้าพัก + เวลาหมดอายุ	Encoding Options

ตำแหน่งที่พบ

Settings → Room Access → Keycard Encoding

ขั้นตอนที่ 1: เลือกวิธี keycard

1. ไปที่ Settings → Room Access
2. เลือก Keycard Encoding เป็นวิธี room access
3. คลิก Save

ขั้นตอนที่ 2: เลือกประเภท encoder

1. เลื่อนไปที่ Keycard Encoder Settings

2. เลือก Saflok, Be-Tech, LockSDK, GreatLocks, หรือ PMS Integration

   ✓ AVA จะเปิดใช้งานเฉพาะ encoder type ที่คุณเลือก

ขั้นตอนที่ 3: เลือกวิธีเชื่อมต่อ

1. ใน Select Encoder Type เปิด Advanced options
2. สำหรับ Saflok, GreatLocks, หรือ LockSDK ให้เปิด Enable direct communication เพื่อข้าม Windows Agent
3. ปิดไว้หากต้องการใช้ Windows Agent (ค่าเริ่มต้น)
4. Be-Tech ใช้ Windows Agent เว้นแต่คุณมี Base URL แบบ direct อยู่แล้ว
5. PMS Integration ใช้ direct communication เท่านั้น ดังนั้นข้ามขั้นตอนนี้ได้

ขั้นตอนที่ 4: ตั้งค่าระบบ encoder

ชื่อ Encoder Credentials

หากคุณใช้ encoder หลายตัว หัวข้อส่วนนี้จะแสดงเป็น Encoder Credentials & Devices

ถ้าคุณใช้ Saflok

• Direct communication
  • กรอก PMSI Server URL, Username และ Password
  • PMSI server ต้องเข้าถึงได้จากอินเทอร์เน็ต
  • คลิก Test Connection
• Windows Agent
  • กรอกเฉพาะ Username และ Password
  • agent จะจัดการ PMSI URL และการทดสอบการเชื่อมต่อ
  • AVA จะตรวจความพร้อมของ Saflok PMSI ซ้ำเรื่อย ๆ ดังนั้นการบูตช้าและการรีสตาร์ทมักจะกู้คืนได้เอง
• เพิ่มอุปกรณ์ encoder ใน Physical Encoder Devices (ต้องมี Encoder ID)
• ตัวเลือก: ตั้ง Location ให้แต่ละ encoder
• หากหลาย kiosk แชร์ encoder กัน ให้เพิ่ม routing จาก Settings → Kiosk → Device Routing

ถ้าคุณใช้ Be-Tech

• Direct communication
  • กรอก Base URL ของบริการ Be-Tech
  • บริการต้องเข้าถึงได้จากอินเทอร์เน็ต
  • กรอก Hotel Name, Chain No, Workstation และ Reader No
  • ตั้ง Category และ Card Type หากการตั้งค่า Be-Tech ของคุณต้องใช้
  • หากบันทึก Base URL แล้ว AVA จะคง Be-Tech ไว้ในโหมด direct
  • คลิก Test Connection เพื่อยืนยันว่า encoder ตอบสนอง
• Windows Agent
  • ติดตั้ง agent บน Windows PC ที่เชื่อมต่อกับ workstation ของ Be-Tech
  • กรอก Hotel Name, Chain No, Workstation และ Reader No
  • agent จะจัดการ local Be-Tech adapter และ proxy ทราฟฟิกของ vendor
  • AVA จะตรวจ agent ที่ /check ทุก 5 นาที
  • หลัง Windows รีสตาร์ทหรือหยุดด้วยตนเอง tray สามารถเริ่ม Be-Tech client และ service ได้โดยอัตโนมัติ
  • tray จะรีเฟรชความพร้อมของ Be-Tech หลังการกู้คืน โดยไม่ต้องรีสตาร์ท agent ด้วยตนเอง
  • หากไม่มีการบันทึก Base URL AVA จะย้อนกลับไปใช้ flow ของ Windows Agent
• เพิ่มอุปกรณ์ encoder ใน Physical Encoder Devices
• ตัวเลือก: เพิ่ม routing จาก Settings → Kiosk → Device Routing หากใช้ encoder หลายตัว

การติดตั้ง Be-Tech หลายชุด

agent จะค้นหาการติดตั้ง Be-Tech ปกติโดยอัตโนมัติ ขอให้ deployment admin ตั้งค่า BETECH_CLIENT_PATH เฉพาะเมื่อการติดตั้งที่มีการป้องกันหลายชุดทำให้เกิดความกำกวม ค่า override ต้องชี้ไปยังโฟลเดอร์ Program Files ที่มีการป้องกันภายใน Windows

ถ้าคุณใช้ GreatLocks

• Direct communication
  • กรอก Server Name (ไม่บังคับ), XHLSI Server IP Address และ TCP Port
  • server ต้องเข้าถึงได้จากอินเทอร์เน็ต
  • GreatLocks รองรับ encoder หนึ่งตัวต่อ server หนึ่งเครื่อง
  • คลิก Test Connection
• Windows Agent
  • agent จะจัดการรายละเอียด server ให้ ไม่ต้องกรอก IP/port
  • ติดตั้ง Universal Encoder Agent หนึ่งตัวบน PC ที่เชื่อมต่อกับ encoder GreatLocks แต่ละตัว

ใช้ GreatLocks agent หนึ่งตัวต่อ encoder

เพิ่มหนึ่งแถวใน Physical Encoder Devices สำหรับ encoder GreatLocks แต่ละตัว กรอก Encoder ID เพียงหนึ่งค่าในแต่ละแถว ใช้ ID ที่ไม่ซ้ำกันในทุกแถว เช่น front-desk หรือ lobby-pc AVA จะคง ID เดิมไว้เมื่อคุณแก้ไขแถวที่บันทึกแล้ว แถวเก่าที่ไม่มี ID จะได้รับ ID ที่คงที่เมื่อ AVA โหลดข้อมูล จากนั้นติดตั้ง Universal Encoder Agent หนึ่งตัวบน Windows PC ที่ตรงกัน agent แต่ละตัวจะให้บริการเฉพาะ encoder ที่เชื่อมโยงกับตนเอง

หมายเหตุ: AVA ใช้รายการ GreatLocks server ที่คุณบันทึกไว้ใน Room Access หากคุณอัปเดตการตั้งค่าเก่า ให้คลิก Save ก่อน Test Connection หากเปิดใช้ inventory sync AVA จะอ่านข้อมูล building, floor และ room ผ่าน agent tunnel ที่ใช้งานอยู่ ให้ agent ออนไลน์ไว้เพื่อให้รายการห้องเป็นปัจจุบัน หากการตั้งค่า GreatLocks รองรับ lift access ให้เปิด Enable lift access จากนั้นเลือกโหมดที่ vendor รองรับ:

• Room floor mapping ใช้ค่า building และ floor จาก room mappings ของคุณ
• Access code groups ใช้ Common access codes สำหรับประตูที่ใช้ร่วมกันหรือกลุ่มลิฟต์

AVA จะส่งประเภทตัวเลือก lift เพียงหนึ่งประเภทต่อการ์ด เมื่อใช้ access code groups AVA จะบันทึกเลขหลักเดียวเป็นรหัสสองหลัก คุณสามารถพิมพ์ 1,2,3 หรือ 01,02,03 ใช้รหัสให้อยู่ในช่วงที่ vendor รองรับ

ถ้าคุณใช้ LockSDK

• Direct communication
  • เพิ่ม LockSDK encoder แต่ละตัวใน Physical Encoder Devices
  • กรอก Encoder ID และ Service URL สำหรับแต่ละ encoder
  • คลิก Test Connection หลังเพิ่มรายการ encoder
• Windows Agent
  • เพิ่ม LockSDK encoder แต่ละตัวใน Physical Encoder Devices
  • ลงทะเบียน Windows Agent หนึ่งตัวต่อ LockSDK encoder หนึ่งตัว
  • การ์ด agent จะแสดง encoder ที่ตรงกันและสถานะสด
• ตัวเลือก: เพิ่ม routing จาก Settings → Kiosk → Device Routing หากใช้ encoder หลายตัว
• สำหรับ combined rooms, LockSDK รองรับได้สูงสุด 4 ห้อง และต้องใช้ RF50/Mifare lock type 5

ถ้าคุณใช้ PMS Integration

• ตรวจสอบให้แน่ใจว่ามี PMS integration ที่ active อยู่ (Cloudbeds หรือ Opera)
• ตั้งค่า PMS vendor ให้ตรงกับที่พักของคุณก่อนโหลด encoder
• เปิด Enable PMS Encoder Integration
• ใน Physical Encoder Devices ให้ทำอย่างใดอย่างหนึ่ง:
  • คลิก Load Encoders แล้ว Add Selected หรือ
  • คลิก Add Encoder แล้วกรอก Encoder ID และ PMS Encoder ID
• อุปกรณ์ที่โหลดจะเก็บ provider encoder ID ไว้โดยตรง
• การค้นพบใหม่จะบันทึก workstation, encoder, interface และ outbound-code details ที่จำเป็นสำหรับการอ่านบัตร PMS
• การอ่านของ Opera จะทำงานเฉพาะเมื่อรายละเอียดเหล่านั้นระบุ Door Lock route ที่ตรงกันเพียงรายการเดียว
• ใช้ Active เพื่อปิด encoder ที่ไม่ต้องการใช้
• เปิด Enable physical keycard reading เฉพาะหลังจากตรวจสอบ PMS read API แล้ว
• คลิก Save หลังเปลี่ยนการตั้งค่าการอ่าน
• หากรายการว่าง ให้ตรวจสอบการตั้งค่า PMS vendor ก่อน
• หากยังไม่พบ encoder ให้อ่าน PMS encoder discovery returns no results

การอ่านบัตร PMS แยกจากการเข้ารหัส

การเข้ารหัส PMS ยังทำงานต่อได้แม้ปิดการอ่านบัตรจริงไว้ Entitlements จะซ่อนตัวควบคุมการสแกนจนกว่าความสามารถของ PMS และ Room Access จะอนุญาตให้อ่านได้ ปิดการอ่านไว้จนกว่าผู้ให้บริการ PMS จะยืนยันว่า read API ใช้งานได้สำหรับที่พักของคุณ

การรองรับการอ่านบัตร PMS

ผู้ให้บริการ PMS	การอ่านบัตรจริง	สิ่งที่ควรทำ
Opera Cloud (OHIP)	รองรับเมื่อ adapter ประกาศความสามารถนี้	ดำเนินการยอมรับฮาร์ดแวร์ให้เสร็จก่อนเปิดการอ่าน
ผู้ให้บริการ PMS อื่น	ไม่พร้อมใช้งาน เว้นแต่ vendor จะประกาศว่ารองรับ	ใช้การค้นหาห้องหรือ confirmation ด้วยตนเอง

AVA จะปิดการทำงานเมื่อ PMS ของคุณไม่ประกาศว่ารองรับการอ่านบัตรจริง ขั้นตอนการเข้ารหัส keycard เดิมของคุณยังคงใช้งานได้

เปิดใช้การอ่านบัตร PMS

การอ่านบัตร PMS ใช้ PMS transport โดยตรง ไม่จำเป็นต้องมี Universal Encoder Agent session AVA จะเปิดใช้การสแกนเมื่อทั้ง merchant setting และความสามารถของ PMS อนุญาต

1. เลือก PMS Integration ใต้ Encoder Type

2. ยืนยันว่าเปิด Enable PMS Encoder Integration อยู่

3. ยืนยันว่ามี encoder ที่ค้นพบอย่างน้อยหนึ่งตัวเป็น Active

4. เปิด Enable physical keycard reading

5. คลิก Save

6. เปิด Entitlements แล้วโหลดหน้าใหม่

   ✓ Start scanning จะปรากฏเมื่อ PMS รายงานว่ารองรับการอ่านบัตรจริง ✓ การค้นหาห้องและ confirmation ด้วยตนเองยังใช้งานได้เมื่อการสแกนไม่พร้อม

การจับคู่ kiosk ของ PMS

สำหรับ PMS Integration, AVA จะค้นหา Device Model mapping ของ kiosk กับอุปกรณ์ PMS encoder ที่ active ก่อน หาก mapping นั้นใช้ไม่ได้หรือไม่ตรงกัน AVA จะใช้ kiosk mapping แบบเดิม ให้ encoder เป้าหมายเป็น Active และใช้ชื่อ PMS encoder ปัจจุบันใน Device Routing

การจับคู่ route ของ Opera ต้องตรงกันทุกประการ

การอ่านบัตรของ Opera ต้องมี workstation, encoder ID, interface และ Door Lock outbound code ที่ตรงกันหนึ่งชุด หาก Opera ส่ง route ที่ซ้ำกันหรือข้อมูลไม่ครบ AVA จะปิดการอ่านแทนการเดา ขอให้ผู้ดูแล Opera แก้ไข encoder catalog แล้วคลิก Load Encoders อีกครั้ง

ค่า interface ของ Saflok

Opera อาจแสดงค่า encoder interface เช่น SL01 AVA ใช้ค่านั้นเพื่อเลือก Door Lock route ที่ตรงกัน คำขออ่านจะใช้ numeric outbound code ที่ค้นพบแทน คุณไม่จำเป็นต้องเปลี่ยนค่านี้ด้วยตนเอง

ย้าย routing แล้ว

ตอนนี้ AVA จัดการ kiosk routing ที่ Settings → Kiosk → Device Routing หน้า Room Access ยังคงเก็บการตั้งค่า encoder และชี้มาที่หน้านี้สำหรับ routing

ขั้นตอนที่ 5: ตั้งค่า kiosk routing (ไม่บังคับ)

ใช้ส่วนนี้เฉพาะเมื่อต้องการพฤติกรรม routing เฉพาะ kiosk:

1. ไปที่ Settings → Kiosk

2. เปิด Device Routing

3. เปิด Enable guest selection เพื่อให้ผู้เข้าพักเลือก encoder ที่ kiosk ได้

4. ปิดไว้หากต้องการเพิ่มกฎ routing สำหรับแต่ละ kiosk

5. AVA จะบันทึกกฎ kiosk เหล่านั้นกับ Mini MDM Device ID

6. device ID mapping รุ่นเก่าจะอัปเดตเองเมื่อคุณบันทึก

   ✓ เมื่อเปิด guest selection AVA จะซ่อนกฎ routing แบบ manual ⚠️ ยังต้องมี encoder device อย่างน้อยหนึ่งตัวใน Physical Encoder Devices ✓ AVA สามารถส่งคำขอเข้ารหัสด้วย encoderId โดยไม่ต้องมี kiosk mapping

พฤติกรรมการเลือก encoder ในการทำงาน

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

สถานะออนไลน์แบบสด

Online หมายถึง AVA ตรวจสอบ encoder และ agent tunnel แล้ว Unknown หมายถึง AVA ไม่สามารถตรวจสอบสถานะ encoder ได้ Unknown ไม่ได้ยืนยันว่า encoder ออฟไลน์ บรรทัด Status: จะแสดง online ต่อเมื่อการเชื่อมต่อนั้น live แล้ว หาก encoder หลุด offline ให้แก้ agent หรือ tunnel ก่อน

ขั้นตอนที่ 6: ตั้งค่า Windows Agent (เฉพาะ Windows Agent)

หากคุณไม่ได้เปิด Direct communication ให้ติดตั้ง Windows Agent:

1. ไปที่ Windows Agent

2. คลิก Download Windows Agent บนการ์ดใหม่ หรือ Reinstall บนการ์ดที่มีอยู่

3. ติดตั้ง agent บน Windows PC ที่เชื่อมต่อกับ encoder

4. หากการ์ดแสดง Not connected หรือ Never online ให้แตกไฟล์ zip ที่ดาวน์โหลดมา แล้วรัน download-installer.bat

5. เมื่อดาวน์โหลดเสร็จ ให้รันไฟล์ติดตั้ง .exe ที่บันทึกไว้

   ✓ agent จะปรากฏใต้ Registered Agents พร้อมรายละเอียดสถานะ ✓ AVA ใช้สถานะสดนี้เมื่อตัดสินว่า encoder ใช้ได้หรือไม่ ✓ การ์ดแต่ละใบจะแสดง Installed version และเมื่อมี Latest version ✓ หาก agent เป็นเวอร์ชันล่าสุด คุณจะเห็น Latest version installed ✓ หาก agent ล้าสมัย ให้คลิก Update ก่อน Reinstall

Be-Tech, Saflok, GreatLocks และ LockSDK ใช้ Windows Agent ได้ทั้งหมด สำหรับ GreatLocks ให้ทำขั้นตอนตั้งค่า agent ซ้ำสำหรับ encoder และ PC ที่เชื่อมต่อแต่ละชุด ตรวจสอบว่า agent แต่ละตัวใช้ Encoder ID ที่ตรงกัน เมื่อ agent ล้าสมัย Update จะปรากฏก่อน Reinstall บนการ์ดหลัก เปิด Advanced options เพื่อใช้ View Logs, Rotate Secret หรือ Delete Rotate Secret จะเปิดหน้าต่างยืนยันก่อนที่ AVA จะตัดการเชื่อมต่อ agent ปัจจุบัน

การควบคุม service

การกู้คืน Be-Tech โดยปกติจะเริ่ม client หรือ service ที่หยุดทำงานโดยอัตโนมัติ ใช้ Start, Stop หรือ Restart ใน Windows Agent tray เมื่อต้องการควบคุม service ด้วยตนเอง หาก Windows ขอสิทธิ์ ให้ยืนยันคำขอ UAC เพื่อดำเนินการต่อ หากคุณยกเลิกคำขอ ให้ทำซ้ำและยืนยันคำขอ

สิ่งที่เห็นเมื่อเวอร์ชันล้าสมัย

สิ่งที่เห็น: การ์ดแสดง Outdated หรือแจ้งว่า heartbeat ไม่ได้รายงานเวอร์ชันที่ติดตั้ง

วิธีแก้:

1. คลิก Update
2. อ่าน modal อัปเดต
3. เปิดแอป Windows Agent
4. คลิก Check for Update
5. ติดตั้งอัปเดตที่เสนอ
6. รีเฟรช Settings → Room Access และยืนยันว่าสถานะเวอร์ชันเป็นปัจจุบัน

สถานะเวอร์ชันเดียวกันนี้จะแสดงบนการ์ด agent ของ LockSDK ด้วย

ขั้นตอนที่ 7: ตั้งค่า default สำหรับการเข้ารหัส

1. ตั้ง Number of Cards to Encode (โดยทั่วไป 1–2)
2. ตั้ง Keycard Expiration Time (ค่าเริ่มต้น: 11:00 AM) เวลานี้จะเติมค่าใน Valid Until อัตโนมัติระหว่างการเข้ารหัส keycard แบบ manual

การจองแบบใช้ระหว่างวัน

หาก reservation ระบุเป็น day use อย่างชัดเจนและเปิดใช้ day use อยู่ AVA จะใช้เวลา checkout ที่แก้ไขแล้วแทน reservation แบบค้างคืนยังคงใช้ Keycard Expiration Time

ตัวเลือก: ขยาย Advanced options เพื่อเปิด Heartbeat Monitor

ตัวเลือก: จับคู่ห้อง PMS กับชื่อ encoder

หาก encoder ของคุณใช้ชื่อห้องต่างจาก PMS:

• ใช้ Keycard Room Mapping

การแก้ปัญหา

หาก encoder ไม่ตอบสนองหรือการ์ดเข้ารหัสไม่ผ่าน ให้ดู checklist ฉบับเต็ม:

• Keycard Encoder Troubleshooting

ยังติดปัญหาอยู่?

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

• ❌ บันทึกการตั้งค่า encoder ได้ แต่อุปกรณ์ยัง offline
• ❌ ไม่สามารถเข้ารหัสการ์ดสำหรับห้องใด ๆ ได้
• ❌ agent ไม่แสดง online ใน Registered Agents เลย

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

• ประเภทและรุ่นของ encoder
• ภาพหน้าจอ Keycard Encoder Settings
• เวลาที่ปัญหาเริ่มเกิดขึ้น

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

• Keycard Encoders Overview
• Keycard Room Mapping
• Keycard Guest Instructions
• Keycard Encoder Troubleshooting