Mews PMS 통합 설정
대부분의 호텔은 Access Token만 있으면 됩니다. 보통 약 10분이면 끝납니다.
이 가이드는 AVA를 Mews에 연결하여 예약과 투숙객 세부 정보가 올바르게 동기화되도록 돕습니다.
위치 확인
Settings → Essentials → Property Management System (PMS) Integration빠른 참고
| 설정 | 제어 항목 | 사용할 때 |
|---|---|---|
| Access Token | AVA와 Mews 연결 | 항상 |
| Advanced → Client Token | 고급 연결 자격 증명 | 지원팀이 요청할 때만 |
| Advanced → Client ID | Mews에서의 숙소 식별자 | 지원팀이 요청할 때만 |
| Advanced → Demo Mode | 테스트용 샌드박스 엔드포인트 사용 | 테스트 환경에서만 |
시작하기 전에
다음이 필요합니다.
- Mews 관리자 영역 접근 권한
- AVA 통합용 Access Token / Token ID
- AVA에서 PMS 설정을 업데이트할 관리자 권한
Access Token이 없다면 Mews 관리자 또는 AVA 지원팀에 문의하세요.
Mews Access Token 가져오기
Mews에서 다음 단계를 따르세요.
-
Mews PMS에 로그인합니다.
-
사이드바에서 Marketplace를 클릭합니다.
-
My Subscriptions를 클릭합니다.
-
Vouch AVA Front Desk Agent를 찾습니다.
-
Edit를 클릭합니다.
-
Access Token 섹션을 엽니다.
-
Token ID를 복사합니다.
토큰을 잃어버리지 않도록 바로 AVA에 붙여넣으세요.
구성 단계
1단계: Mews 선택
- Settings → Essentials → PMS Integration로 이동합니다.
- Mews 카드를 클릭합니다.
- Mews 구성 양식이 나타납니다.
2단계: Access Token 입력
- Mews의 Token ID를 Access Token 필드에 붙여넣습니다.
- 보안을 위해 저장 후 토큰은 숨김 처리됩니다.
나중에 돌아와서 마스킹된 문자가 보여도 그대로 두고 Save를 클릭하세요. AVA는 저장된 Access Token, Client Token, Client ID를 유지합니다.
Advanced Mews 설정이 필요한 경우(지원팀 전용)
- Advanced를 클릭합니다.
- 지원팀이 제공한 값을 입력합니다.
- Client Token
- Client ID
- 선택 사항: 샌드박스 엔드포인트로 테스트 중이라면 Demo Mode를 켭니다.
지원팀이 요청하지 않는 한 Advanced 값을 변경하지 마세요. 잘못된 값은 동기화를 중단할 수 있습니다.
3단계: 저장
- 페이지 하단에서 Save를 클릭합니다.
- 성공 메시지를 확인합니다.
- 비밀 정보를 보호하기 위해 Access Token 필드에는 플레이스홀더가 표시됩니다.
연결 후 발생하는 일
- ✅ AVA가 예약과 투숙객 세부 정보에 Mews 데이터를 사용하기 시작합니다
- ✅ Access Token 필드에 마스킹된 문자가 표시됩니다
- ✅ 나중에 토큰을 업데이트해야 하면 Edit Token을 사용합니다
투숙객 및 직원에게 미치는 영향
- 투숙객 양식은 Mews 규칙에 맞춰 조정됩니다. 필수 필드와 숨김 필드는 Mews 설정에 따라 바뀌므로 투숙객은 필요한 내용만 보게 됩니다.
- 예약 조회는 Mews를 사용합니다. Mews가 설정되지 않으면 투숙객 조회 단계가 실패합니다.
문제 해결
"Access Token is required" 오류
보이는 내용: "Access Token is required"
해결:
- Mews의 Token ID를 붙여넣습니다.
- Save를 다시 클릭합니다.
- 저장되면 오류가 사라집니다.
토큰은 저장됐지만 데이터가 동기화되지 않음
보이는 내용: 토큰은 저장했지만 예약이 나타나지 않습니다.
해결:
- 첫 동기화를 위해 10-15분 기다립니다.
- 페이지를 새로고침하고 Mews가 여전히 선택되어 있는지 확인합니다.
- Mews 관리자에게 AVA 구독이 활성 상태인지 확인해 달라고 요청합니다.
- 문제가 계속되면 AVA 지원팀에 문의합니다.
새로고침 후 마스킹된 필드가 다시 보임
보이는 내용: 페이지를 다시 불러오면 Access Token 또는 고급 필드에 마스킹된 문자가 보입니다.
해결:
- 마스킹된 값은 그대로 둡니다.
- Save를 다시 클릭합니다.
- ✅ AVA가 저장된 Mews 자격 증명을 유지합니다.
Client Token, Client ID, Demo Mode를 찾을 수 없음
보이는 내용: Client Token, Client ID, Demo Mode 필드가 보이지 않습니다.
해결:
- Advanced를 클릭합니다.
- ✅ 고급 필드가 Advanced 섹션 안에 나타납니다.
Demo Mode가 켜져 있는데 동기화가 이상함
보이는 내용: 예약이 누락되거나 예상치 못한 테스트 데이터가 보입니다.
해결:
- Demo Mode를 끕니다.
- Save를 클릭합니다.
- 페이지를 새로고침하고 연결 상태를 확인합니다.
- 문제가 계속되면 지원팀에 문의합니다.
확인 체크리스트
- Select PMS Provider에서 Mews가 선택됨
- Access Token이 오류 없이 입력되고 저장됨
- 새로고침 후 Access Token 필드에 마스킹된 문자가 표시됨
- 예약이 Mews에서 동기화되기 시작함
아직 막혔나요?
다음에 해당하면 success@vouch-technologies.com으로 문의하세요.
- ❌ 15분이 지나도 동기화가 시작되지 않음
- ❌ 해결할 수 없는 저장 오류가 표시됨
- ❌ Advanced 설정이 필요한데 값이 없음
함께 보내면 좋은 정보:
- PMS Integration 섹션 스크린샷
- 사용 중인 PMS 제공업체(Mews)
- 정확한 오류 문구가 있다면 그 내용