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

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

แก้ไขด่วน

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

คู่มือนี้ช่วยให้คุณแก้ปัญหาที่พบบ่อยของเครื่องเข้ารหัสคีย์การ์ดได้

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

สิ่งที่เห็นสาเหตุวิธีดำเนินการ
เครื่องเข้ารหัสไม่ตอบสนองปัญหาไฟหรือเครือข่ายตรวจการเชื่อมต่อ
"We could not determine the room for this reservation."PMS ไม่พบห้องที่ใช้ได้ลองแก้ไขห้องใหม่
สถานะการเข้าพักของห้องแสดง Unknown หรือถูกบล็อกการเข้ารหัสคีย์การ์ดAVA ตรวจสอบสถานะการเข้าพักของห้องที่กำหนดไว้โดยตรงไม่ได้รีเฟรชสถานะห้องที่กำหนด
การจองที่เชื่อมโยงยังเข้ารหัสไม่ได้หมายเลขยืนยันที่เลือกหายไป ไม่ชัดเจน หรือไม่ผ่านการตรวจสอบของ PMSตรวจการจองที่เลือก
การ์ดไม่ถูกเข้ารหัสปัญหาประเภทการ์ดหรืออุปกรณ์ตรวจการ์ดและอุปกรณ์
ข้อผิดพลาดคีย์การ์ดแบบภาษาทั่วไปAVA ปรับข้อผิดพลาดของผู้ให้บริการ ห้อง หรือเซสชันเป็นมาตรฐานอ่านข้อความ
"Invalid Saflok configuration" หรือ "UserCredentialsNotProvided.NotApplicable"ข้อมูลรับรอง Saflok หายไป ไม่ครบ หรือถูกปิดใช้งานแก้การตั้งค่า Saflok
Saflok/Ambiance ล้มเหลวหรือหมดเวลาWindows Agent, Ambiance encoder service หรืออุปกรณ์ออฟไลน์รีสตาร์ท Saflok/Ambiance
"Please create a new keycard first, then use Duplicate for any extra cards."Saflok ไม่พบการลงทะเบียนที่ใช้งานอยู่แก้คีย์การ์ดใบแรก
ผู้แชร์ที่มาถึงภายหลังได้รับการ์ดใบแรกเป็น DUPLICATEมีผู้เข้าพักอีกคนอยู่ในห้องแล้วคงการ์ดของผู้เข้าพักเดิมไว้
การ์ดหลายห้องต้องมี ID ระดับห้องห้องที่เลือกยังไม่มี sub-reservationตรวจห้องที่เลือก
"The keycard encoder is temporarily offline. Please approach the Front Desk for assistance."ไม่มีเซสชันที่ใช้งานอยู่ตรวจเซสชัน
การเข้ารหัสหยุดหลังย้ายห้องใน PMSห้องเปลี่ยนระหว่างที่เซสชันคีย์การ์ดยังเปิดอยู่รีเฟรชและเริ่มการเข้ารหัสใหม่
มี DoorLock generate fail หรือ internal errorpayload ทางเทคนิคหลุดมาในโมดัลใช้ขั้นตอนลองใหม่
"Request timezone does not match the hotel timezone" หรือ "Hotel timezone configuration is invalid"เขตเวลาของโรงแรมหายไป ไม่ถูกต้อง หรือขัดแย้งกับข้อมูลเมทาดาทาของคำขอตรวจเขตเวลาของโรงแรม
เปลี่ยนประเภทเครื่องเข้ารหัสไม่คงอยู่สถานะจากการบันทึกครั้งก่อนปะปนกันบันทึกใหม่
"Test Connection" ล้มเหลว (Be-Tech)ปัญหา Base URL, adapter หรือ serviceแก้การเชื่อมต่อ Be-Tech
ไคลเอนต์ Be-Tech หยุดหลังรีสตาร์ทagent กำลังกู้คืนไคลเอนต์รอการกู้คืน
"Make sure the Be-Tech client program is running on the encoder computer."Windows Agent ได้รับ 502ตรวจโปรแกรม Be-Tech
"Test Connection" ล้มเหลว (GreatLocks)รายละเอียดเซิร์ฟเวอร์หายหรือล้าสมัยแก้ GreatLocks
GreatLocks ขอให้เลือกเครื่องเข้ารหัสมีเซิร์ฟเวอร์หรือ agent หลายรายการเลือกเครื่องเข้ารหัส
โหลดรายการ GreatLocks ไม่ได้tunnel หรือแหล่งรายการเข้าถึงไม่ได้ตรวจการซิงค์รายการ
การค้นหาเครื่องเข้ารหัส PMS ไม่มีผลลัพธ์PMS ไม่ตรงหรือไม่แสดงเทอร์มินัลตรวจการค้นหา PMS
route ของ Opera ไม่ชัดเจนหรือไม่ครบรายละเอียด Door Lock ซ้ำหรือหายแก้ route Opera
พบ "OPERAWS-FOF01920" ระหว่างอ่านส่งค่า interface เก่าหรือไม่ถูกต้องรีเฟรช route
พบ "OPERAWS-FOF00199" ระหว่างอ่านOpera ติดต่อ Door Lock System ไม่ได้ตรวจการเชื่อมต่อ
อ่านการ์ด PMS ไม่ได้การตั้งค่า ความสามารถ หรือเครื่องเข้ารหัสมีปัญหาตรวจการอ่าน PMS
ตรวจไม่พบการ์ดเครื่องอ่านไม่พบการ์ดใส่การ์ดใหม่
ไม่รองรับประเภทการ์ดเครื่องเข้ารหัสไม่รู้จักประเภทการ์ดใช้การ์ดที่รองรับ
อ่านการ์ดไม่ได้เครื่องเข้ารหัสอ่านข้อมูลไม่ได้ลองการ์ดใบอื่น
Opera แสดงข้อผิดพลาดทั่วไปOpera ส่งการตอบกลับว่างหรือไม่ถูกต้องตรวจการตอบกลับ
แก้การแมปเครื่องเข้ารหัส kiosk ของ PMS ไม่ได้การแมปสองแบบใช้ป้ายกำกับต่างกันตรวจการแมป
ขอให้ยืนยัน kiosk หรือเครื่องเข้ารหัสบริบท kiosk ที่บันทึกไว้ การยืนยันเจ้าหน้าที่ หรือการตั้งค่าเป้าหมายเปลี่ยนแปลงยืนยันเป้าหมาย kiosk
"Service URL is required" (LockSDK)โหมด direct ต้องมี Service URLเพิ่ม Service URL
LockSDK แสดง Not registeredยังไม่มีอุปกรณ์ agentลงทะเบียน agent
Heartbeat Monitor ปิดหลังบันทึกการตั้งค่าไม่คงอยู่ใน sessionบันทึกใหม่
Heartbeat แสดง unreachableagent ออฟไลน์หรือ tunnel มีปัญหาตรวจ agent
Heartbeat แสดง unknownAVA ตรวจสอบสถานะไม่ได้ตรวจสถานะ
Heartbeat รายงานข้อผิดพลาดการตรวจวินิจฉัยหรือ tunnel ล้มเหลวตรวจข้อผิดพลาด
Google Chat รายงานปัญหาเครื่องเข้ารหัสเครื่องเข้ารหัสล้มเหลวชั่วคราว กู้คืนแล้ว หรือยังใช้งานไม่ได้ทำตามการแจ้งเตือน
เครื่องเข้ารหัสยังใช้งานไม่ได้รายการแบบไดนามิกเห็น agent ขาดการเชื่อมต่อตรวจสถานะสด
Windows Agent แสดง Not connectedagent ไม่ทำงานหรือติดตั้งไม่ครบเชื่อมต่อใหม่
Windows Agent เก่าเกินไปไม่มี Read Keycardอัปเดต agent
tunnel เครื่องเข้ารหัสออฟไลน์tunnel ของ Universal Encoder Agent ใช้ไม่ได้เชื่อมต่อ tunnel ใหม่
Windows ขอสิทธิ์ต้องยกระดับสิทธิ์ควบคุม serviceอนุมัติ UAC

