스마트락 문제 해결

빠른 조치

먼저 Refresh Locks를 실행한 뒤 한 객실에서 Test PIN Generation을 돌려보세요. 보통 2분 정도면 끝납니다.

이 가이드는 Igloohome, TTLock, Wishome의 일반적인 스마트락 문제를 해결하는 데 도움을 줍니다.

객실별 PIN

AVA는 각 PIN을 예약의 PMS 객실에 연결합니다. Opera가 아닌 PMS 환경에서는 AVA가 스마트락 접근용으로 객실 자체의 확인 번호를 사용합니다. Opera OHIP 다중 객실 예약에서는 AVA가 스마트락 접근을 만들 때 각 하위 예약의 객실 번호를 사용합니다. 게스트가 객실을 바꾸면 동기화를 기다린 뒤 새 PIN을 생성하세요. 다중 객실 예약에서는 각 객실이 자체 하위 예약 또는 객실 수준 ID를 사용합니다. 이렇게 해야 대량 PIN 생성이 올바른 객실에 연결됩니다. 조회 화면을 다시 열면 AVA가 같은 예약 계열의 관련 객실도 복구할 수 있습니다.

빠른 참조

보이는 현상	발생 이유	조치
"Failed to generate lock code"	공급업체 연결 문제 또는 락 오프라인	공급업체와 잠금 상태 확인
실패한 PIN이 새로고침 후 작동함	AVA가 다음 예약 조회에서, 같은 예약 계열의 관련 객실까지 포함해 생성을 다시 시도함	예약 새로고침
Manage PIN이 비활성화됨	아직 객실이 배정되지 않았거나, 객실 데이터가 동기화되지 않았거나, 객실이 잠금에 매핑되지 않음	Room Access를 연 뒤 새로고침
PIN은 생성됐지만 락에서 작동하지 않음	PIN이 락에 동기화되지 않았거나 브리지가 오프라인	공급업체 앱에서 PIN 확인
작업 상태가 pending 또는 partial	공급업체 브리지 작업이 아직 처리 중	기다렸다가 새로고침
"PIN generation failed for all locks" (Smart Lock Setup)	공급업체 장애 또는 모든 락 접근 불가	새로고침 후 다시 테스트
Smart Lock Setup에 락이 보이지 않음	공급업체가 연결되지 않았거나 락이 동기화되지 않음	새로고침 또는 다시 연결
"Operation not supported" 또는 비활성화된 작업	락 모델 또는 공급업체가 해당 작업을 지원하지 않음	기능 확인
게스트가 잘못된 도어 코드를 받음	락이 잘못된 객실에 매핑되었거나 예약이 잘못된 PMS 객실을 가리킴	객실 매핑과 예약 객실 확인
OAuth 성공 후 Igloohome가 Not linked로 표시됨	콜백은 돌아왔지만 상태가 아직 새로고쳐지지 않음	Igloohome 상태 새로고침

Manage PIN이 비활성화됨

보이는 현상: Manage PIN 버튼이 회색이거나 게스트용 PIN을 생성할 수 없습니다.

해결:

1. 예약에 객실이 배정되어 있는지 확인합니다.

2. 객실이 비어 있다면 PMS에서 객실을 배정합니다.

3. 동기화가 끝날 때까지 1~2분 기다린 뒤 AVA를 새로고칩니다.

4. Settings → Room Access로 이동해 Smart Lock Setup에서 해당 객실이 락에 매핑되어 있는지 확인합니다.

5. 툴팁에 링크가 있다면 눌러 바로 Settings → Room Access로 이동합니다.

   ✓ 객실이 배정되고 매핑되면 Manage PIN을 사용할 수 있어야 합니다.

코드 생성 실패

보이는 현상: 체크인 중 "Failed to generate lock code"가 표시되거나 PIN이 작동하지 않습니다.

해결:

1. 예약을 새로고치거나 게스트가 이미 체크인했다면 예약 조회에서 다시 엽니다.

   • 다중 객실 예약이면 부모 확인 번호도 다시 엽니다.

2. 락의 배터리 전원이 있고 공급업체 앱에서 반응하는지 확인합니다.

3. AVA에서 Refresh Locks를 클릭합니다.

