본문으로 건너뛰기

키오스크 설정

빠른 설정

먼저 디바이스 행을 만드세요. 그런 다음 해당 행에서 Enroll Device를 사용해 QR을 생성합니다. 대부분의 팀은 약 3분이면 끝냅니다.

이 가이드는 Mini MDM 디바이스 행을 만들고, Android 키오스크와 브라우저 디바이스를 등록하고, 접근 디바이스에 연결하고, 키오스크 디바이스에서 화상 통화를 시작하고, Settings → Kiosk에서 관리하는 방법을 안내합니다. 키오스크 모드는 Android 디바이스와 유연한 브라우저 디바이스를 지원합니다. mini_mdm:read 권한이 있으면 키오스크 상태를 볼 수 있습니다. 디바이스 행 생성, 디바이스 등록, 키오스크 작업 실행에는 mini_mdm:manage 권한이 필요합니다. Mini MDM Device ID는 각 키오스크 기록의 고정 행 ID입니다. 이를 사용해 물리적 키오스크와 특정 디바이스 행을 연결하세요. AVA는 키오스크 라우팅 행을 Mini MDM Device ID 기준으로 저장합니다. 이전 디바이스 ID 매핑이 남아 있어도, 저장할 때 AVA가 이를 유지합니다. 등록은 이제 Create Device에서 시작합니다. 그다음 잠긴 게스트 키오스크 또는 유연한 브라우저 디바이스를 선택합니다.

이동 경로: Settings → Kiosk

빠른 참조​

설정제어 내용직원 사용 목적
Kiosk access permissions보기 전용 또는 관리 권한 제어누가 디바이스 작업을 실행할지 결정
Create Device아직 완료되지 않은 논리적 키오스크 행 추가등록 전에 슬롯 예약
Choose device setup잠금형 또는 브라우저 디바이스 선택기를 염올바른 디바이스 유형을 먼저 고름
Enroll Device단일 키오스크 행용 일회성 QR 생성이미 알려진 디바이스 슬롯 1개 등록
Create locked-down device관리형 게스트 체크인 태블릿을 추가함디바이스를 키오스크 모드로 고정
Create flexible browser device브라우저로 연결되는 직원 디바이스를 추가함디바이스에서 일반 브라우저 접근을 유지
Mini MDM Device ID고정 키오스크 행 ID를 보여줌특정 키오스크 슬롯 추적
Scope행 유형을 보여줌Per-device 행 구분
Unlock Code현재 잠금 해제 코드를 보여줌잠긴 디바이스 복구
Devices list모든 페이지의 등록 디바이스 상태를 보여줌상태 및 마지막 동기화 확인
Device routing키오스크를 접근 및 결제 디바이스에 연결라우팅 최신 상태 유지
Call경고 프롬프트 후 키오스크 디바이스로 화상 통화를 시작함직원이 도움이 필요할 때 키오스크에 연락
Auto-refreshing…QR과 작업 이후 디바이스 업데이트를 조회함등록 또는 작업 결과 확인
Device actions재시작, 잠금, 잠금 해제, 등록 해제원격 제어 및 복구

키오스크 권한 접근​

권한할 수 있는 일할 수 없는 일
mini_mdm:readSettings → Kiosk 열기, 디바이스 목록 보기, 상태 확인디바이스 생성, 등록, 잠금 해제 코드 표시/복사, 재시작, 잠금, 잠금 해제, 등록 해제, 제거, 라우팅 변경 저장
mini_mdm:manage전체 키오스크 관리 접근N/A

mini_mdm:read만 있으면 페이지는 보기 전용 모드로 유지됩니다. 또한 관리 권한이 필요하다는 배너가 표시됩니다.

등록 흐름 선택​

목표사용할 작업표에 표시되는 범위
알려진 키오스크 슬롯 1개 등록먼저 Create Device, 그다음 Locked-down check-in device 선택Per-device
공유 직원 브라우저 설정먼저 Create Device, 그다음 Flexible browser device 선택Flexible
사용하지 않는 사전 생성 슬롯 제거완료되지 않은 행에서 RemovePer-device
등록 흐름

상단 카드에서는 이제 디바이스 생성만 시작합니다. 행이 생성되기 전에 선택기에서 디바이스 유형을 고릅니다. 잠긴 디바이스가 만들어진 뒤 해당 행에서 QR을 생성합니다.

단계별: 잠금형 디바이스 만들기​

  1. Settings → Kiosk로 이동합니다.
  2. 등록 카드에서 Create Device를 클릭합니다.
  3. Choose device setup에서 Locked-down check-in device를 클릭합니다.
  4. 선택 사항: Front Desk 1 같은 레이블을 입력합니다.
  5. Create locked-down device를 클릭합니다.

