Pemecahan Masalah Smart Lock

Perbaikan Cepat

Mulai dengan Refresh Locks, lalu jalankan Test PIN Generation untuk satu kamar. Biasanya proses ini memerlukan waktu 2 menit.

Panduan ini membantu Anda mengatasi masalah smart lock yang umum pada Igloohome, TTLock, dan Wishome.

PIN khusus kamar

AVA mengaitkan setiap PIN dengan kamar PMS pada reservasi. Untuk konfigurasi PMS non-Opera, AVA menggunakan nomor konfirmasi milik kamar tersebut untuk akses smart-lock. Untuk reservasi multi-kamar Opera OHIP, AVA menggunakan nomor kamar setiap subreservasi saat membuat akses smart-lock. Jika tamu pindah kamar, tunggu sinkronisasi selesai lalu buat PIN baru. Untuk reservasi multi-kamar, setiap kamar menggunakan subreservasi atau ID tingkat kamar miliknya sendiri. Dengan begitu, pembuatan PIN massal tetap terkait dengan kamar yang benar. Saat Anda membuka kembali pencarian, AVA juga dapat memulihkan kamar terkait dalam keluarga reservasi yang sama. Reservasi penggunaan harian dan menginap campuran tetap menggunakan jendela kamar yang terpisah. AVA tidak lagi menyalin jendela kedaluwarsa satu kamar ke kamar lain. Untuk Mews, AVA membaca tanggal menginap dalam zona waktu properti sebelum membuat jendela PIN.

Kedaluwarsa PIN berdasarkan waktu lokal hotel

AVA memperlakukan nilai reservasi yang hanya berisi tanggal sebagai tanggal kalender dalam zona waktu yang dikonfigurasi untuk hotel Anda. Contohnya, tanggal checkout 3 Agustus di Singapura berakhir pada 3 Agustus. Nilai tanggal-waktu lengkap dikonversi ke zona waktu hotel sebelum AVA membuat jendela PIN. AVA menggunakan jendela yang sama untuk PIN yang dibuat, PIN custom, dan PIN random-custom.

Referensi cepat

Yang Anda lihat	Penyebabnya	Lakukan ini
"Failed to generate lock code"	Masalah koneksi vendor atau lock sedang offline	Periksa status vendor + lock
PIN yang gagal mulai berfungsi setelah dimuat ulang	AVA mencoba kembali membuat PIN pada pengambilan reservasi berikutnya, termasuk kamar terkait dalam keluarga reservasi yang sama	Muat ulang reservasi
Kamar penggunaan harian memiliki waktu kedaluwarsa yang salah	Tanggal reservasi campuran atau ketidaksesuaian zona waktu	Periksa tanggal khusus kamar
PIN berakhir pada tanggal kalender yang salah	Zona waktu hotel atau jendela PIN lama	Periksa tanggal kedaluwarsa PIN
PIN custom memiliki panjang yang berbeda dari perkiraan	Batas yang didukung vendor berbeda-beda	Periksa batas PIN vendor
Manage PIN dinonaktifkan	Kamar belum ditetapkan, data kamar belum disinkronkan, atau kamar belum dipetakan ke lock	Buka Room Access, lalu muat ulang
PIN berhasil dibuat tetapi tidak berfungsi pada lock	PIN belum disinkronkan ke lock atau bridge sedang offline	Verifikasi PIN di aplikasi vendor
Status operasi tetap pending atau menampilkan partial	Proses bridge vendor masih berlangsung	Tunggu lalu muat ulang
"PIN generation failed for all locks" (Smart Lock Setup)	Gangguan vendor atau semua lock tidak dapat dijangkau	Uji lagi setelah dimuat ulang
Tidak ada lock yang muncul di Smart Lock Setup	Vendor belum ditautkan atau belum ada lock yang disinkronkan	Refresh atau sambungkan ulang
"Operation not supported" atau tindakan dinonaktifkan	Model lock atau vendor tidak mendukung tindakan tersebut	Periksa kapabilitas
Tamu menerima kode pintu yang salah	Lock dipetakan ke kamar yang salah, atau reservasi mengarah ke kamar PMS yang salah	Periksa pemetaan kamar dan kamar pada reservasi
Igloohome menampilkan Not linked setelah OAuth berhasil	Callback sudah kembali tetapi status belum diperbarui	Refresh status Igloohome