4. 문제가 계속되면 Room Access에서 공급업체를 다시 연결합니다.

5. 게스트가 기다리고 있다면 공급업체 앱에서 수동 코드를 발급하거나 물리 키를 사용합니다.

   ✓ 적격한 투숙 중 예약에 대해서는 AVA가 다음 예약 조회 시 스마트락 PIN 생성을 다시 시도합니다.

작업 상태가 pending 또는 partial로 유지됨

보이는 현상: 스마트락 코드를 만든 뒤 상태가 pending 또는 partial로 보입니다.

해결:

1. 최대 1분 기다렸다가 예약 또는 Access Codes 페이지를 새로고칩니다.
2. AVA는 오래된 백로그 항목보다 최근 스마트락 작업을 먼저 확인하므로 새로운 게스트 PIN이 먼저 정리되어야 합니다.
3. 체크인 조회를 새로고칠 때 AVA는 코드를 보여 주기 전에 대기 작업을 다시 확인합니다.
4. AVA는 오래된 브리지 필드가 남아 있어도 만료된 과거 Active 행은 건너뜁니다.
5. AVA는 백그라운드에서 공급업체 작업을 계속 확인하므로 현재 투숙 중인 건이 추가 조치 없이 Successful이 될 수 있습니다.
6. 체크인 대기 중에도 AVA가 대기 중인 스마트락 작업을 새로고치므로 준비된 PIN이 더 빨리 보일 수 있습니다.
7. partial이 보이면 PIN을 공유하기 전에 상태가 끝날 때까지 기다립니다.
8. 현재 투숙 중인 건인데 1분 넘게 pending이면 예약에서 PIN 생성을 다시 시도합니다.
9. 상태가 Timed out 또는 Failed로 바뀌면 필요에 따라 공급업체 브리지와 다시 연결합니다.

생성된 PIN이 락에서 작동하지 않음

보이는 현상: AVA는 PIN 코드를 성공적으로 생성했지만, 게스트가 문을 열 때 작동하지 않습니다.

해결:

1. 공급업체 앱에서 PIN 코드 일치 여부 확인:

   • 공급업체 스마트락 앱(Igloohome, TTLock, Wishome)을 엽니다.
   • 공급업체 앱에 표시된 PIN 코드가 AVA가 생성한 코드와 같은지 확인합니다.
   • 같은 예약 또는 시간대를 찾습니다.

2. PIN 코드가 일치하지 않거나 공급업체 앱에 보이지 않으면:

   • 브리지가 없는 락: 배터리를 빼고 다시 넣어 전원을 껐다 켭니다.
   • 브리지/게이트웨이가 있는 락:
     • 브리지를 30초 동안 뽑았다가 다시 꽂아 재시작합니다.
     • 브리지가 다시 연결될 때까지 2~3분 기다립니다.
     • 공급업체 앱에서 브리지가 온라인인지 확인합니다.
   • 재설정 후 AVA에서 Refresh Locks를 클릭합니다.
   • 새 PIN 코드를 다시 생성합니다.

3. 문제가 계속되면:

   • 공급업체 앱에서 락 배터리 수준을 확인합니다(배터리가 낮으면 동기화 문제가 생길 수 있습니다).
   • 해당하는 경우 락이 브리지와 안정적으로 연결되어 있는지 확인합니다.
   • 공급업체 앱에서 락의 펌웨어가 최신인지 확인합니다.

Smart Lock Setup에서 PIN 테스트 실패

보이는 현상: Smart Lock Setup에 "PIN generation failed for all locks."가 표시됩니다.

해결:

1. Refresh Locks를 클릭합니다.
2. Test PIN Generation으로 단일 객실을 다시 테스트합니다.
3. 모든 테스트가 실패하면 Room Access에서 공급업체를 다시 연결합니다.

Smart Lock Setup에 락이 보이지 않음

보이는 현상: Available Devices가 비어 있습니다.

해결:

1. 공급업체 계정이 연결되어 있는지 확인합니다.
2. Refresh Locks를 클릭합니다.
3. 공급업체 앱에 락이 표시되고 선택한 공급업체와 일치하는지 확인합니다.

게스트가 잘못된 도어 코드를 받음