แก้ไขห้องของการจองไม่ได้​

สิ่งที่เห็น: หลังเลือกเครื่องเข้ารหัส AVA แสดง "We could not determine the room for this reservation."

สาเหตุ: การค้นหา PMS ที่ยืนยันตัวตนไม่พบข้อมูลระบุตัวห้องที่ใช้ได้

วิธีแก้:

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

AVA ยอมรับข้อมูลระบุตัวห้อง PMS ที่ถูกต้อง รวมถึงตัวระบุ PMS ของ AVA ที่ยาว อย่าตัดทอนหรือแก้ไขข้อมูลระบุตัวห้อง PMS เอง

ไม่ทราบสถานะการเข้าพักของห้องที่กำหนด​

สิ่งที่เห็น: สถานะการเข้าพักของห้องแสดง Unknown หรือ AVA บล็อกการเข้ารหัสคีย์การ์ด

สาเหตุ: AVA ตรวจสอบสถานะการเข้าพักของห้องที่กำหนดไว้โดยตรงไม่ได้ ระบบจะไม่ใช้สถานะห้องอื่นที่มีผู้เข้าพักแทนห้องนี้

วิธีแก้:

  1. ยืนยันว่าการจองมีห้องที่กำหนดถูกต้องใน PMS

  2. ยืนยันว่าห้องนั้นเป็นของการจองที่เลือก ไม่ใช่การจองที่เชื่อมโยงกัน

  3. รีเฟรชการจองหรือ Operations View ใน AVA

  4. เริ่มขั้นตอนคีย์การ์ดอีกครั้งหลังจากเห็นการอัปเดตจาก PMS

  5. ติดต่อฝ่ายสนับสนุนหากสถานะการเข้าพักยังเป็น unknown หลังรีเฟรชหนึ่งครั้ง

    ✓ AVA ควรเข้ารหัสหลังจากยืนยันสถานะการเข้าพักของห้องที่กำหนดแล้วเท่านั้น

ตรวจสอบห้องของการจองที่เชื่อมโยงไม่ได้​

สิ่งที่เห็น: ห้องรองในการจองที่เชื่อมโยงกันยังเข้ารหัสไม่ได้

สาเหตุ: หมายเลขยืนยันของห้องที่เลือกหายไปหรือไม่ตรงกับห้องใน PMS การอ่านข้อมูล PMS ต้นทางอาจล้มเหลว หรือส่งห้องที่เป็นไปได้กลับมามากกว่าหนึ่งห้อง

วิธีแก้:

  1. ยืนยันห้องที่เลือกและหมายเลขยืนยันใน PMS
  2. รีเฟรชการจองหรือ Operations View ใน AVA
  3. เปิดห้องที่เลือกอีกครั้งแล้วลองเข้ารหัสคีย์การ์ด
  4. อย่าใช้หมายเลขห้องเก่าเพื่อเลือกการจองที่เชื่อมโยงกัน
  5. ติดต่อฝ่ายสนับสนุนหากการตอบกลับจาก PMS ยังไม่ชัดเจนหรือไม่พร้อมใช้งาน

AVA ตรวจสอบการจองที่เลือกก่อนเข้ารหัส ระบบจะบล็อกห้องที่ย้ายแล้ว เช็กเอาต์แล้ว หรือเป็นห้องพี่น้องที่ไม่ถูกต้อง แทนการออกการ์ดที่ไม่ปลอดภัย

การย้ายห้องยังแสดงสถานะคีย์การ์ดเดิม​

สิ่งที่เห็น: ห้องเปลี่ยนระหว่างการเข้ารหัส หรือ AVA แสดงสถานะคีย์การ์ดเดิม

สาเหตุ: การกำหนดห้องใน PMS เปลี่ยนไปหลังจากเปิดเซสชันคีย์การ์ด AVA จะบล็อกคำขอที่ล้าสมัยก่อนเรียกเครื่องเข้ารหัสจริง

วิธีแก้:

  1. ยืนยันการกำหนดห้องใหม่ใน PMS

  2. รอให้ AVA รีเฟรชการจองหลังพบความขัดแย้ง

  3. เปิดการดำเนินการคีย์การ์ดอีกครั้งหลังเซสชันเข้ารหัสเดิมปิดลง

  4. ยืนยันหมายเลขห้องที่รีเฟรชแล้วก่อนเข้ารหัส

  5. เลือก NEW สำหรับการ์ดใบแรกในห้องใหม่

  6. เลือก DUPLICATE สำหรับการ์ดเพิ่มเติมในห้องนั้น

    ✓ ความพยายามที่ล้าสมัยจะไม่เรียกเครื่องเข้ารหัส ✓ ห้องที่รีเฟรชแล้วต้องเริ่มการดำเนินการของผู้เข้าพักใหม่

อย่าคลิก Try Again ซ้ำในเซสชันที่ปิดไปแล้ว หากการรีเฟรชล้มเหลว AVA จะปิดเซสชันและแสดงข้อผิดพลาด ให้รีเฟรชการจองด้วยตนเอง แล้วเปิดการดำเนินการคีย์การ์ดอีกครั้ง

AVA ยังคงการยืนยันผู้เข้าพักและประวัติคีย์การ์ดก่อนหน้าไว้ ระบบจะไม่นำสถานะเสร็จสมบูรณ์ของห้องเดิมมาใช้กับการกำหนดห้องใหม่ หาก PMS แสดงว่ายังไม่มีห้องชั่วคราว ให้รอการกำหนดห้องใหม่ รีเฟรช แล้วลองอีกครั้ง

