문서 이름 매칭 정책 설정

빠른 설정

처음에는 Balanced 모드로 시작하세요. 대부분의 호텔은 3분 이내에 설정을 완료합니다.

이 가이드에서는 AVA가 예약 이름과 여권 또는 ID 이름을 얼마나 엄격하게 비교할지 제어하는 방법을 설명합니다.

찾는 위치

Settings → Security → General Settings → Document Name Matching

정책에는 Reservation Lookup과 Document Upload라는 두 개의 탭이 있습니다. 설정하려는 체크인 단계에 해당하는 탭을 선택하세요. AVA는 현재 활성화된 정책 패널만 표시합니다.

각 정책의 적용 위치

탭	적용 대상
Reservation Lookup	예약 조회 중 여권 조회 및 해당 문서 첨부
Document Upload	체크인 중 개별 여권 업로드 및 해당 이름 확인

선택한 모드와 임계값은 해당 탭의 모든 매칭 확인에 적용됩니다. 예약 이름 확인 후 게스트가 다시 시도하는 경우에도 적용됩니다.

빠른 참고

설정	제어하는 항목	일반적인 결과
Strict	가장 높은 매칭 엄격도	더 많은 게스트가 프런트 데스크 검토로 이동
Balanced	기본 매칭 엄격도	보안성을 유지하면서 더 원활한 셀프 체크인
Lenient	더 낮은 매칭 엄격도	더 많은 축약 이름이 자동 통과
Custom	수동 임계값 및 규칙	설정한 값에 따라 결과가 달라짐

부칭 이름

Strict 모드는 bin, binti, binte, bte, S/O, D/O와 같은 부칭 표기가 생략된 이름을 허용합니다. 그래도 안전하지 않은 부분 매칭은 차단합니다.

원문 스크립트 매칭

두 이름을 같은 스크립트로 사용할 수 있는 경우 AVA는 먼저 해당 원문 스크립트 텍스트를 비교합니다. 이렇게 하면 선택한 모드를 변경하지 않고도 태국어 및 CJK 예약의 매칭 정확도가 향상됩니다.

서로 다른 스크립트의 이름

이름이 서로 다른 스크립트를 사용하는 경우 AVA는 토큰 포함 여부를 확인하기 위해 결정적인 음역도 검사합니다. 이를 통해 짧은 음역 토큰 하나만으로 불완전한 Lenient 매칭이 승인되는 것을 방지합니다. 정확한 원문 스크립트 매칭은 계속 허용됩니다.

강력한 성 보호

문서에 성이 포함되어 있으면 AVA는 예약 성이 선택한 정책 임계값을 충족하도록 요구합니다. 이름이 같은 것만으로는 성이 다른 예약을 승인하지 않습니다. 여권에 성이 없고 예약에 다른 이름이 추가된 경우 AVA는 예약 이름 확인으로 해당 사례를 보냅니다.

두 토큰으로 된 문서 이름

문서에 두 토큰이 있는 경우 AVA는 두 토큰 모두에 대해 의미 있는 근거를 요구합니다.

이 보호 규칙은 Balanced, Lenient, Custom 모드에 적용됩니다. 한 토큰 하나만으로 전체 매칭을 결정하지 못하도록 합니다.

두 문서 토큰이 모두 매칭에 나타나면 AVA는 토큰이 합쳐졌거나 순서가 바뀐 매칭도 계속 허용합니다.

성만 일치하는 경우

두 이름 부분을 모두 사용할 수 있는 경우 공통 성만으로는 매칭을 승인할 수 없습니다. 이는 DELA PAZ와 같은 복합 성을 공유하는 게스트를 보호합니다.

유효한 약어, 별칭, 이름 순서 반전 및 원문 스크립트 근거는 두 문서 토큰이 모두 지원될 때 계속 통과할 수 있습니다. 직원이 게스트를 직접 확인할 때 사용할 수 있는 기존 ACI 직원 재정의 기능도 계속 제공됩니다.