보이는 현상: 객실 변경이나 다중 객실 예약 후 게스트가 다른 객실 코드를 받습니다.

해결:

1. Settings → Room Access로 이동합니다.

2. Smart Lock Setup까지 스크롤합니다.

3. 예약에 올바른 PMS room이 표시되는지 확인합니다.

4. Opera OHIP 예약이라면 각 객실에 고유한 하위 예약 객실 번호가 있는지 확인합니다.

5. 다중 객실 예약이라면 각 객실마다 별도의 하위 예약 ID가 있는지 확인합니다.

6. Opera가 아닌 예약이라면 각 객실에 고유한 객실별 확인 번호가 있는지 확인합니다.

7. 필요하면 객실을 선택해 잘못된 락을 제거합니다.

8. 올바른 락을 배정합니다.

9. 동기화가 끝난 뒤 Refresh Locks와 Test PIN Generation을 다시 실행합니다.

   ✓ 올바른 락이 Assigned Devices에 표시됩니다.

기능이 지원되지 않음

보이는 현상: AVA가 락 또는 공급업체가 시도한 작업을 지원하지 않는다고 표시합니다.

원인: 해당 락 모델이 그 기능을 지원하지 않거나, 공급업체가 이를 막고 있습니다.

해결:

1. Settings → Room Access로 이동합니다.

2. Refresh Locks를 클릭합니다.

3. Smart Lock Setup에서 기능 레이블을 확인합니다.

4. 작업이 계속 비활성화되어 있으면 다른 락 모델이나 공급업체를 사용합니다.

   ✓ AVA는 연결된 락이 실제로 수행할 수 있는 작업만 표시합니다.

Igloohome 관련 문제

OAuth 성공 후 Igloohome가 Not linked로 표시됨

보이는 현상: OAuth를 끝냈는데도 Igloohome Locks에 여전히 Not linked가 표시됩니다.

해결:

1. OAuth가 돌아온 뒤에도 Settings → Room Access 화면에 머뭅니다.
2. 상태가 새로고쳐질 때까지 몇 초 기다립니다.
3. 상태가 바뀌지 않으면 페이지를 한 번 새로고칩니다.
4. 여전히 Not linked면 계정을 다시 연결합니다.

OAuth 연결이 만료됨

보이는 현상: 통합 상태가 연결 끊김으로 표시됩니다.

해결:

1. Igloohome Locks에서 Disconnect를 클릭합니다.
2. Link Account를 클릭합니다.
3. OAuth 인증을 완료합니다.

락이 보이지 않음

해결:

1. Igloohome에서 락이 해당 숙소에 배정되어 있는지 확인합니다.
2. AVA로 돌아가 Refresh Locks를 클릭합니다.

TTLock 관련 문제

로그인 실패

보이는 현상: "Failed to connect TTLock account."가 표시됩니다.

해결:

1. 사용자 이름과 비밀번호가 맞는지 확인합니다(대소문자 구분).
2. TTLock 앱에서 계정이 활성 상태인지 확인합니다.
3. 30초 후 다시 시도합니다.

락이 동기화되지 않음

해결:

1. TTLock 모바일 앱을 엽니다.
2. 락 가까이 서서 각각을 동기화합니다.
3. AVA로 돌아가 Refresh Locks를 클릭합니다.

Wishome 관련 문제

자격 증명이 불완전하거나 토큰이 만료됨

보이는 현상: "Wishome credentials incomplete" 또는 토큰 만료 경고가 표시됩니다.

해결:

1. Wishome Account Name과 Wishome Password를 다시 입력합니다.
2. Offline Password Version이 Wishome 설정과 일치하는지 확인합니다.
3. Connect Wishome Account를 클릭합니다.

그래도 해결되지 않으면

다음 경우 success@vouch-technologies.com으로 문의하세요.

• ❌ 연결 상태가 좋은데도 모든 락이 오프라인으로 표시됨
• ❌ 공급업체 자격 증명은 맞지만 연결 실패
• ❌ 여러 번 재시도해도 PIN 실패

함께 보내면 좋은 정보:

• 락 공급업체(Igloohome, TTLock, Wishome)
• 영향을 받는 락 수
• 오류 메시지 스크린샷

관련 안내서

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