ผู้แชร์ที่มาถึงภายหลังได้รับการ์ดซ้ำ​

สิ่งที่เห็น: ผู้แชร์มาถึงภายหลังผ่าน ACI ในการจองเดียวกัน AVA ขอการ์ดแบบ DUPLICATE แม้ผู้แชร์คนนั้นจะยังไม่เคยได้รับการ์ดมาก่อน

สาเหตุ: มีผู้เข้าพักอีกคนจากการจองเดียวกันอยู่ในห้องแล้ว AVA ป้องกันไม่ให้การ์ดของผู้เข้าพักที่อยู่ในห้องถูกยกเลิกด้วยการ์ดใบใหม่

วิธีแก้:

  1. ยืนยันว่าผู้แชร์ใช้ห้องเดียวกับผู้เข้าพักที่อยู่ในห้องแล้ว
  2. ให้ AVA ดำเนินการต่อด้วย DUPLICATE
  3. อย่าเปลี่ยนคำขอเป็น NEW ขณะที่ยังมีผู้เข้าพักอีกคนอยู่ในห้อง
  4. หากเครื่องเข้ารหัสปฏิเสธการ์ดซ้ำ ให้ทำตามคำแนะนำข้อผิดพลาดที่แสดง
  5. รีเฟรชการจองแล้วลองอีกครั้งหนึ่ง หากข้อผิดพลาดเป็นเพียงชั่วคราว
  6. ติดต่อฝ่ายสนับสนุนหากเครื่องเข้ารหัสยังคงปฏิเสธการ์ด
การตัดสินใจของการมาถึงปัจจุบัน

ผู้เข้าพักที่เช็กอินตามการตัดสินใจของการมาถึงปัจจุบันยังใช้พฤติกรรมการ์ดใบแรกตามปกติ ผู้ที่มาถึงก่อนหน้าในการจองเดียวกันจะถือเป็นผู้เข้าพักที่อยู่ในห้องแล้ว

เครื่องเข้ารหัสไม่ตอบสนอง​

สิ่งที่เห็น: เครื่องเข้ารหัสออฟไลน์หรือไม่ตอบสนองใน AVA

วิธีแก้:

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

การ์ดไม่ถูกเข้ารหัส​

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

วิธีแก้:

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

ข้อผิดพลาดการเข้ารหัสแบบมาตรฐาน​

สิ่งที่เห็น: โมดัลแสดงข้อความภาษาทั่วไปแทนข้อความดิบของผู้ให้บริการ

สาเหตุ: AVA จะจัดเก็บข้อผิดพลาดของ Saflok, Be-Tech, Opera และเซสชันภายในในรูปแบบมาตรฐานก่อนแสดง ระบบจะใช้ข้อความที่มีโครงสร้างก่อน แล้วจึงย้อนกลับไปแยกวิเคราะห์ข้อความของผู้ให้บริการแบบเดิมเมื่อจำเป็น การหมดเวลาของ room access แบบ HTTP 504 จะอยู่ในเส้นทางเดียวกันนี้ด้วย KEYCARD_VENDOR_TIMEOUT การแจ้งเตือนเจ้าหน้าที่และรายละเอียด log ที่เกี่ยวข้องจะใช้หมวดหมู่ข้อผิดพลาดมาตรฐานเดียวกัน ตัวอย่างเช่น ข้อผิดพลาดขณะมีการ์ดอยู่จะไม่ถูกรายงานเป็น No card detected

วิธีแก้:

  1. อ่านข้อความสั้นก่อน
  2. ตรวจ userMessage, errorCode, retriable, ชื่อผู้ให้บริการ และ upstream ในหน้าสนับสนุน
  3. ใช้ข้อมูลเหล่านี้เมื่อติดต่อฝ่ายสนับสนุน
  4. จับคู่ข้อความกับวิธีแก้ที่เป็นไปได้มากที่สุดด้านล่าง:
    • Occupied room: รีเฟรชการจองแล้วลองใหม่
    • Encoder offline: ตรวจไฟ เครือข่าย หรือ agent
    • No card detected: ใส่การ์ดใหม่และจัดตำแหน่ง
    • Unsupported card type: ใช้ประเภทการ์ดที่รองรับ
    • Card could not be read: ลองการ์ดอื่นและตรวจความเสียหาย
    • No active session: เชื่อมต่อเซสชันใหม่
    • Missing mapping: ตรวจการแมปห้อง
    • Invalid room or date: ตรวจวันที่และห้อง
    • Vendor auth, gateway, or timeout: ตรวจการเข้าถึงหรือลองใหม่ภายหลัง
    • HTTP 504 timeout: รอสั้น ๆ แล้วลองใหม่
    • Invalid request: เปิดการจองที่ถูกต้องแล้วลองใหม่
  5. หาก retriable เป็น true ให้รีเฟรชแล้วลองใหม่
  6. หาก retriable เป็น false ให้แก้การแมปหรือปัญหาผู้ให้บริการก่อน
ยังคงมีการย้อนกลับแบบเดิม

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

เขตเวลาของ Opera ไม่ตรงกัน​

สิ่งที่เห็น: ขั้นตอนคีย์การ์ดหยุดก่อน PMS ส่งคีย์ห้อง คุณอาจเห็น "Request timezone does not match the hotel timezone" หรือ "Hotel timezone configuration is invalid."

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

วิธีแก้:

  1. ไปที่ Settings → Essentials → Hotel Basic Details
  2. ยืนยันว่า Timezone ถูกต้องและตรงกับเวลาท้องถิ่น
  3. บันทึกหากแก้ไข
  4. รีเฟรชการจองหรือเปิดขั้นตอนใหม่
  5. ลองส่งคำขออีกครั้ง

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

การเข้ารหัส Saflok/Ambiance ไม่ทำงาน​

สิ่งที่เห็น: การเข้ารหัสล้มเหลว หมดเวลา หรือ kiosk ไม่ได้รับการตอบกลับ

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

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

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

1. ตรวจ Windows Agent ใน AVA​

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

  2. หา card Windows Agent ของเครื่องนี้

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

    Windows Agent แสดง Connected พร้อมเวลา Last Seen ล่าสุด

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

2. ตรวจเครื่องเข้ารหัสออนไลน์ใน Ambiance​

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

  1. เปิด Ambiance ไปที่ Device Management → Encoders

  2. หาเครื่องของ kiosk นี้ เช่น encoder Vouch

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

    Ambiance Device Management แสดง Status ของเครื่องเข้ารหัสเป็น Online

  4. หากเครื่องเข้ารหัสเป็น Offline ให้ดำเนินการต่อที่ขั้นตอนที่ 3 เพื่อรีสตาร์ทบริการเครื่องเข้ารหัส

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

