ข้ามไปยังเนื้อหาหลัก

ตั้งค่า Keycard Encoders

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

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

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

สรุปอ้างอิง​

งานทำอะไรคลิกที่ไหน
Select methodเปิดใช้งาน keycard encodingRoom Access → Keycard Encoding
Choose encoder typeเลือกระบบล็อกของคุณEncoder Type
Choose connection methodDirect vs. Windows Agent (Saflok/Be-Tech/GreatLocks)Advanced options → Enable direct communication
Configure encoderเพิ่มเซิร์ฟเวอร์หรือข้อมูลรับรองช่องเฉพาะแต่ละประเภท
Add encodersลงทะเบียนอุปกรณ์จริงด้วย encoder ID จริงPhysical Encoder Devices
Choose kiosk routingควบคุมกฎ routing เฉพาะ kioskSettings → Kiosk → Device Routing
Download Windows Agentดาวน์โหลดแพ็กเกจเริ่มต้นของ agentWindows Agent
Check agent versionแสดงสถานะเวอร์ชันที่ติดตั้งและล่าสุดWindows Agent
Update agentเปิด modal คำแนะนำการอัปเดตUpdate
Manage agent cardsการ์ดหลักใช้ install, update หรือ reinstallWindows Agent
Advanced agent actionsดู logs, rotate secrets หรือ delete agentsAdvanced 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
    • URL ของ PMSI และการทดสอบการเชื่อมต่อจะจัดการโดย agent
    • AVA จะตรวจความพร้อมของ Saflok PMSI ซ้ำเรื่อย ๆ ดังนั้นการบูตช้าและการรีสตาร์ทมักจะกู้คืนได้เอง
  • เพิ่มอุปกรณ์ encoder ใน Physical Encoder Devices (ต้องมี Encoder ID)
  • ตัวเลือก: ตั้ง Location ให้แต่ละ encoder
  • หากหลาย kiosk แชร์ 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 ของคุณต้องใช้
    • หากบันทึก Base URL แล้ว AVA จะคงโหมด 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 นาที
    • สถานะอาจใช้เวลาสักครู่กว่าจะอัปเดตหลังรีสตาร์ท
    • หากไม่บันทึก Base URL AVA จะใช้ flow ของ Windows Agent
  • เพิ่ม encoder ใน Physical Encoder Devices
  • ตัวเลือก: เพิ่มกฎ Kiosk to Encoder Routing หากใช้ encoder หลายตัว
ถ้าคุณใช้ GreatLocks
  • Direct communication
    • กรอก Server Name (ไม่บังคับ), XHLSI Server IP Address, และ TCP Port
    • server ต้องเข้าถึงได้จากอินเทอร์เน็ต
    • GreatLocks รองรับ 1 encoder ต่อ 1 server
    • คลิก Test Connection
  • Windows Agent
    • agent จะจัดการรายละเอียด server ให้ ไม่ต้องกรอก IP/port
    • GreatLocks รองรับ 1 encoder ต่อ 1 server

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

ถ้าคุณใช้ LockSDK
  • Direct communication
    • เพิ่ม LockSDK encoder แต่ละตัวใน Physical Encoder Devices
    • กรอก Encoder ID และ Service URL สำหรับแต่ละตัว
    • คลิก Test Connection หลังเพิ่มรายการ encoder
  • Windows Agent
    • เพิ่ม LockSDK encoder แต่ละตัวใน Physical Encoder Devices
    • ลงทะเบียน Windows Agent 1 ตัวต่อ LockSDK encoder 1 ตัว
    • การ์ด agent จะแสดง encoder ที่จับคู่และสถานะสด
  • ตัวเลือก: เพิ่มกฎ Kiosk to Encoder Routing หากใช้ encoder หลายตัว
  • สำหรับ combined rooms, LockSDK รองรับได้สูงสุด 4 ห้อง และต้องใช้ RF50/Mifare lock type 5
ถ้าคุณใช้ PMS Integration
  • ต้องมี PMS integration ที่ active อยู่ (Cloudbeds หรือ Opera)
  • ใน Physical Encoder Devices ให้ทำอย่างใดอย่างหนึ่ง:
    • คลิก Load Encoders แล้ว Add Selected, หรือ
    • คลิก Add Encoder แล้วกรอก Encoder ID และ PMS Encoder ID
  • อุปกรณ์ที่โหลดจะเก็บ provider encoder ID ไว้โดยตรง
  • ใช้ Active เพื่อปิด encoder ที่ไม่ต้องการใช้

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

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

  1. เปิด Kiosk to Encoder Routing

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

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

  4. AVA จะบันทึกกฎ kiosk เหล่านี้ด้วย Mini MDM Device ID

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

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

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

  • ถ้ามี encoder ออนไลน์เพียงตัวเดียว AVA จะเลือกให้อัตโนมัติ
  • ถ้ามีหลายตัว พนักงานต้องเลือกเอง
สถานะออนไลน์แบบสด

Online หมายถึง encoder มีอุปกรณ์ที่ปกติดีและ agent tunnel เข้าถึงได้ บรรทัด 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 ได้ทั้งหมด เมื่อ agent ล้าสมัย Update จะปรากฏก่อน Reinstall บนการ์ดหลัก เปิด Advanced options เพื่อใช้ View Logs, Rotate Secret, หรือ Delete Rotate Secret จะเปิดหน้าต่างยืนยันก่อนที่ AVA จะตัดการเชื่อมต่อ agent ปัจจุบัน

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

สิ่งที่เห็น: การ์ดแสดง 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

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

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

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

การแก้ปัญหา​

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

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

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

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

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

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

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