이름 쌍	결과	이유
"Alex DELA PAZ" vs "Jordan DELA PAZ"	❌ 검토	공통 성만 매칭을 뒷받침함
"Zilin Zhu" vs "Zhuzilin Zhuzilin"	❌ 검토	한 문서 토큰이 의미 있게 지원되지 않음
"A B" vs "B A"	✓ 통과	순서가 바뀌어도 두 토큰이 모두 존재함
"M Taka" vs "Mitsui Takafumi"	✓ 통과	두 문서 토큰이 여전히 매칭에 나타남

매칭 모드 설정

1. Settings → Security → General Settings로 이동합니다.

2. Document Name Matching에서 Reservation Lookup 또는 Document Upload를 선택합니다.

3. 모드를 선택합니다.

4. 시나리오 미리보기 카드를 검토합니다.

5. Save General Settings를 클릭합니다.

   ✓ 저장하기 전에 활성 탭에 선택한 모드가 표시됩니다. ✓ 선택한 정책이 새 체크인 시도에 적용됩니다.

미리보기 동작

미리보기 카드는 이제 표준으로 선별된 시나리오를 사용합니다. Strict, Balanced, Lenient는 동일한 예시 목록을 표시합니다. 결과는 CCI의 토큰 수준 점수와 두 토큰 안전 보호 규칙을 따릅니다.

Custom 모드 조정

팀에 정해진 검토 SOP가 있을 때 Custom 모드를 사용하세요.

1. Reservation Lookup 또는 Document Upload를 선택합니다.
2. Custom을 선택합니다.
3. Base similarity threshold를 설정합니다(80-95).
4. 다음 항목을 허용할지 선택합니다.
   • Initial + surname prefix matching
   • Alias name matching
5. 약어 제어를 설정합니다.
   • Minimum surname prefix length (3-6)
   • Minimum surname coverage (0.30-0.80)
   • Require two tokens
   • Require single-character initial
6. Save General Settings를 클릭합니다.

자동 안전 규칙

AVA는 저장할 때 문서 매칭 값을 정규화합니다.

• 잘못된 모드 값은 Balanced로 재설정됩니다
• Custom 임계값은 80-95 사이여야 합니다
• 최소 성 접두사 길이는 3-6 사이여야 합니다
• 최소 성 포함 범위는 0.30-0.80 사이여야 합니다
• "true" 및 "false" 텍스트 값은 실제 토글로 변환됩니다

✓ 범위를 벗어난 값을 입력하면 AVA가 수정된 값을 저장합니다.

부칭 이름

이름 쌍	Strict	Balanced	Lenient
"AHMAD BIN IBRAHIM" vs "AHMAD IBRAHIM"	✓ 통과	✓ 통과	✓ 통과
"AHMAD IBRAHIM" vs "AHMAD BIN IBRAHIM"	✓ 통과	✓ 통과	✓ 통과
"AHMAD BIN IBRAHIM" vs "AHMAD BIN ABDULLAH"	❌ 검토	❌ 검토	❌ 검토

말레이 여권 이름 단축

빠른 확인

말레이 여권 이름에는 일상적으로 사용하는 짧은 형태가 있을 수 있습니다. Balanced 및 Lenient 모드는 가장 안전한 일반 형태를 지원합니다.

말레이 이름에는 아버지 이름 앞에 bin, binti, binte 또는 bte가 포함될 수 있습니다. 예약에서는 일반적인 짧은 형태인 B와 Bt를 포함하여 해당 관계 단어를 생략할 수 있습니다.

AVA는 다음과 같은 일반적인 접두사 변형을 인식합니다.

• Mohd, Muhd, Md, Mohamad를 Muhammad의 형태로 인식
• Abd, Ab를 Abdul의 형태로 인식
• Noor, Nor를 Nur의 형태로 인식
• Hj를 Haji의 형태로 인식

승인된 게스트 접두사에는 Ahmad, Nurul, Siti도 포함됩니다. Abdul 및 Haji는 아버지 이름 앞에 올 때 승인됩니다. Wan, Nik, Tengku, Raja, Syed, Megat, Che와 같은 세습 칭호는 절대 생략되지 않습니다.