หากเครื่องเข้ารหัสออฟไลน์ใน Ambiance ให้รีสตาร์ท service บนคอมพิวเตอร์ที่ติดตั้ง Ambiance server

  1. กด Windows หรือคลิกเมนู Start

  2. พิมพ์ services manager แล้วเปิด Ambiance Services Manager จากผลการค้นหา

  3. เลือก Ambiance Encoder Service

    Ambiance Services Manager โดยเลือก Ambiance Encoder Service ไว้

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

  5. รอสองสามวินาทีจนสถานะ service เปลี่ยนเป็น Stopped

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

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

  8. กลับไปที่ Ambiance Device Management → Encoders และยืนยันว่าเครื่องเข้ารหัสเป็น Online

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

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

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

Duplicate keycard ของ Saflok ต้องมีใบแรก​

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

สาเหตุ: Saflok ไม่พบการลงทะเบียนหรือระเบียนคีย์การ์ดที่ใช้งานอยู่สำหรับการจองนี้ ข้อผิดพลาดนี้เกิดขึ้นเมื่อ Saflok ปฏิเสธการ์ด Duplicate ที่ร้องขอ

สำหรับผู้แชร์ที่มาถึงภายหลัง AVA อาจตั้งใจขอ DUPLICATE เพื่อปกป้องผู้เข้าพักอีกคนที่อยู่ในห้องแล้ว อย่าเปลี่ยนเป็น NEW โดยไม่ยืนยันว่าไม่มีผู้เข้าพักเหลืออยู่ในห้อง

วิธีแก้:

  1. ยืนยันว่ามีผู้เข้าพักอีกคนอยู่ในห้องแล้วหรือไม่
  2. หากมี ให้รีเฟรชการจองแล้วลองคำขอ DUPLICATE อีกครั้งหนึ่ง
  3. หากไม่มี ให้สร้างคีย์การ์ดใบแรกสำหรับการจอง
  4. รอให้การเข้ารหัสใบแรกเสร็จสมบูรณ์
  5. เลือก Duplicate หลังจากมีคีย์การ์ดใบแรกแล้วเท่านั้น
  6. หากข้อผิดพลาดกลับมา ให้ยืนยันว่าการจองยังมีการลงทะเบียนที่ใช้งานอยู่ใน Ambiance
  7. ติดต่อฝ่ายสนับสนุนหากเครื่องเข้ารหัสยังคงปฏิเสธประเภทการ์ดที่ถูกต้อง
สิ่งที่ไม่ควรเห็น

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

คีย์การ์ดหลายห้องต้องมี reservation ID ระดับห้อง​

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

สาเหตุ: การ์ด Duplicate ของ Saflok/Ambiance ใช้ sub-reservation ID ของห้องที่เลือก หากห้องนั้นยังไม่มี ID ของตนเอง ระบบจะแสดงข้อผิดพลาดทันที

วิธีแก้:

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

เครื่องเข้ารหัสไม่มีเซสชัน​

สิ่งที่เห็น: AVA แสดง "The keycard encoder is temporarily offline. Please approach the Front Desk for assistance."

สาเหตุ: เครื่องเข้ารหัสไม่มีเซสชันที่ใช้งานอยู่ AVA จึงถือเป็นปัญหาความพร้อมแบบออฟไลน์

วิธีแก้:

  1. ยืนยันว่าเครื่องเข้ารหัสเปิดอยู่และเชื่อมต่อแล้ว
  2. รีเฟรช Settings → Room Access → Keycard Encoding
  3. ตรวจสอบว่าเครื่องเข้ารหัสแสดง Online หรือ Connected
  4. ลองเข้ารหัสอีกครั้งหลังเซสชันเชื่อมต่อใหม่
  5. หากยังล้มเหลว ให้ใช้เครื่องเข้ารหัสอื่นหรือติดต่อฝ่ายสนับสนุน

payload room access แบบดิบแสดงในโมดัล​

สิ่งที่เห็น: โมดัลแสดง DoorLock generate fail! หรือ internal error

สาเหตุ: AVA ตรวจพบข้อมูลทางเทคนิคของ room access ระบบจะย้อนกลับไปใช้ข้อความทั่วไปสำหรับการลองใหม่ แทนการแสดง payload ดิบ

วิธีแก้:

  1. ปิดโมดัล
  2. รอสองสามวินาที
  3. ลองเข้ารหัสคีย์การ์ดอีกครั้ง
  4. หากข้อความเดิมกลับมา ให้ยืนยันว่าเครื่องเข้ารหัสออนไลน์
  5. หากยังล้มเหลว ให้เปลี่ยนไปใช้เครื่องเข้ารหัสอื่นหรือติดต่อฝ่ายสนับสนุน

ไม่ได้ระบุข้อมูลรับรอง Saflok​

สิ่งที่เห็น: AVA แสดง "Invalid Saflok configuration" ระหว่างการเข้ารหัสคีย์การ์ด คุณอาจเห็น "Saflok credentials not configured", "Saflok configuration incomplete" หรือ "Saflok encoder is disabled" การตอบกลับจาก agent รุ่นเก่าอาจแสดง "UserCredentialsNotProvided.NotApplicable"

สาเหตุ: Saflok ไม่สามารถเริ่มทำงานด้วยการตั้งค่าที่บันทึกไว้ได้ AVA จัดข้อผิดพลาดนี้เป็น CREDENTIAL_CONFIG_INVALID และ ไม่สามารถลองใหม่ได้ ให้แก้การตั้งค่าก่อนลองใช้การ์ดใบเดิมอีกครั้ง

วิธีแก้:

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

การสื่อสาร direct ต้องมี PMSI Server URL, Username และ Password โหมด Windows Agent ยังคงต้องมี Username และ Password agent จะจัดการการเชื่อมต่อ PMSI ให้

ประเภทเครื่องเข้ารหัสเปลี่ยนแล้วไม่คงอยู่​

สิ่งที่เห็น: คุณเลือกประเภทเครื่องเข้ารหัสหนึ่งประเภท แต่อีกเครื่องยังคง active อยู่

วิธีแก้:

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

การค้นหาเครื่องเข้ารหัส PMS ไม่มีผลลัพธ์​

สิ่งที่เห็น: คลิก Load Encoders แล้ว AVA ไม่แสดงเทอร์มินัล PMS

สาเหตุ: การตั้งค่าผู้ให้บริการ PMS ไม่ตรงกับที่พัก หรือ PMS ไม่ได้เปิดเผยเทอร์มินัลเครื่องเข้ารหัส

วิธีแก้:

  1. ไปที่ Settings → Room Access → Keycard Encoding
  2. ยืนยันว่า PMS vendor ตรงกับที่พัก
  3. คลิก Save อีกครั้ง
  4. กลับไป Physical Encoder Devices แล้วคลิก Load Encoders
  5. หากยังว่าง ให้ตรวจว่าการเชื่อมต่อ PMS ทำงาน
  6. หาก PMS ยังไม่แสดงเทอร์มินัล ให้ติดต่อฝ่ายสนับสนุนพร้อมชื่อผู้ให้บริการและชื่อที่พัก

