키카드 인코더 설정
인코더 유형을 선택하고, 해당되는 경우 연결 방식을 고른 뒤 인코더를 추가하세요. 약 15분을 예상하면 됩니다.
이 가이드는 키오스크 또는 프런트 데스크용 인코더 우선 키카드 인코딩을 구성하는 방법을 안내합니다.
빠른 참고
| 작업 | 기능 | 클릭 위치 |
|---|---|---|
| Select method | 키카드 인코딩을 활성화합니다 | Room Access → Key Card Encoding (Kiosk) |
| Choose encoder type | 잠금 시스템을 선택합니다 | Encoder Type |
| Choose connection method | Direct 또는 Windows Agent(Saflok/Be-Tech/GreatLocks) 방식을 선택합니다 | Advanced options → Enable direct communication |
| Configure encoder | 서버 또는 자격 증명 정보를 추가합니다 | 유형별 필드 |
| Add encoders | 실제 encoder ID가 있는 물리 장치를 등록합니다 | Physical Encoder Devices |
| Choose kiosk routing | 키오스크 전용 라우팅 규칙을 제어합니다 | Kiosk to Encoder Routing → Enable guest selection |
| Download Windows Agent | Agent를 등록하고 설치합니다(Windows Agent 전용) | Windows Agent |
| Manage agent cards | 메인 카드에는 설치 또는 재설치만 표시됩니다 | Windows Agent |
| Advanced agent actions | 로그 보기, 시크릿 회전, 에이전트 삭제 | Advanced options |
| Set encoding defaults | 카드 수와 만료 시간을 설정합니다 | Encoding Options |
위치
Settings → Room Access → Key Card Encoding (Kiosk)1단계: 키카드 방식 선택
- Settings → Room Access로 이동합니다.
- 객실 출입 방식으로 **Key Card Encoding (Kiosk)**를 선택합니다.
- Save를 클릭합니다.
2단계: 인코더 유형 선택
-
Keycard Encoder Settings로 스크롤합니다.
-
Saflok, Be-Tech, GreatLocks, 또는 PMS Integration을 선택합니다.
✓ AVA는 선택한 인코더 유형만 활성화합니다.
3단계: 연결 방식 선택(Saflok + Be-Tech + GreatLocks 전용)
- Select Encoder Type에서 Advanced options를 엽니다.
- Windows Agent를 우회하려면 Enable direct communication을 켭니다.
- Windows Agent를 사용하려면 끈 상태로 둡니다(기본값).
- PMS Integration을 선택했다면 이 단계는 건너뜁니다.
4단계: 인코더 시스템 구성
인코더를 여러 대 사용할 경우 섹션 제목이 Encoder Credentials & Devices로 표시됩니다.
Saflok을 사용하는 경우
- Direct communication
- PMSI Server URL, Username, Password를 입력합니다.
- PMSI 서버는 인터넷에서 접근 가능해야 합니다.
- Test Connection을 클릭합니다.
- Windows Agent
- Username과 Password만 입력합니다.
- PMSI URL과 연결 테스트는 Agent가 처리합니다.
- Physical Encoder Devices에 인코더 장치를 추가합니다(Encoder ID 필요).
- 선택 사항으로 각 인코더의 Location을 설정합니다.
- 여러 키오스크가 인코더를 공유하면 Kiosk to Encoder Routing 규칙을 추가합니다(Kiosk ID는 Kiosk Management에서 가져옵니다).
Be-Tech을 사용하는 경우
- Direct communication
- Be-Tech 서비스의 Base URL을 입력합니다.
- 서비스는 인터넷에서 접근 가능해야 합니다.
- Hotel Name, Chain No, Workstation, Reader No를 입력합니다.
- Be-Tech 설정에 필요하면 Category와 Card Type을 설정합니다.
- 인코더가 응답하는지 확인하려면 Test Connection을 클릭합니다.
- Windows Agent
- Hotel Name, Chain No, Workstation, Reader No를 입력합니다.
- base URL과 연결 테스트는 Agent가 처리합니다.
- Physical Encoder Devices에 인코더 장치를 추가합니다.
- 인코더를 여러 대 사용하는 경우 Kiosk to Encoder Routing 규칙을 추가할 수 있습니다.
GreatLocks를 사용하는 경우
- Direct communication
- Server Name(선택 사항), XHLSI Server IP Address, TCP Port를 입력합니다.
- 서버는 인터넷에서 접근 가능해야 합니다.
- GreatLocks는 서버당 인코더 1대만 지원합니다.
- Test Connection을 클릭합니다.
- Windows Agent
- 서버 세부 정보는 Agent가 처리하므로 IP/port 입력이 필요 없습니다.
- GreatLocks는 서버당 인코더 1대만 지원합니다.
PMS Integration을 사용하는 경우
- PMS 연동이 활성 상태인지 확인합니다(Cloudbeds 또는 Opera).
- Physical Encoder Devices에서 다음 중 하나를 수행합니다.
- Load Encoders를 클릭한 뒤 Add Selected를 클릭하거나,
- Add Encoder를 클릭해 Encoder ID와 PMS Encoder ID를 입력합니다.
- 불러온 장치는 이제 제공업체 encoder ID를 직접 유지합니다.
- 사용하지 않을 인코더는 Active를 꺼서 비활성화합니다.
5단계: 키오스크 라우팅 설정(선택 사항)
이 섹션은 키오스크 전용 라우팅 동작에만 사용합니다.
-
Kiosk to Encoder Routing을 엽니다.
-
키오스크에서 게스트가 인코더를 선택하게 하려면 Enable guest selection을 켭니다.
-
끈 상태로 두면 각 키오스크에 대해 Kiosk to Encoder Routing 규칙을 추가할 수 있습니다.
✓ 게스트 선택을 켜면 AVA가 수동 라우팅 규칙을 숨깁니다. ⚠️ 그래도 Physical Encoder Devices에는 최소 1개의 인코더 장치를 추가해야 합니다. ✓ AVA는 키오스크 매핑 없이도 encoderId를 사용해 인코딩 요청을 보낼 수 있습니다.
운영에서의 인코더 선택 동작
- 온라인 인코더가 정확히 1대면 AVA가 자동 선택합니다.
- 온라인 인코더가 여러 대면 직원이 명시적으로 하나를 선택해야 합니다.
Online은 인코더의 장치 상태와 Agent 터널이 모두 정상이라는 뜻입니다. 연결이 활성화된 뒤에만 Status: 줄에 online이 표시됩니다. 인코더가 오프라인으로 떨어지면 먼저 Agent나 터널 문제를 해결하세요.
6단계: Windows Agent 설정(Windows Agent 전용)
Direct communication을 켜지 않았다면 Windows Agent를 설치합니다.
-
Windows Agent로 이동합니다.
-
새 카드에서는 Download Windows Agent를, 기존 카드에서는 Reinstall을 클릭합니다.
-
인코더에 연결된 Windows PC에 Agent를 설치합니다.
-
상태가 Not connected이면 zip을 풀고
.bat파일을 실행합니다.✓ Agent가 상태 정보와 함께 Registered Agents에 표시됩니다. ✓ AVA는 인코더 사용 가능 여부를 판단할 때 이 실시간 상태를 사용합니다.
메인 카드에는 Download Windows Agent와 Reinstall만 표시됩니다. Advanced options에서 View Logs, Rotate Secret, 또는 Delete를 사용할 수 있습니다.
7단계: 기본 인코딩 값 설정
- Number of Cards to Encode를 설정합니다(보통 1~2장).
- Keycard Expiration Time을 설정합니다(기본값: 11:00 AM). 이 시간은 수동 키카드 인코딩에서 Valid Until에 미리 채워집니다.
선택 사항으로 Advanced options를 펼쳐 Heartbeat Monitor를 활성화할 수 있습니다.
선택 사항: PMS 객실을 인코더 이름에 매핑
인코더가 PMS와 다른 객실 이름을 사용한다면:
- 키카드 객실 매핑을 사용하세요.
문제 해결
인코더가 응답하지 않거나 카드 인코딩이 실패하면 전체 점검 목록을 확인하세요.
계속 문제가 있나요?
다음 경우 success@vouch-technologies.com으로 문의하세요.
- ❌ 인코더 설정은 저장되지만 장치가 계속 오프라인 상태
- ❌ 어떤 객실에도 카드 인코딩이 되지 않음
- ❌ Registered Agents에서 Agent가 온라인으로 표시되지 않음
함께 보내면 좋은 정보:
- 인코더 유형과 모델
- Keycard Encoder Settings 스크린샷
- 문제가 시작된 시간