ตั้งค่าเครื่องเข้ารหัสคีย์การ์ด

ตั้งค่าแบบรวดเร็ว

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

คู่มือนี้ช่วยคุณตั้งค่าการเข้ารหัสคีย์การ์ดแบบ encoder-first สำหรับใช้งานที่คีออสก์หรือฟรอนต์เดสก์ ตอนนี้รองรับการตั้งค่า Be-Tech แบบ Windows Agent ด้วย โดย Be-Tech จะใช้ Windows Agent เป็นค่าเริ่มต้น เว้นแต่คุณจะตั้ง Base URL แบบ direct ไว้แล้ว

ข้อมูลสรุป

งาน	สิ่งที่ทำ	คลิกที่ไหน
เลือกวิธี	เปิดใช้งานการเข้ารหัสคีย์การ์ด	Room Access → Keycard Encoding
เลือกประเภท encoder	เลือกระบบล็อกของคุณ	Encoder Type
เลือกวิธีเชื่อมต่อ	Direct หรือ Windows Agent สำหรับ Saflok/Be-Tech/GreatLocks	Advanced options → Enable direct communication
ตั้งค่า encoder	เพิ่มรายละเอียด server หรือ credential	ฟิลด์เฉพาะแต่ละชนิด
เพิ่ม encoder	ลงทะเบียนอุปกรณ์จริงด้วย encoder ID จริง	Physical Encoder Devices
เลือกการกำหนดเส้นทางของคีออสก์	ควบคุมกฎ routing เฉพาะคีออสก์	Kiosk to Encoder Routing → Enable guest selection
ดาวน์โหลด Windows Agent	ดาวน์โหลดชุดเริ่มต้นสำหรับ agent	Windows Agent
ตรวจเวอร์ชัน agent	แสดงสถานะเวอร์ชันที่ติดตั้งและล่าสุด	Windows Agent
อัปเดต agent	เปิดหน้าต่างคำแนะนำการอัปเดต	Update
จัดการการ์ด agent	การ์ดหลักจะแสดงการติดตั้ง อัปเดต หรือ reinstall	Windows Agent
การทำงานขั้นสูงของ agent	ดู logs หมุน secrets หรือลบ agent	Advanced options
กำหนดค่าเริ่มต้นการเข้ารหัส	จำนวนบัตรต่อการเข้าพัก + เวลาหมดอายุ	Encoding Options

ตำแหน่งเมนู

Settings → Room Access → Keycard Encoding

ขั้นตอนที่ 1: เลือกวิธีคีย์การ์ด

1. ไปที่ Settings → Room Access.
2. เลือก Keycard Encoding เป็นวิธีเข้าห้อง
3. คลิก Save

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

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

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

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

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

1. ใน Select Encoder Type เปิด Advanced options
2. สำหรับ Saflok, GreatLocks หรือ LockSDK ให้เปิด Enable direct communication หากต้องการข้าม Windows Agent
3. ปล่อยไว้ปิดหากต้องการใช้ Windows Agent ตามค่าเริ่มต้น
4. Be-Tech และ 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
  • ระบบจะจัดการ PMSI URL และการทดสอบการเชื่อมต่อผ่าน agent
  • AVA จะตรวจสอบความพร้อมของ Saflok PMSI ซ้ำเป็นระยะ ดังนั้นการบูตช้าและการรีสตาร์ทมักจะกลับมาทำงานได้เอง
• เพิ่มอุปกรณ์ encoder ใน Physical Encoder Devices (ต้องมี Encoder ID)
• ไม่บังคับ: ตั้ง Location สำหรับ encoder แต่ละตัว
• หากหลายคีออสก์แชร์ encoder เดียวกัน ให้เพิ่มกฎ Kiosk to Encoder Routing (Kiosk IDs มาจาก Kiosk Management)

หากคุณใช้ Be-Tech

• Direct communication
  • กรอก Base URL สำหรับบริการ Be-Tech
  • บริการต้องเข้าถึงได้จากอินเทอร์เน็ต
  • กรอก Hotel Name, Chain No, Workstation และ Reader No
  • ตั้ง Category และ Card Type หากการตั้งค่า Be-Tech ของคุณต้องใช้
  • คลิก Test Connection เพื่อยืนยันว่า encoder ตอบสนอง