อ่านการ์ด PMS ไม่ได้​

สิ่งที่เห็น: Entitlements ไม่แสดง Start scanning หรือแจ้งว่าอ่านคีย์การ์ดจริงไม่ได้

สาเหตุ: ปิดการอ่านอยู่, PMS adapter ไม่รองรับ หรือการค้นหาความสามารถใช้ไม่ได้ชั่วคราว การอ่านการ์ด PMS ยังต้องมีเครื่องเข้ารหัส PMS ที่ active ด้วย

วิธีแก้:

  1. ไปที่ Settings → Room Access → Keycard Encoding
  2. เลือก PMS Integration
  3. เปิด Enable PMS Encoder Integration
  4. ยืนยันผู้ให้บริการ PMS
  5. ยืนยันเครื่องที่ค้นพบเป็น Active
  6. เปิด Enable physical keycard reading แล้วคลิก Save
  7. โหลด Entitlements ใหม่และตรวจ Start scanning
  8. ใช้ Look up by room หรือ Look up by confirmation number ไปก่อน

การอ่านการ์ด PMS ใช้การขนส่งข้อมูลของ PMS โดยตรง และไม่ต้องใช้เซสชัน Universal Encoder Agent หากคำเตือนยังอยู่ PMS adapter ของคุณอาจยังไม่ได้แจ้งว่ารองรับการอ่าน

route ของ Opera ไม่ชัดเจนหรือไม่ครบ​

สิ่งที่เห็น: อ่านการ์ด Opera ไม่ได้หลังโหลดเครื่องเข้ารหัส

สาเหตุ: Opera ส่งรายละเอียด workstation, encoder, interface หรือ outbound-code ซ้ำหรือไม่ครบ AVA จะหยุดอย่างปลอดภัยแทนการส่งคำขออ่านการ์ดไปยัง Door Lock route ที่ไม่ถูกต้อง

วิธีแก้:

  1. ไปที่ Settings → Room Access → Keycard Encoding
  2. ยืนยัน PMS vendor เป็น Opera
  3. ยืนยันเครื่องที่ต้องการเป็น Active
  4. คลิก Load Encoders แล้ว Add Selected เมื่อพบเทอร์มินัลที่ถูกต้อง
  5. ขอให้ผู้ดูแล Opera แก้รายละเอียด Door Lock interface ที่ซ้ำหรือขาดหาย
  6. โหลด Entitlements ใหม่หลังแก้แค็ตตาล็อกเครื่องเข้ารหัสแล้ว
  7. ระหว่างนี้ใช้ Look up by room หรือ Look up by confirmation number

ติดต่อฝ่ายสนับสนุนหาก route ยังใช้ไม่ได้หลัง Opera ยืนยันว่ามี route ที่ถูกต้องเพียงหนึ่งรายการ

ข้อผิดพลาดการตรวจสอบ interface ของ Opera​

สิ่งที่เห็น: พบ OPERAWS-FOF01920 หรือข้อผิดพลาดตรวจสอบหมายเลข interface

สาเหตุ: Opera ปฏิเสธค่า interface ของคำขอ อาจเกิดขึ้นเมื่อ route เก่ายังคงถูกแคชไว้หลังรายละเอียดเครื่องเข้ารหัสเปลี่ยนแปลง

วิธีแก้:

  1. ไปที่ Settings → Room Access → Keycard Encoding
  2. ยืนยันว่า workstation และ encoder ID ของเครื่องเข้ารหัส Opera ตรงกับอุปกรณ์จริง
  3. คลิก Load Encoders แล้ว Add Selected สำหรับเทอร์มินัลปัจจุบัน
  4. ยืนยันว่าเครื่องเข้ารหัสเป็น Active
  5. โหลด Entitlements ใหม่ แล้วลอง Start scanning อีกครั้ง
  6. ใช้ Look up by room หรือ Look up by confirmation number หากยังสแกนไม่ได้

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

ติดต่อฝ่ายสนับสนุนหาก OPERAWS-FOF01920 กลับมาอีกหลังโหลดเครื่องเข้ารหัสปัจจุบันใหม่

หมดเวลาติดต่อ Opera Door Lock System​

สิ่งที่เห็น: พบ OPERAWS-FOF00199 หรือหมดเวลาของ Door Lock System

สาเหตุ: Opera ยอมรับคำขอแล้ว แต่ติดต่อ Door Lock System ที่กำหนดค่าไว้ไม่ได้ นี่เป็นปัญหาการเชื่อมต่อในการปฏิบัติงาน ไม่ใช่ผลการอ่านว่าไม่มีการ์ด

วิธีแก้:

  1. ยืนยันว่า Saflok interface และเครื่องเข้ารหัสเปิดอยู่
  2. ตรวจการเชื่อมต่อเครือข่ายของที่พักไปยัง Door Lock System
  3. ยืนยันว่า Opera Door Lock interface ออนไลน์
  4. ใส่การ์ดใหม่แล้วลอง Start scanning หนึ่งครั้ง
  5. ใช้ Look up by room หรือ Look up by confirmation number ขณะ interface ออฟไลน์
  6. ขอให้ผู้ดูแล Opera ตรวจการเชื่อมต่อของ Door Lock System และเครื่องเข้ารหัส

อย่าถือว่าข้อผิดพลาดนี้เป็น No card detected ติดต่อฝ่ายสนับสนุนหาก interface ยังคงออนไลน์แต่การอ่านยังหมดเวลา

ไม่รองรับประเภทการ์ด​

สิ่งที่เห็น: AVA แจ้งประเภทการ์ดไม่รองรับหรือไม่รู้จัก

สาเหตุ: มีการ์ดอยู่ แต่เครื่องเข้ารหัสนี้ไม่รู้จักประเภทของการ์ด กรณีนี้แตกต่างจากการไม่พบการ์ด

วิธีแก้:

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

อย่าขยับการ์ดซ้ำเมื่อ AVA ระบุว่าไม่รองรับประเภทการ์ด

อ่านการ์ดไม่ได้​

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

สาเหตุ: มีการ์ดอยู่ แต่เครื่องเข้ารหัสอ่านข้อมูลไม่ได้ การ์ดอาจเสียหาย ใช้งานร่วมกันไม่ได้ หรือวางไม่ถูกต้อง

วิธีแก้:

  1. นำการ์ดออกจากเครื่องเข้ารหัส
  2. ตรวจดูว่าการ์ดมีความเสียหายที่มองเห็นได้หรือไม่
  3. ใส่การ์ดกลับโดยหันด้านที่ถูกต้องขึ้น
  4. หากข้อผิดพลาดกลับมา ให้ลองการ์ดอื่นที่รองรับ
  5. ติดต่อฝ่ายสนับสนุนหากอ่านการ์ดที่ทราบว่าใช้ได้หลายใบไม่ได้