AVA는 게스트의 이름에서 승인된 접두사를 최대 하나까지 생략할 수 있습니다. 아버지 이름에서도 승인된 접두사 하나를 생략할 수 있습니다. 게스트 이름의 나머지 부분은 여전히 강하게 매칭되어야 합니다.

Strict 및 Custom 모드에서는 이러한 생략 예외를 사용하지 않습니다. AVA는 예약 조회, 문서 업로드, 스테이징 제안 및 스테이징된 커밋 검증에 동일한 매처를 적용합니다.

허용되는 말레이 여권 예시

여권 이름	예약 이름	Strict	Balanced	Lenient
MUHAMMAD ZAHID BIN MOHD ZAKRI	Zahid Zakri	❌ 검토	✓ 통과	✓ 통과
MUHAMMAD ZAHID BIN MOHD ZAKRI	Muhd Zahid Zakri	❌ 검토	✓ 통과	✓ 통과
MUHAMMAD ZAHID BIN MOHD ZAKRI	Zahid Bin Zakri	❌ 검토	✓ 통과	✓ 통과
MUHAMMAD ZAHID BIN MOHD ZAKRI	Muhammad Zahid Bin Mohd Zakri	✓ 통과	✓ 통과	✓ 통과

예약에서는 관계 단어를 유지하거나 생략할 수 있습니다. 관계 단어를 포함하는 경우 여권과 동일한 관계 단어를 사용하세요. 그 앞에는 게스트 이름을, 뒤에는 아버지 이름을 적습니다.

안전하지 않은 말레이 여권 단축형

AVA는 일반적인 접두사와 아버지 이름만으로 식별되는 예약을 거부합니다. 이는 아버지나 형제가 게스트로 통과하는 것을 방지합니다.

이름 쌍	Strict	Balanced	Lenient
MUHAMMAD ZAHID BIN MOHD ZAKRI vs Muhammad Zakri	❌ 검토	❌ 검토	❌ 검토
MUHAMMAD ZAHID BIN MOHD ZAKRI vs Ahmad Zakri	❌ 검토	❌ 검토	❌ 검토
MUHAMMAD ZAHID BIN MOHD ZAKRI vs Siti Binti Ahmad	❌ 검토	❌ 검토	❌ 검토
MUHAMMAD ZAHID BIN MOHD ZAKRI vs Zakri Bin Muhammad Zahid	❌ 검토	❌ 검토	❌ 검토

접두사만으로 승인하지 마세요

유효한 게스트 이름이 계속 실패하면 직원에게 여권을 확인하고 예약을 업데이트하도록 요청하세요. 아버지 이름과 일반적인 접두사만 포함된 예약은 사용하지 마세요.

한 줄로 인쇄된 말레이시아 신분증

일부 말레이시아 신분증은 전체 이름을 한 줄에 인쇄합니다. AVA는 해당 줄에서 이름과 성의 구분을 추론할 수 있습니다.

Balanced 및 Lenient 모드에서는 예약에서 승인된 선행 토큰 하나가 생략되어도 AVA가 허용할 수 있습니다. 나머지 문서 토큰은 예약 이름과 정확히 일치해야 합니다.

문서 이름	예약 이름	Balanced 및 Lenient	Strict 및 Custom
MUHAMMAD HAFIZ ABDULLAH	HAFIZ ABDULLAH	✓ 통과	❌ 검토
MOHD AHMAD BIN IBRAHIM	AHMAD BIN IBRAHIM	✓ 통과	❌ 검토
SITI HAFIZ ABDULLAH	HAFIZ ABDULLAH	❌ 검토	❌ 검토
MUHAMMAD AMIR HAMZAH	AMIRA HAMZAH	❌ 검토	❌ 검토

이 예외는 추론된 구분이 있는, 인식된 비여권 문서에만 적용됩니다. 여권, 알 수 없는 문서 유형 또는 선행 토큰 두 개가 생략된 경우에는 적용되지 않습니다.

일반적인 예시