• Windows Agent
  • กรอก Hotel Name, Chain No, Workstation และ Reader No
  • agent จะจัดการ base URL และการทดสอบการเชื่อมต่อ
• เพิ่มอุปกรณ์ encoder ใน Physical Encoder Devices
• ไม่บังคับ: เพิ่มกฎ Kiosk to Encoder Routing หากคุณใช้ encoder หลายตัว

หากคุณใช้ GreatLocks

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

หมายเหตุ: AVA ใช้ระเบียน GreatLocks server ที่คุณบันทึกใน Room Access หากคุณอัปเดตการตั้งค่าเก่า ให้คลิก Save ก่อน Test Connection

หากคุณใช้ 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 ที่ตรงกันและสถานะแบบสด
• ไม่บังคับ: เพิ่มกฎ Kiosk to Encoder Routing หากคุณใช้ encoder หลายตัว
• สำหรับห้องแบบรวม LockSDK รองรับได้สูงสุด 4 ห้อง และต้องใช้ RF50/Mifare lock type 5

หากคุณใช้ PMS Integration

• ตรวจว่ามี PMS integration ที่ใช้งานอยู่แล้ว (Cloudbeds หรือ Opera)
• ใน Physical Encoder Devices ทำได้สองแบบ:
  • คลิก Load Encoders แล้ว Add Selected หรือ
  • คลิก Add Encoder แล้วกรอก Encoder ID และ PMS Encoder ID
• อุปกรณ์ที่โหลดเข้ามาจะเก็บ provider encoder ID โดยตรง
• ใช้ Active เพื่อปิด encoder ที่คุณไม่ต้องการใช้งาน

ขั้นตอนที่ 5: ตั้ง routing สำหรับคีออสก์ (ไม่บังคับ)

ใช้ส่วนนี้เฉพาะเมื่อต้องการควบคุม routing เฉพาะคีออสก์:

1. เปิด Kiosk to Encoder Routing

2. เปิด Enable guest selection หากต้องการให้ผู้เข้าพักเลือก encoder ที่คีออสก์ได้

3. ปล่อยไว้ปิดหากต้องการเพิ่มกฎ Kiosk to Encoder Routing สำหรับแต่ละคีออสก์

4. AVA จะบันทึกกฎคีออสก์เหล่านั้นลงใน Mini MDM Device ID

5. หากมีการแม็ป device ID แบบเก่าอยู่ ระบบจะอัปเดตให้อัตโนมัติเมื่อบันทึก

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

พฤติกรรมการเลือก encoder ใน operations

• หากมี encoder ออนไลน์เพียงหนึ่งตัว AVA จะเลือกให้อัตโนมัติ
• หากมี encoder ออนไลน์หลายตัว พนักงานต้องเลือกเอง

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

Online หมายถึง encoder มีอุปกรณ์ที่ทำงานปกติและ agent tunnel เข้าถึงได้ บรรทัด Status: จะแสดง online ก็ต่อเมื่อการเชื่อมต่อนั้นพร้อมใช้งานแล้ว หาก encoder หลุดออฟไลน์ ให้แก้ agent หรือ tunnel ก่อน

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

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

1. ไปที่ Windows Agent

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

3. ติดตั้ง agent บนเครื่อง Windows ที่ต่อกับ 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

เมื่อ agent ล้าสมัย ปุ่ม Update จะปรากฏก่อน Reinstall บนการ์ดหลัก เปิด Advanced options สำหรับ View Logs, Rotate Secret หรือ Delete

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

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

วิธีแก้:

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

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

ขั้นตอนที่ 7: ตั้งค่าเริ่มต้นของการเข้ารหัส

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

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

ไม่บังคับ: แม็ปห้อง PMS กับชื่อ encoder

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

• ใช้ Keycard Room Mapping

การแก้ไขปัญหา

หาก encoder ไม่ตอบสนองหรือการ์ดเข้ารหัสไม่สำเร็จ ให้ใช้เช็กลิสต์ฉบับเต็ม:

• แก้ไขปัญหาเครื่องเข้ารหัสคีย์การ์ด

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

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

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

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

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

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

• ภาพรวมเครื่องเข้ารหัสคีย์การ์ด
• การแม็ปห้องสำหรับคีย์การ์ด
• คำแนะนำคีย์การ์ดสำหรับผู้เข้าพัก
• แก้ไขปัญหาเครื่องเข้ารหัสคีย์การ์ด