스마트 락 문제 해결
먼저 Refresh Locks를 클릭한 다음, 객실 1개에 대해 Test PIN Generation을 실행하세요. 보통 2분이면 됩니다.
이 가이드는 Igloohome, TTLock, Wishome 스마트 락의 일반적인 문제를 해결하는 방법을 설명합니다.
빠른 참고
| 증상 | 원인 | 해결 방법 |
|---|---|---|
| "Failed to generate lock code" | 벤더 연결 문제 또는 락 오프라인 | 벤더 + 락 상태 확인 |
| PIN이 생성되었지만 락에서 작동하지 않음 | PIN이 락과 동기화되지 않음 또는 브리지 오프라인 | 벤더 앱에서 PIN 확인 |
| "PIN generation failed for all locks" (Smart Lock Setup) | 벤더 장애 또는 전체 락 연결 불가 | 새로 고침 후 재테스트 |
| Smart Lock Setup에 락이 없음 | 벤더 미연결 또는 락 미동기화 | 새로 고침 또는 재연결 |
| 투숙객이 잘못된 도어 코드를 받음 | 잘못된 객실에 락 매핑 | 객실 매핑 수정 |
코드 생성 실패
현상: 체크인 중 "Failed to generate lock code"가 표시되거나 PIN이 작동하지 않습니다.
해결 방법:
- 락 배터리가 충분하고 벤더 앱에서 반응하는지 확인합니다.
- AVA에서 Refresh Locks를 클릭합니다.
- 문제가 계속되면 Room Access에서 벤더를 다시 연결합니다.
- 투숙객이 기다리는 경우 벤더 앱에서 수동 코드를 발급하거나 물리 키를 사용합니다.
생성된 PIN이 락에서 작동하지 않음
현상: AVA가 PIN 코드를 성공적으로 생성했지만, 투숙객이 문을 열 때 PIN이 작동하지 않습니다.
해결 방법:
-
벤더 앱에서 PIN 코드 확인:
- 벤더의 스마트 락 앱(Igloohome, TTLock 또는 Wishome)을 엽니다
- 벤더 앱에 표시된 PIN 코드가 AVA가 생성한 코드와 일치하는지 확인합니다
- 동일한 예약 또는 시간대를 확인합니다
-
PIN 코드가 일치하지 않거나 벤더 앱에 표시되지 않는 경우:
- 브리지가 없는 락의 경우: 배터리를 빼고 다시 삽입하여 락을 재시작합니다
- 브리지/게이트웨이가 있는 락의 경우:
- 브리지의 전원을 30초간 뽑았다가 다시 꽂아 재시작합니다
- 브리지가 다시 연결될 때까지 2-3분 기다립니다
- 벤더 앱에서 브리지가 온라인으로 표시되는지 확인합니다
- 재설정 후 AVA에서 Refresh Locks를 클릭합니다
- 새 PIN 코드를 생성해 봅니다
-
문제가 계속되는 경우:
- 벤더 앱에서 락의 배터리 잔량을 확인합니다(배터리 부족 시 동기화 문제 발생 가능)
- 락이 브리지에 안정적으로 연결되어 있는지 확인합니다(해당되는 경우)
- 벤더 앱에서 락의 펌웨어가 최신 버전인지 확인합니다
스마트 락 설정에서 PIN 테스트 실패
현상: Smart Lock Setup에서 "PIN generation failed for all locks."가 표시됩니다.
해결 방법:
- Refresh Locks를 클릭합니다.
- Test PIN Generation으로 객실 하나를 다시 테스트합니다.
- 모든 테스트가 실패하면 Room Access에서 벤더를 재연결합니다.
스마트 락 설정에서 락이 보이지 않음
현상: Available Devices가 비어 있습니다.
해결 방법:
- 벤더 계정이 연결되어 있는지 확인합니다.
- Refresh Locks를 클릭합니다.
- 벤더 앱에 락이 표시되고 선택한 벤더와 일치하는지 확인합니다.
락에 잘못 매핑된 객실
현상: 투숙객이 잘못된 객실 코드가 제공됩니다.
해결 방법:
-
Settings → Room Access로 이동합니다.
-
Smart Lock Setup까지 스크롤합니다.
-
객실을 선택하고 잘못된 락을 제거합니다.
-
올바른 락을 할당합니다.
✓ 올바른 락이 Assigned Devices에 표시됩니다.
Igloohome 전용 문제
OAuth 연결 만료
현상: 연동 상태가 연결 해제로 표시됩니다.
해결 방법:
- Igloohome Locks에서 Disconnect를 클릭합니다.
- Link Account를 클릭합니다.
- OAuth 인증을 완료합니다.
락이 표시되지 않음
해결 방법:
- Igloohome에서 락이 해당 숙소에 할당되어 있는지 확인합니다.
- AVA로 돌아와 Refresh Locks를 클릭합니다.
TTLock 전용 문제
로그인 실패
현상: "Failed to connect TTLock account."가 표시됩니다.
해결 방법:
- 사용자명과 비밀번호(대소문자 구분)를 확인합니다.
- TTLock 앱에서 계정이 활성 상태인지 확인합니다.
- 30초 후 다시 시도합니다.
락 동기화 실패
해결 방법:
- TTLock 모바일 앱을 엽니다.
- 각 락 근처에서 동기화를 실행합니다.
- AVA로 돌아와 Refresh Locks를 클릭합니다.
Wishome 전용 문제
자격 증명 누락 또는 토큰 만료
현상: "Wishome credentials incomplete" 또는 토큰 만료 경고가 표시됩니다.
해결 방법:
- Wishome Account Name과 Wishome Password를 다시 입력합니다.
- Offline Password Version이 Wishome 설정과 일치하는지 확인합니다.
- Connect Wishome Account를 클릭합니다.
아직 해결이 안 되나요?
다음 경우에는 success@vouch-technologies.com으로 문의하세요:
- ❌ 모든 락이 온라인임에도 오프라인으로 표시됩니다
- ❌ 벤더 자격 증명이 맞는데도 연결이 실패합니다
- ❌ 여러 번 시도해도 PIN 생성이 실패합니다
함께 보내면 좋은 정보:
- 락 벤더(Igloohome, TTLock, Wishome)
- 영향받는 락 수
- 오류 메시지 스크린샷