이름 쌍	Strict	Balanced	Lenient
"John Michael Doe" vs "John Michael Doe"	✓ 통과	✓ 통과	✓ 통과
"Jon Smyth" vs "John Smith"	❌ 검토	✓ 통과	✓ 통과
"M Taka" vs "Mitsui Takafumi"	❌ 검토	✓ 통과	✓ 통과
"K Taka" vs "Mitsui Takafumi"	❌ 검토	❌ 검토	❌ 검토
"A Kumar" vs "Arun Kumar"	❌ 검토	✓ 통과	✓ 통과
"HSIEH / YU-CHEN" vs "Hung Yu Chen"	❌ 검토	❌ 검토	❌ 검토

별칭 이름

별칭은 다음 세 가지 조건이 모두 참일 때만 통과할 수 있습니다.

1. Alias name matching이 활성화되어 있습니다.
2. ID가 별칭을 제공합니다.
3. 선택한 모드에서 별칭이 예약과 일치합니다.

주 이름의 성이 서로 다르다는 사실만으로는 통과하지 않습니다.

예약	ID의 주 이름	ID가 제공한 별칭	Balanced 결과
"Alice Tan"	"Alice Lim"	"Alice Tan"	별칭 매칭이 활성화되면 ✓ 통과
"Alice Tan"	"Alice Lim"	None	❌ 검토
"Alice Tan"	"Alice Wong"	"Alice Chen"	❌ 검토
"Alice Tan"	"Alice Lim"	"Alice Tan"	별칭 매칭이 비활성화되면 ❌ 검토

Lenient 활성화 전

Lenient 모드는 프런트 데스크 업무를 줄일 수 있지만 경계선상의 이름 패턴도 더 많이 허용합니다.

문제 해결

검토로 보내지는 게스트가 너무 많음

보이는 내용: 유효한 게스트 중 많은 수가 직원 검토로 이동합니다.

해결 방법:

1. Strict를 Balanced로 변경합니다.
2. Custom에서 임계값을 약간 낮춥니다.
3. OTA 이름이 자주 축약되는 경우 약어 매칭을 활성화합니다.

축약 이름이 너무 많이 통과함

보이는 내용: 짧은 이름에 대해 더 엄격한 심사를 원합니다.

해결 방법:

1. Lenient를 Balanced 또는 Strict로 변경합니다.
2. Custom의 임계값을 높입니다.
3. 성 접두사 길이 또는 포함 범위를 높입니다.

변경 사항이 적용되지 않는 것처럼 보임

보이는 내용: Strict, Balanced, Lenient 또는 Custom을 선택한 후에도 모드 카드가 변경되지 않습니다.

해결 방법:

1. 올바른 탭인 Reservation Lookup 또는 Document Upload를 선택했는지 확인합니다.
2. 모드를 다시 선택합니다.
3. 활성 탭에 선택한 모드가 표시되는지 확인합니다.
4. Save General Settings를 클릭합니다.
5. 페이지를 새로 고치고 새 체크인 흐름으로 테스트합니다.

잘못된 이름 매칭 정책이 변경됨

보이는 내용: 예약 조회와 문서 업로드에서 예상하지 못한 결과가 나타납니다.

해결 방법:

1. Settings → Security → General Settings로 돌아갑니다.
2. Document Name Matching을 엽니다.
3. Reservation Lookup 또는 Document Upload를 선택합니다.
4. 해당 탭의 정책을 검토하고 저장합니다.

✓ AVA는 선택한 체크인 단계에 저장된 정책을 적용합니다.

저장 후 Custom 값이 변경됨

보이는 내용: 저장한 Custom 값이 입력한 값과 다르게 보입니다.

해결 방법:

1. Document Name Matching을 다시 엽니다.
2. 허용되는 범위와 값을 비교합니다.
3. 범위 내의 값을 사용하여 다시 저장합니다.

여전히 해결되지 않나요?

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

• ❌ 다시 시도해도 이름 매칭 결과가 계속 일관되지 않음
• ❌ 설정은 성공적으로 저장되지만 동작이 변경되지 않음
• ❌ 현지 규정 준수 규칙에 맞게 Custom 값을 조정하는 데 도움이 필요함

포함하면 유용한 세부 정보:

• 선택한 모드
• Custom 값(사용한 경우)
• 예약 이름과 문서 이름의 예시 쌍 2-3개

관련 가이드

• Security Overview
• Document Checks
• Facial Verification