Manage PIN dinonaktifkan

Yang Anda lihat: Tombol Manage PIN berwarna abu-abu, atau Anda tidak dapat membuat PIN untuk tamu.

Perbaikan:

1. Pastikan reservasi sudah memiliki kamar.

2. Jika kamar masih kosong, tetapkan kamar di PMS Anda.

3. Tunggu 1-2 menit hingga sinkronisasi selesai, lalu muat ulang AVA.

4. Buka Settings → Room Access dan pastikan kamar dipetakan ke lock di Smart Lock Setup.

5. Jika tooltip menyertakan tautan, buka tautan tersebut untuk langsung menuju Settings → Room Access.

   ✓ Setelah kamar ditetapkan dan dipetakan, Manage PIN seharusnya tersedia.

Pembuatan kode gagal

Yang Anda lihat: "Failed to generate lock code" selama check-in atau PIN yang tidak berfungsi. Jika Access Details menampilkan errorCode, retriable, atau vendor, gunakan informasi tersebut juga.

Perbaikan:

1. Muat ulang reservasi atau buka kembali reservasi dari pencarian reservasi jika tamu sudah check-in.

   • Jika ini reservasi multi-kamar, buka kembali konfirmasi induknya juga.

2. Pastikan lock memiliki daya baterai dan merespons di aplikasi vendor.

3. Di AVA, klik Refresh Locks.

4. Jika masalah berlanjut, sambungkan ulang vendor di Room Access.

5. Jika tamu sedang menunggu, buat kode manual dari aplikasi vendor atau gunakan kunci fisik.

   ✓ AVA mencoba kembali membuat PIN smart-lock pada pengambilan reservasi berikutnya untuk masa inap aktif yang memenuhi syarat.

Jendela akses penggunaan harian terlihat salah

Yang Anda lihat: Reservasi campuran memberikan waktu kedaluwarsa yang salah untuk salah satu kamar, atau kamar penggunaan harian menggunakan jendela menginap.

Perbaikan:

1. Muat ulang reservasi di AVA.

2. Pastikan setiap kamar memiliki nomor kamar dan tanggal menginap yang benar di PMS Anda.

3. Jika Anda menggunakan Mews, periksa zona waktu properti di Settings → Essentials → Hotel Basic Details.

4. Buat ulang PIN jika jendela yang salah masih muncul.

   ✓ Setiap kamar seharusnya menampilkan jendela kedaluwarsanya sendiri.

Tanggal kedaluwarsa PIN terlihat salah

Yang Anda lihat: PIN berakhir satu hari kalender setelah tanggal checkout pada reservasi.

Perbaikan:

1. Buka Settings → Essentials → Hotel Basic Details.

2. Pastikan Timezone hotel sesuai dengan zona waktu lokal properti.

3. Pastikan tanggal checkout reservasi di PMS Anda.

4. Buat PIN baru dari reservasi setelah memperbaiki zona waktu atau reservasi.

5. Cabut PIN lama jika masih memiliki jendela validitas yang salah.

   ✓ PIN baru berakhir pada tanggal checkout dalam zona waktu hotel.

PIN yang sudah ada tidak berubah

Perubahan perilaku ini tidak memperbarui PIN yang sudah dibuat oleh vendor. Cabut atau buat ulang PIN tersebut secara terpisah.

Panjang PIN custom terlihat salah

Yang Anda lihat: PIN custom yang dibuat memiliki panjang berbeda dari pengaturan yang disimpan.

Perbaikan:

1. Periksa rentang yang didukung vendor Anda:

   • Igloohome: 4–6 digit
   • TTLock: 4–9 digit
   • Wishome: 6–10 digit