ตรวจไม่พบการ์ด​

สิ่งที่เห็น: AVA รายงานไม่พบการ์ดหลังเริ่มสแกน PMS

สาเหตุ: เครื่องอ่านไม่พบการ์ดบนเครื่องเข้ารหัส กรณีนี้แตกต่างจากการ์ดที่ไม่รองรับหรือการ์ดที่อ่านไม่ได้

วิธีแก้:

  1. นำการ์ดออกจากเครื่องอ่าน
  2. ใส่การ์ดกลับโดยหันด้านที่ถูกต้องขึ้น
  3. รอให้เครื่องอ่านทำงานเสร็จ แล้วลองสแกนอีกครั้ง
  4. ใช้ Look up by room หรือ Look up by confirmation number หากยังอ่านไม่ได้
  5. ติดต่อฝ่ายสนับสนุนหากการ์ดที่ทราบว่าใช้ได้หลายใบยังแสดงว่าไม่พบการ์ด

การอ่านการ์ด Opera แสดงข้อผิดพลาดทั่วไป​

สิ่งที่เห็น: AVA แสดงข้อผิดพลาดทั่วไปหลัง Opera ตอบ HTTP 200

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

วิธีแก้:

  1. ยืนยันว่าการ์ดเข้ารหัสโดย Opera และเป็นของการจองที่คาดไว้

  2. ใส่การ์ดกลับเข้าไปแล้วเลือก Start scanning อีกครั้ง

  3. หาก AVA อ่านการ์ดได้แต่ไม่มีห้อง ให้ใช้ Look up by room หรือ Look up by confirmation number

  4. หากข้อผิดพลาดทั่วไปยังเกิดขึ้น ให้ใช้การค้นหาด้วยตนเองและขอให้ผู้ดูแล Opera ตรวจข้อมูลการ์ด

  5. ติดต่อฝ่ายสนับสนุนพร้อมเวลาที่สแกน ชื่อที่พัก และชื่อเครื่องเข้ารหัส

    ✓ การ์ด Opera ที่ถูกต้องควรแสดงเป็นข้อมูลที่อ่านได้ แม้ไม่มีห้อง

แก้การแมปเครื่องเข้ารหัส kiosk ของ PMS ไม่ได้​

สิ่งที่เห็น: kiosk เข้ารหัสไม่ได้ แม้เครื่องอยู่ใน Physical Encoder Devices

สาเหตุ: การแมป Device Model ของ kiosk และการแมป kiosk แบบเดิมอาจใช้ป้ายกำกับต่างกัน AVA จะใช้การแมป Device Model ก่อน แล้วจึงย้อนกลับไปใช้การแมปแบบเดิม

วิธีแก้:

  1. ไปที่ Settings → Kiosk → Device Routing

  2. หา kiosk ที่มีปัญหาและตรวจการแมปเครื่องปลายทาง

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

  4. ยืนยันเครื่อง PMS ที่ตรงกันเป็น Active

  5. หากเป้าหมายเปลี่ยน ให้บันทึกการแมปด้วยชื่อ PMS ปัจจุบันของเครื่องเข้ารหัส

  6. ลองเข้ารหัสการ์ดทดสอบหนึ่งใบจาก kiosk

    ✓ AVA ควรแก้ kiosk ไปยังเครื่อง PMS ที่ active และส่งคำขอ

หากเครื่องหายจาก Physical Encoder Devices ให้ทำตาม การค้นหาเครื่องเข้ารหัส PMS ไม่มีผลลัพธ์

ยืนยันอุปกรณ์ kiosk หรือเครื่องเข้ารหัสไม่ได้​

สิ่งที่เห็น: AVA หยุดก่อนการเข้ารหัสและขอให้คุณยืนยัน kiosk หรือเครื่องเข้ารหัส

สาเหตุ: AVA ไม่สามารถกู้คืนเป้าหมาย kiosk การยืนยันเจ้าหน้าที่ หรือการตั้งค่าเครื่องเข้ารหัสที่บันทึกไว้ได้อย่างปลอดภัย

วิธีแก้:

  1. ปิดโมดัลการเข้ารหัส

  2. ไปที่ Settings → Kiosk

  3. ยืนยันว่า kiosk จริงใช้แถวอุปกรณ์ที่ต้องการ

  4. เลือก Re-verify staff device หากแถวนั้นขอให้ยืนยัน

  5. เปิด Device Routing และยืนยันเป้าหมายของ kiosk

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

  7. ยืนยันว่าเครื่องเข้ารหัสเป้าหมายเป็น Active และพร้อมใช้งาน

  8. กลับไปที่ kiosk แล้วลองการ์ดหนึ่งใบอีกครั้ง

    ✓ AVA ควรกู้คืนบริบท kiosk ปัจจุบันก่อนส่งคำขอ

อย่าใช้จำนวนเครื่องเข้ารหัสที่กำหนดค่าไว้เป็นตัวระบุเป้าหมาย เมื่อมีเป้าหมายมากกว่าหนึ่งรายการ ให้ใช้ route หรือการเลือกเครื่องเข้ารหัสที่ระบุไว้อย่างชัดเจน

การทดสอบการเชื่อมต่อ Be-Tech ล้มเหลว​

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

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

การตรวจการเข้าถึง Be-Tech

AVA ถือว่าการตอบ 405 หมายถึงเข้าถึงได้ เพราะการติดตั้ง Be-Tech บางแบบไม่รองรับเมธอดตรวจสอบ ระบบถือว่าการตอบ 401, 404 และ 5xx หมายถึงใช้งานไม่ได้

วิธีแก้:

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

ไคลเอนต์หรือ service Be-Tech หยุดหลังรีสตาร์ทหรือหยุดด้วยตนเอง​

สิ่งที่เห็น: ไคลเอนต์หรือ service หยุดหลัง Windows รีสตาร์ทหรือหยุดเอง และ AVA อาจแสดงเครื่องว่าใช้ไม่ได้ชั่วคราว

สาเหตุ: ไคลเอนต์ Be-Tech สามารถเริ่มทำงานแยกจาก Windows Agent ได้ ถาดระบบจะตรวจพบไคลเอนต์ที่ติดตั้งไว้และกู้คืน service ให้โดยอัตโนมัติ

วิธีแก้:

  1. ปล่อยให้ service ของ Windows Agent ทำงานบนคอมพิวเตอร์เครื่องเข้ารหัส
  2. รอให้ถาดระบบแสดงการแจ้งเตือนการกู้คืน Be-Tech
  3. รอการแจ้งเตือนว่า service ของไคลเอนต์ Be-Tech กลับมาทำงานแล้ว
  4. รีเฟรช Settings → Room Access → Keycard Encoding
  5. ยืนยัน agent และเครื่องเป็น Connected หรือ Online
  6. ลองดำเนินการคีย์การ์ดอีกครั้ง