✓ 상태가 Unfulfilled인 새 행이 표시됩니다. ✓ 행에 Mini MDM Device ID가 표시됩니다. ✓ 행에는 Enroll Device와 Remove만 표시됩니다.

단계별: 유연한 브라우저 디바이스 만들기​

  1. Settings → Kiosk로 이동합니다.
  2. 등록 카드에서 Create Device를 클릭합니다.
  3. Choose device setup에서 Flexible browser device를 클릭합니다.
  4. 선택 사항: Front Desk Browser 같은 디바이스 별칭을 입력합니다.
  5. Create flexible browser device를 클릭합니다.

✓ 새 브라우저 디바이스 행이 표시됩니다. ✓ Streamliner가 일회성 확인 링크를 제공합니다. ✓ 링크는 AVA 프런트엔드를 열고 가맹점 ID를 포함합니다. ✓ 실제 브라우저 디바이스에서 그 링크를 열어 페어링합니다.

가맹점 맥락

확인 링크는 이제 레거시 체크인 흐름이 아니라 AVA 프런트엔드를 사용합니다. mid가 포함되어 있어 AVA 셸이 올바른 가맹점을 먼저 불러올 수 있습니다.

단계별: 디바이스 등록​

공장 초기화 필수

등록하려면 공장 초기화된 디바이스가 필요합니다. 디바이스의 모든 데이터가 삭제됩니다.

  1. 디바이스를 공장 초기화합니다.
  2. 디바이스를 켠 뒤 화면을 6번 탭하여 QR 스캐너를 엽니다.
  3. 일치하는 행에서 Enroll Device를 클릭합니다.
  4. Enroll Device QR Code 모달의 QR을 스캔합니다.
  5. 디바이스 설정 단계를 완료합니다.
  6. Settings → Kiosk로 돌아가 Refresh를 클릭합니다.

✓ 행의 상태가 Enrolled로 바뀝니다. ✓ 행에 이제 Restart, Lock, Unlock, Un-enroll이 표시됩니다. ✓ QR은 일회성 사용이며 3시간 동안 유효합니다.

단계별: 잠금 해제 코드 보기​

  1. Unlock Code 카드를 찾습니다.
  2. Show를 클릭해 코드를 표시합니다.
  3. Copy code를 클릭해 복사합니다.

✓ “Unlock code copied” 메시지가 표시됩니다.

단계별: 디바이스 관리​

목록 새로고침​

  1. Devices 헤더에서 Refresh를 클릭합니다.

✓ “Refreshed (synced X, removed Y)” 메시지가 표시됩니다. ✓ 디바이스가 많은 숙소의 경우 목록이 모든 페이지를 자동으로 불러옵니다.

재시작, 잠금, 잠금 해제​

  1. 디바이스 행을 찾습니다.
  2. Restart, Lock, Unlock 중 하나를 클릭합니다.

✓ “Action completed” 메시지가 표시됩니다. ✓ 새 상태를 확인하기 위해 페이지가 잠시 Auto-refreshing… 상태가 됩니다.

키오스크 디바이스로 통화 시작​

확인 전에

통화 모달에는 이제 황색 경고 상자가 표시됩니다. 이 통화가 해당 키오스크의 투숙객 활동을 방해할 수 있음을 알려줍니다.

  1. 등록된 디바이스 행을 찾습니다.

  2. Call을 클릭합니다.

  3. 모달의 경고를 확인합니다.

  4. Start call을 클릭합니다.

    ✓ Streamliner가 해당 키오스크 디바이스로 화상 통화를 시작합니다. ✓ 백오피스에서 키오스크에 연락해야 할 때 사용합니다. ✓ 경고는 진행 중인 투숙객 활동을 방해할 수 있음을 상기시킵니다.

디바이스 등록 해제​

등록 해제는 디바이스를 초기화할 수 있음

등록 해제 과정에서 디바이스가 공장 초기화될 수 있습니다.

  1. Un-enroll을 클릭합니다.
  2. 경고를 확인합니다.

✓ 새로고침 후 디바이스가 목록에서 사라집니다.

디바이스 라우팅​

Device Routing 카드를 사용해 등록된 각 키오스크를 올바른 객실 출입 인코더와 결제 단말에 연결합니다. 저장된 라우팅 행은 Mini MDM Device ID를 정식 키로 사용합니다. AVA는 오래된 행을 업데이트할 때 기존 별칭, 메모, 인코더 링크, 단말 링크를 유지합니다.

  1. Device Routing까지 스크롤합니다.
  2. 최소 1개의 키오스크 디바이스가 등록되어 있는지 확인합니다.
  3. 디바이스 행을 펼칩니다.
  4. 연결할 Room Access Encoder와 Payment Terminals를 선택합니다.
  5. Save mappings를 클릭합니다.

