본문으로 건너뛰기

스마트 락 문제 해결

빠른 해결

먼저 Refresh Locks를 누른 다음, 객실 1개에 대해 Test PIN Generation을 실행하세요. 보통 2분이면 충분합니다.

이 가이드는 Igloohome, TTLock, Wishome 스마트 락에서 자주 발생하는 문제를 해결하는 방법을 안내합니다.

빠른 참고​

보이는 현상발생 이유조치
"Failed to generate lock code"벤더 연결 문제 또는 락 오프라인벤더와 락 상태 확인
Manage PIN이 비활성화됨객실이 아직 배정되지 않았거나, 객실 데이터가 아직 동기화되지 않았거나, 객실이 락에 매핑되지 않음Room Access를 연 뒤 새로고침
PIN은 생성됐지만 락에서 작동하지 않음PIN이 락에 동기화되지 않았거나 브리지가 오프라인벤더 앱에서 PIN 확인
"PIN generation failed for all locks"(Smart Lock Setup)벤더 장애 또는 모든 락에 접근 불가새로고침 후 다시 테스트
Smart Lock Setup에 락이 없음벤더 연결이 안 되었거나 락이 동기화되지 않음새로고침 또는 재연결
게스트가 잘못된 도어 코드를 받음락이 잘못된 객실에 매핑됨객실 매핑 수정
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. AVA에서 Refresh Locks를 클릭합니다.
  3. 문제가 계속되면 Room Access에서 벤더를 다시 연결합니다.
  4. 게스트가 기다리고 있다면 벤더 앱에서 수동 코드를 발급하거나 물리 키를 사용합니다.

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

보이는 현상: AVA는 PIN 코드를 성공적으로 생성했지만, 게스트가 문을 열 때 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으로 객실 1개를 다시 테스트합니다.
  3. 모든 테스트가 실패하면 Room Access에서 벤더를 다시 연결합니다.

Smart Lock Setup에 락이 보이지 않음​

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

해결 방법:

  1. 벤더 계정이 연결되어 있는지 확인합니다.
  2. Refresh Locks를 클릭합니다.
  3. 벤더 앱에서 락이 보이고 선택한 벤더와 일치하는지 확인합니다.

잘못된 객실이 락에 매핑됨​

보이는 현상: 게스트에게 잘못된 객실 코드가 제공됩니다.

해결 방법:

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

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

  3. 객실을 선택하고 잘못된 락을 제거합니다.

  4. 올바른 락을 할당합니다.

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

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)
  • 영향을 받는 락 수
  • 오류 메시지 스크린샷

관련 가이드​