ลองใหม่อัตโนมัติ

หากกู้คืนไม่สำเร็จ ถาดระบบจะลองใหม่โดยอัตโนมัติ ใช้การดำเนินการ Restart ในถาดระบบเฉพาะเมื่อการกู้คืนยังล้มเหลวต่อเนื่อง

หากโรงแรมมีการติดตั้ง Be-Tech หลายชุด ให้สอบถามผู้ดูแลการติดตั้งเกี่ยวกับ BETECH_CLIENT_PATH พาธนี้ต้องชี้ไปยังการติดตั้ง Program Files ที่เชื่อถือได้

โปรแกรมไคลเอนต์ Be-Tech ใช้งานไม่ได้​

สิ่งที่เห็น: AVA แสดง "Make sure the Be-Tech client program is running on the encoder computer."

สาเหตุ: Windows Agent ติดต่อ service ของไคลเอนต์ Be-Tech ในเครื่องไม่ได้ ถาดระบบอาจกำลังกู้คืนไคลเอนต์หรือ service อยู่แล้ว

วิธีแก้:

  1. ไปยังคอมพิวเตอร์เครื่องเข้ารหัส
  2. ตรวจการแจ้งเตือนการกู้คืน Be-Tech ในถาด Windows
  3. รอสักครู่ แล้วรีเฟรช Settings → Room Access → Keycard Encoding
  4. หาก agent ยังคงออฟไลน์ ให้ใช้การดำเนินการ Restart ในถาดระบบ
  5. คลิก Test Connection อีกครั้ง
ข้อผิดพลาด Be-Tech อื่น ๆ

หากเห็น Be-Tech request failed ให้ทำตาม การทดสอบการเชื่อมต่อ Be-Tech ล้มเหลว ข้อความเกี่ยวกับโปรแกรมไคลเอนต์โดยตรงใช้เฉพาะกับการตอบกลับ 502 ที่ผู้ให้บริการไม่พร้อมใช้งาน

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

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

วิธีแก้:

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

ต้องเลือกเครื่องเข้ารหัส GreatLocks​

สิ่งที่เห็น: การตรวจสถานะหรือกำหนดค่า GreatLocks ขอให้เลือกเครื่อง

สาเหตุ: Universal Encoder Agent แต่ละตัวให้บริการเครื่อง GreatLocks หนึ่งเครื่อง AVA จึงไม่สามารถเลือกเป้าหมายอย่างปลอดภัยเมื่อมีเซิร์ฟเวอร์หรือ agent หลายรายการ

วิธีแก้:

  1. ไปที่ Settings → Room Access → Keycard Encoding
  2. เปิด Physical Encoder Devices
  3. ยืนยันว่าแต่ละแถวมี Encoder ID เพียงหนึ่งค่า ใช้ ID ต่างกันสำหรับเครื่องเข้ารหัสจริงแต่ละเครื่อง
  4. เลือกเครื่องเข้ารหัสที่เชื่อมต่อกับ Windows PC ที่ต้องการ
  5. ยืนยันว่า agent ของเครื่องนั้นเป็น Online
  6. บันทึก แล้วทำรายการตรวจสถานะ กำหนดค่า หรือทดสอบซ้ำ
สถานะเครื่องแยกกัน

เครื่อง GreatLocks แต่ละเครื่องมีสถานะสดของตนเอง การที่ agent หนึ่งตัวออนไลน์ไม่ได้ทำให้เครื่องเข้ารหัสอื่นออนไลน์ตามไปด้วย

โหลดรายการอุปกรณ์ GreatLocks ไม่ได้​

สิ่งที่เห็น: รายการอาคาร ชั้น หรือห้องว่างอยู่

สาเหตุ: GreatLocks tunnel ออฟไลน์ หรือไม่สามารถเข้าถึงแหล่งข้อมูลรายการได้

วิธีแก้:

  1. ไปที่ Settings → Room Access → Keycard Encoding
  2. ยืนยันว่าบันทึกรายการเซิร์ฟเวอร์แล้ว
  3. หากมีหลายเครื่อง ให้เลือกเครื่องที่เชื่อมโยงกับรายการ
  4. ตรวจว่า tunnel ของ agent มีการเชื่อมต่อที่ใช้งานได้
  5. คลิก Test Connection อีกครั้ง
  6. รีเฟรชหน้าหลังการเชื่อมต่อกลับมา

ต้องระบุ Service URL ของ LockSDK​

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

วิธีแก้:

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

agent ของ LockSDK ยังไม่ได้ลงทะเบียน​

สิ่งที่เห็น: card LockSDK แสดง Not registered ใน Windows Agent

วิธีแก้:

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

Heartbeat Monitor ปิดหลังบันทึก​

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

วิธีแก้:

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

Heartbeat ล้มเหลว​

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

วิธีแก้:

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

Online หมายถึง AVA ยืนยันเครื่องและ tunnel แล้ว Offline หมายถึง AVA ยืนยันว่าเครื่องใช้ไม่ได้ Unknown หมายถึง AVA ตรวจสอบไม่ได้ และไม่ได้แปลว่าออฟไลน์เสมอไป

สถานะเครื่องเข้ารหัสเป็น unknown​

สิ่งที่เห็น: Heartbeat Monitor แสดง unknown แต่เซสชันและ tunnel ปกติ

สาเหตุ: การวินิจฉัยเพิ่มเติมของผู้ให้บริการอาจใช้ไม่ได้ ข้อมูลรับรอง Saflok Ambiance ที่ขาดหายอาจทำให้สถานะไม่สามารถยืนยันได้

วิธีแก้:

  1. ตรวจ Registered Agents และยืนยันว่า agent เชื่อมต่ออยู่
  2. ยืนยันว่า Last Seen เป็นเวลาล่าสุดและ tunnel เข้าถึงได้
  3. อย่ารีสตาร์ทหรือติดตั้ง agent ใหม่เพียงเพราะสถานะเป็น unknown
  4. ทดสอบคีย์การ์ดหนึ่งใบหากต้องการยืนยันว่าเครื่องยังทำงาน
  5. ติดต่อฝ่ายสนับสนุนหากข้อผิดพลาดสถานะยังคงอยู่หรือการเข้ารหัสล้มเหลว

ข้อผิดพลาดสถานะหรือ tunnel ของ Heartbeat​

สิ่งที่เห็น: Heartbeat รายงานข้อผิดพลาดสถานะหรือ tunnel

วิธีแก้:

  1. อ่านข้อความทั้งหมด และจดว่าข้อความระบุถึงสถานะเครื่องเข้ารหัสหรือ tunnel
  2. สำหรับ status error ให้ตรวจการวินิจฉัยของผู้ให้บริการและบันทึกข้อความที่แน่นอน
  3. สำหรับ tunnel failure ให้ยืนยันว่า agent ทำงานอยู่และ Last Seen เป็นเวลาล่าสุด
  4. รีเฟรช Settings → Room Access แล้วตรวจสถานะอีกครั้ง
  5. ติดต่อฝ่ายสนับสนุนหากยังผิดพลาดหรือเข้ารหัสไม่ได้

