Troubleshooting Smart Lock

Perbaikan Cepat

Mulai dengan Refresh Locks, lalu jalankan Test PIN Generation untuk satu kamar. Ini biasanya memakan waktu 2 menit.

Panduan ini membantu Anda menyelesaikan masalah smart lock yang umum untuk Igloohome, TTLock, dan Wishome.

PIN khusus kamar

AVA mengikat setiap PIN ke kamar PMS pada reservasi. Untuk setup PMS non-Opera, AVA memakai confirmation number milik kamar itu sendiri untuk akses smart-lock. Jika tamu pindah kamar, tunggu sinkronisasi lalu buat PIN baru. Untuk booking multi-room, setiap kamar memakai sub-reservasi atau room-level ID sendiri. Ini membuat pembuatan PIN massal tetap terikat ke kamar yang benar.

Referensi cepat

Yang terlihat	Penyebab	Langkah perbaikan
"Failed to generate lock code"	Masalah koneksi vendor atau lock offline	Cek vendor + status lock
Manage PIN dinonaktifkan	Kamar belum ditetapkan, data kamar belum sinkron, atau kamar tidak dipetakan ke lock	Buka Room Access lalu refresh
PIN dibuat tetapi tidak bekerja di lock	PIN belum tersinkron ke lock atau bridge offline	Verifikasi PIN di aplikasi vendor
Operation status tetap pending atau menunjukkan partial	Job bridge vendor masih diproses	Tunggu lalu refresh
"PIN generation failed for all locks" (Smart Lock Setup)	Gangguan vendor atau semua lock tidak terjangkau	Tes ulang setelah refresh
Tidak ada lock di Smart Lock Setup	Vendor belum terhubung atau lock belum sinkron	Refresh atau reconnect
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 reservasi
Igloohome menampilkan Not linked setelah OAuth sukses	Callback kembali tetapi status belum sempat refresh	Refresh status Igloohome

Manage PIN dinonaktifkan

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

Perbaikan:

1. Pastikan reservasi sudah memiliki kamar.

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

3. Tunggu 1-2 menit sampai sinkron selesai, lalu refresh AVA.

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

5. Jika tooltip menyertakan tautan, buka tautan itu untuk langsung ke Settings → Room Access.

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

Code generation failed

Yang Anda lihat: "Failed to generate lock code" selama check-in atau PIN yang tidak bekerja.

Perbaikan:

1. Verifikasi lock memiliki daya baterai dan merespons di aplikasi vendor.
2. Di AVA, klik Refresh Locks.
3. Jika masalah berlanjut, hubungkan ulang vendor di Room Access.
4. Jika tamu sedang menunggu, keluarkan kode manual dari aplikasi vendor atau gunakan kunci fisik.

Operation status tetap pending atau partial

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

Perbaikan:

1. Tunggu hingga 1 menit, lalu refresh reservasi atau halaman Access Codes.
2. AVA memeriksa job smart lock yang lebih baru sebelum antrean yang lebih lama, jadi PIN tamu yang baru seharusnya selesai lebih dulu.
3. Selama refresh lookup check-in, AVA memeriksa ulang job pending sebelum mengembalikan kode.
4. AVA melewati baris Active historis yang sudah kedaluwarsa, meskipun field bridge lama masih ada.
5. AVA terus memeriksa job vendor di latar belakang, jadi masa inap saat ini bisa menjadi Successful tanpa tindakan tambahan.
6. Saat menunggu di check-in, AVA juga menyegarkan job smart lock yang pending, yang bisa menampilkan PIN siap lebih cepat.
7. Jika Anda melihat partial, tunggu statusnya selesai sebelum membagikan PIN.
8. Jika status tetap pending lebih dari 1 menit pada masa inap yang sedang aktif, coba buat PIN lagi dari reservasi.
9. Jika berubah menjadi Timed out atau Failed, periksa bridge vendor dan hubungkan ulang vendor jika perlu.

PIN yang dibuat tidak bekerja di lock

Yang Anda lihat: AVA berhasil membuat PIN, tetapi PIN itu tidak bisa membuka pintu saat tamu mencoba.

Perbaikan:

1. Verifikasi apakah kode PIN cocok di aplikasi vendor:

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

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

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

3. Jika masalah masih berlanjut:

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

Test 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. Tes ulang satu kamar dengan Test PIN Generation.
3. Jika semua tes gagal, hubungkan 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 terhubung.
2. Klik Refresh Locks.
3. Verifikasi lock muncul di aplikasi vendor dan cocok dengan vendor yang dipilih.

Tamu menerima kode pintu yang salah

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

Perbaikan:

1. Buka Settings → Room Access.

2. Scroll ke Smart Lock Setup.

3. Konfirmasi reservasi menampilkan PMS room yang benar.

4. Jika ini booking multi-room, konfirmasi setiap kamar memiliki sub-reservation ID sendiri.

5. Jika ini booking non-Opera, konfirmasi setiap kamar memiliki confirmation number khusus kamar sendiri.

6. Pilih kamar dan hapus lock yang salah jika perlu.

7. Tetapkan lock yang benar.

8. Tunggu sinkronisasi, lalu jalankan lagi Refresh Locks dan Test PIN Generation.

   ✓ Lock yang benar muncul di Assigned Devices.

Masalah khusus Igloohome

Igloohome menunjukkan Not linked setelah OAuth sukses

Yang Anda lihat: Anda selesai OAuth, tetapi Igloohome Locks masih menunjukkan Not linked.

Perbaikan:

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

Koneksi OAuth kedaluwarsa

Yang Anda lihat: Integrasi terlihat 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 sinkron

Perbaikan:

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

Masalah khusus Wishome

Kredensial belum lengkap atau token kedaluwarsa

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

Perbaikan:

1. Masukkan ulang Wishome Account Name dan Wishome Password.
2. Pastikan Offline Password Version sesuai setup 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

Informasi yang sebaiknya disertakan:

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

Panduan Terkait

• Smart Locks Overview
• Set Up Smart Lock Assignments
• Igloohome Setup
• TTLock Setup
• Wishome Setup