✓ 디바이스 행에 연결된 인코더와 단말 수가 표시됩니다. ✓ 아직 등록된 디바이스가 없으면 카드에는 라우팅 행 대신 빈 상태가 표시됩니다. ✓ 읽기 전용 사용자는 라우팅 데이터를 볼 수 있지만 편집하거나 저장할 수는 없습니다.

이전 디바이스 ID가 계속 보일 때​

보이는 현상: 저장한 뒤에도 행이 이전 Android 디바이스 ID를 사용합니다.

해결 방법:

  1. Refresh를 클릭합니다.
  2. 같은 디바이스 행을 다시 엽니다.
  3. Save mappings를 한 번 더 클릭합니다.
  4. 이제 행에 Mini MDM Device ID가 표시되는지 확인합니다.

문제 해결​

QR 코드가 생성되지 않음​

보이는 현상: Enroll Device를 클릭한 뒤 빨간 오류 메시지가 표시됩니다.

해결 방법:

  1. 페이지를 새로고침합니다.
  2. 같은 행에서 Enroll Device를 다시 엽니다.
  3. 그래도 실패하면 지원팀에 문의합니다.

Devices 목록이 비어 있음​

보이는 현상: 등록 후에도 “No devices enrolled yet.”가 표시됩니다.

해결 방법:

  1. Refresh를 클릭합니다.
  2. 최소 한 번의 자동 새로고침 주기가 끝날 때까지 페이지를 열어 둡니다.
  3. 디바이스 설정이 끝났는지 확인합니다.
  4. 여전히 비어 있으면 한 번 더 새로고침합니다.

Device routing에 아직 디바이스가 없음​

보이는 현상: Device Routing 카드에 “No enrolled devices yet.”가 표시됩니다.

해결 방법:

  1. 디바이스를 먼저 하나 이상 등록합니다.
  2. Devices 섹션에서 Refresh를 클릭합니다.
  3. Device Routing으로 돌아가 새 디바이스 행을 펼칩니다.

작업 실행 실패​

보이는 현상: Restart, Lock, 또는 Unlock 후 “Action failed”가 표시됩니다.

해결 방법:

  1. 디바이스가 온라인인지 확인합니다.
  2. 작업을 다시 시도합니다.
  3. 목록을 새로고침하고 상태를 확인합니다.

행에 Enroll Device와 Remove만 표시됨​

보이는 현상: 행에서 Enroll Device와 Remove만 보입니다.

해결 방법:

  1. 해당 행의 Status를 확인합니다.
  2. 상태가 Unfulfilled라면 이는 정상입니다.
  3. Enroll Device를 클릭하고 설정을 완료합니다.
  4. Refresh를 클릭해 상태가 Enrolled로 바뀌었는지 확인합니다.

Kiosk 버튼이 비활성화됨​

보이는 현상: Create Device, Show, Copy code, 또는 디바이스 작업 버튼이 비활성화됩니다.

해결 방법:

  1. 역할에 mini_mdm:manage가 포함되어 있는지 확인합니다.
  2. mini_mdm:read만 있다면 관리자에게 역할 권한 업데이트를 요청합니다.
  3. 권한 변경 후 페이지를 새로고침합니다.

Auto-refreshing이 사라지지 않음​

보이는 현상: **Auto-refreshing…**이 예상보다 오래 표시됩니다.

해결 방법:

  1. 폴링 창이 끝날 수 있도록 45초 기다립니다.
  2. Refresh를 한 번 클릭합니다.
  3. 반복되면 키오스크 디바이스의 네트워크 안정성을 확인합니다.

Unfulfilled 행이 계속 등록되지 않음​

보이는 현상: QR을 스캔한 뒤에도 행이 Unfulfilled 상태로 남습니다.

해결 방법:

  1. Refresh를 클릭합니다.
  2. 같은 행에서 Enroll Device를 다시 엽니다.
  3. 올바른 디바이스 행을 사용했는지 확인합니다.
  4. 그래도 실패하면 지원팀에 문의합니다.

확인 링크가 AVA를 열지 않음​

보이는 현상: 브라우저 디바이스가 잘못된 앱을 열거나 가맹점 오류를 표시합니다.

해결 방법:

  1. 브라우저 디바이스 링크를 다시 생성합니다.
  2. 링크에 mid=<merchantId>가 포함되어 있는지 확인합니다.
  3. 새 링크를 실제 브라우저 디바이스에서 엽니다.
  4. 그래도 잘못된 흐름이 열리면 지원팀에 문의합니다.

계속 막히나요?​

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

  • ❌ 여러 번 시도해도 QR 생성이 실패함
  • ❌ 등록 후에도 디바이스가 나타나지 않음
  • ❌ 작업이 10분 이상 실패함

포함하면 도움이 되는 정보:

  • 디바이스 모델 및 일련번호
  • 오류 메시지 스크린샷
  • 문제가 시작된 시간

관련 가이드​