การแจ้งเตือนเครื่องเข้ารหัสใน Google Chat​

สิ่งที่เห็น: Google Chat ส่งการแจ้งเตือนเครื่องเข้ารหัสพร้อมหัวข้อที่ชัดเจนและการดำเนินการสำหรับเจ้าหน้าที่

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

วิธีแก้:

  1. หากเป็นปัญหาชั่วคราว ให้ทำคีย์การ์ดตามปกติ เว้นแต่จะมีใบใดใบหนึ่งล้มเหลว
  2. หากมีใบหนึ่งล้มเหลว ให้ตรวจไฟของเครื่องเข้ารหัสและสายที่ต่อกับคอมพิวเตอร์
  3. รีสตาร์ทแอป Encoder Agent บนคอมพิวเตอร์ของเครื่องเข้ารหัส
  4. หากแอปไม่กู้คืน ให้รีสตาร์ทคอมพิวเตอร์
  5. หากเครื่องเข้ารหัสยังหยุดทำงาน ให้ออกการ์ดที่ฟรอนต์เดสก์เมื่อทำได้
  6. ติดต่อฝ่ายสนับสนุน Vouch ทันทีหากไม่มีวิธีออกการ์ดอื่น
ประเภทการแจ้งเตือน

Keycard encoder had brief problems หมายถึงเครื่องเข้ารหัสกู้คืนแล้วและใช้งานได้ในขณะนี้ Keycard encoder not working หมายถึงผู้เข้าพักอาจไม่ได้รับการ์ดจาก kiosk Keycards working again หมายถึงเครื่องเข้ารหัสกู้คืนแล้วและไม่ต้องดำเนินการใด

การแจ้งเตือนเก็บรายละเอียดทางเทคนิคไว้ในส่วนท้ายตัวเอียง For Vouch support ให้แนบส่วนท้ายนี้เมื่อคุณติดต่อฝ่ายสนับสนุน

สถานะเครื่องเข้ารหัสแบบสดไม่ตรงกัน​

สิ่งที่เห็น: ตั้งค่าแล้วแต่ AVA ยังระบุว่าใช้ไม่ได้ในโมดัลการจอง

สาเหตุ: AVA จะแสดง Online หลังยืนยัน agent และ tunnel แล้วเท่านั้น ผลลัพธ์ Unknown หมายถึงยังยืนยันสถานะเครื่องเข้ารหัสไม่ได้ ไม่ได้ยืนยันว่าออฟไลน์ สถานะนี้ยังเป็นตัวกำหนดการเลือกเครื่องเข้ารหัสแบบไดนามิกด้วย สำหรับ GreatLocks สถานะจะเป็นของเครื่องเข้ารหัสที่เชื่อมโยงกับ agent นั้นเท่านั้น

วิธีแก้:

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

Windows Agent เก่าเกินไปสำหรับอ่านคีย์การ์ด​

สิ่งที่เห็น: Read Keycard ล้มเหลวพร้อม "This Windows Agent is too old to read keycards. Update the Universal Encoder Agent, then try again."

สาเหตุ: Universal Encoder Agent รุ่นเก่าไม่เปิดเผย Saflok read API AVA จึงไปยังหน้าเว็บเริ่มต้นของ PC โรงแรมแทนที่จะไปยัง agent

วิธีแก้:

  1. ไปที่ Settings → Room Access → Keycard Encoding
  2. หากแสดง outdated ให้คลิก Update ก่อน Reinstall
  3. รอ agent เชื่อมต่อ
  4. ลอง Read Keycard

tunnel เครื่องเข้ารหัสออฟไลน์​

สิ่งที่เห็น: Read Keycard แสดง "The encoder tunnel is offline. Start the Universal Encoder Agent, then try again."

สาเหตุ: คอมพิวเตอร์เครื่องเข้ารหัสติดต่อ AVA ผ่าน tunnel ของ Universal Encoder Agent ไม่ได้ กรณีนี้แตกต่างจาก agent ที่ล้าสมัย ซึ่งต้องอัปเดต

วิธีแก้:

  1. ไปที่ Settings → Room Access → Keycard Encoding
  2. หา card Saflok Windows Agent
  3. เริ่ม Universal Encoder Agent บนคอมพิวเตอร์เครื่องเข้ารหัส
  4. รอจน agent แสดง Connected และเวลา Last Seen เป็นเวลาล่าสุด
  5. ลอง Read Keycard อีกครั้ง
  6. หากยังออฟไลน์ ให้ทำตาม Windows Agent not connected

Windows Agent ไม่เชื่อมต่อ​

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

วิธีแก้:

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

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

การดำเนินการ service ของ Windows Agent ต้องมีสิทธิ์​

สิ่งที่เห็น: Windows ขอสิทธิ์ผู้ดูแลเมื่อคลิก Start, Stop หรือ Restart

สาเหตุ: ปุ่มถาดระบบต้องใช้สิทธิ์ยกระดับเพื่อควบคุม service

วิธีแก้:

  1. คลิก Yes ในข้อความ UAC
  2. หากคุณไม่ใช่ผู้ดูแล ให้ขอให้ผู้มีสิทธิ์ผู้ดูแลอนุมัติ
  3. หากยกเลิกข้อความ ให้ลองดำเนินการอีกครั้ง

ไม่แสดงกฎ routing ของ kiosk​

สิ่งที่เห็น: คุณไม่พบกฎ routing ใต้ Room Access หรือส่วน Kiosk to Encoder Routing แบบเดิม

วิธีแก้:

  1. ไปที่ Settings → Kiosk
  2. เปิด Device Routing
  3. ปิด Enable guest selection เพื่อแสดงกฎแบบกำหนดเอง
  4. เพิ่มอุปกรณ์อย่างน้อยหนึ่งรายการใน Physical Encoder Devices

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

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

  • ❌ เครื่องเข้ารหัสยังออฟไลน์หลังตรวจไฟและเครือข่าย
  • ❌ โปรแกรมไคลเอนต์ Be-Tech ยังคงหยุด
  • ❌ การเข้ารหัสล้มเหลวใน kiosk หลายเครื่อง
  • ❌ Heartbeat ยังไม่ปกตินานกว่า 30 นาที

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

  • ประเภทและรุ่นเครื่องเข้ารหัส
  • ข้อความข้อผิดพลาด Be-Tech แบบเต็ม
  • ใช้ Windows Agent หรือ Base URL แบบ direct
  • ภาพหน้าจอ Registered Agents และ Heartbeat Monitor
  • เวลาที่เริ่มเกิดปัญหา