2. Jika panjang yang dipilih berada di luar rentang tersebut, AVA menyesuaikan PIN yang dibuat secara otomatis.

3. Buat PIN baru dari reservasi.

   ✓ PIN custom baru menggunakan panjang yang didukung vendor Anda.

Status operasi tetap pending atau partial

Yang Anda lihat: Kode smart-lock menampilkan pending atau partial setelah dibuat.

Perbaikan:

1. Tunggu hingga 1 menit, lalu muat ulang reservasi atau halaman Access Codes.
2. AVA memeriksa proses smart-lock yang lebih baru sebelum entri antrean lama, sehingga PIN tamu yang baru seharusnya selesai lebih dahulu.
3. Selama memuat ulang pencarian check-in, AVA memeriksa kembali proses pending sebelum mengembalikan kode.
4. AVA melewati baris Active historis yang sudah kedaluwarsa, meskipun kolom bridge lama masih ada.
5. AVA terus memeriksa proses vendor di latar belakang, sehingga masa inap yang sedang berlangsung dapat berubah menjadi Successful tanpa tindakan lain.
6. Selama menunggu check-in, AVA juga menyegarkan proses smart-lock yang pending, yang dapat menampilkan PIN siap lebih cepat.
7. Jika Anda melihat partial, tunggu hingga status selesai sebelum membagikan PIN.
8. Jika status tetap pending selama lebih dari 1 menit pada masa inap yang sedang berlangsung, coba buat PIN lagi dari reservasi.
9. Jika status berubah menjadi Timed out atau Failed, periksa bridge vendor dan sambungkan ulang vendor jika diperlukan.

PIN yang dibuat tidak berfungsi pada lock

Yang Anda lihat: AVA berhasil membuat kode PIN, tetapi PIN tersebut tidak berfungsi saat tamu mencoba membuka kunci pintu.

Perbaikan:

1. Verifikasi kode PIN cocok di aplikasi vendor:

   • Buka aplikasi smart lock vendor Anda (Igloohome, TTLock, atau Wishome)
   • Periksa apakah kode PIN yang ditampilkan di aplikasi vendor cocok dengan kode yang dibuat AVA
   • Cari reservasi atau periode waktu yang sama

2. Jika kode PIN tidak cocok atau tidak ditampilkan di aplikasi vendor:

   • Untuk lock tanpa bridge: matikan lalu nyalakan lock dengan melepas dan memasang kembali baterai
   • Untuk lock dengan bridge/gateway:
     • Restart bridge dengan mencabutnya selama 30 detik, lalu menyambungkannya kembali
     • Tunggu 2-3 menit hingga bridge tersambung kembali
     • Pastikan bridge tampil online di aplikasi vendor
   • Setelah reset, klik Refresh Locks di AVA
   • Coba buat kode PIN baru

3. Jika masalah berlanjut:

   • Periksa tingkat baterai lock di aplikasi vendor (baterai lemah dapat menyebabkan masalah sinkronisasi)
   • Pastikan lock memiliki koneksi yang stabil ke bridge (jika berlaku)
   • Pastikan firmware lock sudah diperbarui di aplikasi vendor

Pengujian PIN gagal di Smart Lock Setup

Yang Anda lihat: "PIN generation failed for all locks." di Smart Lock Setup.

Perbaikan:

1. Klik Refresh Locks.
2. Uji satu kamar lagi dengan Test PIN Generation.
3. Jika semua pengujian gagal, sambungkan ulang vendor di Room Access.

Tidak ada lock yang muncul di Smart Lock Setup

Yang Anda lihat: Available Devices kosong.

Perbaikan:

1. Pastikan akun vendor sudah ditautkan.
2. Klik Refresh Locks.
3. Pastikan lock muncul di aplikasi vendor dan sesuai dengan vendor yang dipilih.

Tamu menerima kode pintu yang salah

Yang Anda lihat: Tamu menerima kode untuk kamar yang salah setelah pindah kamar atau reservasi multi-kamar.

Perbaikan:

1. Buka Settings → Room Access.

2. Gulir ke Smart Lock Setup.

3. Pastikan reservasi menampilkan PMS room yang benar.

4. Jika ini reservasi Opera OHIP, pastikan setiap kamar memiliki nomor kamar subreservasi sendiri.

5. Jika ini reservasi multi-kamar, pastikan setiap kamar memiliki ID subreservasi sendiri.

6. Jika ini reservasi non-Opera, pastikan setiap kamar memiliki nomor konfirmasi khusus kamar sendiri.

7. Pilih kamar dan hapus lock yang salah jika diperlukan.

8. Tetapkan lock yang benar.

9. Tunggu sinkronisasi, lalu jalankan kembali Refresh Locks dan Test PIN Generation.

   ✓ Lock yang benar muncul di Assigned Devices.

Tindakan tidak didukung

Yang Anda lihat: AVA menyatakan bahwa lock atau vendor tidak mendukung tindakan yang Anda coba.

Mengapa ini terjadi: Model lock tersebut tidak mendukung fitur itu, atau vendor memblokirnya.

Perbaikan:

1. Buka Settings → Room Access.

2. Klik Refresh Locks.

3. Periksa label kapabilitas di Smart Lock Setup.

4. Gunakan model lock atau vendor lain jika tindakan tersebut tetap dinonaktifkan.

   ✓ AVA hanya menampilkan tindakan yang dapat diselesaikan oleh lock yang terhubung.

Masalah khusus Igloohome

Igloohome menampilkan Not linked setelah OAuth berhasil

Yang Anda lihat: Anda telah menyelesaikan OAuth, tetapi Igloohome Locks masih menampilkan Not linked.

Perbaikan:

1. Tetap berada di Settings → Room Access setelah OAuth kembali.
2. Tunggu beberapa detik hingga status diperbarui.
3. Refresh halaman sekali jika status tidak berubah.
4. Tautkan ulang akun jika masih menampilkan Not linked.

Koneksi OAuth kedaluwarsa

Yang Anda lihat: Integrasi menunjukkan status terputus.

Perbaikan:

1. Klik Disconnect di Igloohome Locks.
2. Klik Link Account.
3. Selesaikan otorisasi OAuth.

Lock tidak muncul

Perbaikan:

1. Pastikan lock ditetapkan ke properti di Igloohome.
2. Kembali ke AVA dan klik Refresh Locks.

Masalah khusus TTLock

Login gagal

Yang Anda lihat: "Failed to connect TTLock account."

Perbaikan:

1. Pastikan username dan password benar (peka huruf besar-kecil).
2. Verifikasi akun aktif di aplikasi TTLock.
3. Coba lagi setelah 30 detik.

Lock tidak disinkronkan

Perbaikan:

1. Buka aplikasi mobile TTLock.
2. Sinkronkan setiap lock dengan berdiri di dekatnya.
3. Kembali ke AVA dan klik Refresh Locks.

Masalah khusus Wishome

Kredensial tidak lengkap atau token kedaluwarsa

Yang Anda lihat: "Wishome credentials incomplete" atau peringatan token kedaluwarsa.

Perbaikan:

1. Masukkan kembali Wishome Account Name dan Wishome Password.
2. Pastikan Offline Password Version sesuai dengan konfigurasi Wishome Anda.
3. Klik Connect Wishome Account.

Masih terkendala?

Hubungi success@vouch-technologies.com jika:

• ❌ Semua lock terlihat offline meskipun konektivitas baik
• ❌ Kredensial vendor benar tetapi koneksi gagal
• ❌ PIN tetap gagal setelah beberapa kali percobaan

Sebaiknya sertakan:

• Vendor lock (Igloohome, TTLock, atau Wishome)
• Jumlah lock yang terdampak
• Tangkapan layar pesan error

Panduan terkait

• Ringkasan Smart Locks
• Menyiapkan Penugasan Smart Lock
• Penyiapan Igloohome
• Penyiapan TTLock
• Penyiapan Wishome