본문으로 건너뛰기

챗봇 설정하기

빠른 설정

대부분의 호텔은 약 7분 안에 메시지, 봇 지시문, 라이브 채팅 시간을 설정합니다.

이 가이드에서는 챗봇 메시지, 답변 동작, 액세스 권한, 라이브 채팅 시간을 설정하는 방법을 설명합니다. 투숙객에게 일관된 답변을 제공하고 운영 시간 외 응대를 설정할 때 사용하세요.

이동: Chatbot → Setup

빠른 참고​

작업클릭 위치결과
환영 메시지 설정Bot Configuration → Welcome Message투숙객이 먼저 인사말을 봅니다
기본 답변 설정Bot Configuration → Default Answer일치 항목이 없을 때 투숙객에게 응답합니다
봇의 어조 정의Bot Configuration → Bot Instruction챗봇이 설정한 지침을 따릅니다
답변 엔진 선택Advanced Settings → Answer EngineRAG와 Agent (Pi) 사이를 전환합니다
답변 스타일 조정Advanced Settingstemperature, token cap, retrieval depth, grounding mode를 제어합니다
Skill Mode 활성화Advanced Settings → Skill Mode구성한 Vertex ADK 스킬을 사용해 GenAI 답변을 스트리밍합니다
투숙객 예약 확인 활성화Widget & Access → Guest reservation verification채팅을 시작하기 전에 투숙객이 투숙 정보를 확인합니다
Quick Setup 실행Quick Setup메시지와 어조를 미리 입력합니다
채팅 모드 선택Widget & Access → Chat modeAI, 라이브 채팅 또는 하이브리드를 선택합니다
라이브 채팅 시간 설정Widget & Access → Operating Hours운영 시간에만 직원이 답변합니다
랜딩 페이지 생성Widget & Access → Create Landing Page투숙객 링크와 QR 옵션이 표시됩니다
QR 인쇄 용지 사용자 지정Widget & Access → QR Print Template객실 및 위치 용지가 설정한 디자인을 사용합니다
위젯 도메인 허용Widget & Access → Whitelisted Domains웹사이트에서 위젯이 로드됩니다

플랜 액세스​

  • 챗봇 설정에는 유료 플랜이 필요합니다.
  • 무료 플랜 계정에는 업그레이드 안내가 표시되며 변경 사항을 저장할 수 없습니다.

업그레이드하려면 Settings → Billing & Subscription으로 이동하세요.

시작하기 전에​

다음 요건을 확인하세요.

  • Chatbot 설정을 관리할 권한이 있습니다
  • 플랜에 Chatbot 기능이 포함되어 있습니다
  • 봇이 사용할 어조를 알고 있습니다

봇 메시지 구성​

  1. Chatbot → Setup으로 이동합니다.

  2. Bot Configuration 탭을 그대로 엽니다.

  3. Welcome Message를 짧은 인사말로 업데이트합니다.

  4. Default Answer를 유용한 기본 응답으로 업데이트합니다.

  5. 각 카드 아래에서 Save를 클릭합니다.

    ✓ 성공 메시지가 표시됩니다.

봇 지시문 설정​

  1. Bot Instruction에 어조와 규칙을 설명합니다.

  2. 별도의 규칙이나 예시를 새 줄에 추가하려면 Enter를 누릅니다.

  3. Save를 클릭합니다.

    ✓ 지시문이 저장되고 챗봇에서 사용됩니다.

좋은 지시문 예시

“간결하고 친절하게 답변하세요. 확신이 없으면 후속 질문을 하세요.”

여러 줄 지시문

규칙, 예시 또는 예외를 구분한 여러 줄 지시문을 붙여 넣을 수 있습니다.

고급 답변 설정​

  1. 페이지 헤더에서 Advanced Settings를 클릭합니다.

  2. Answer Engine에서 RAG 또는 **Agent (Pi)**를 선택합니다.

  3. 답변 동작을 확인하려면 Generation 섹션을 검토합니다.

  4. RAG를 선택한 경우 Retrieval 섹션을 검토합니다.

  5. Retrieval에서 Disable grounding RAG engine을 켜거나 끕니다.

  6. 다음 범위 안에서 값을 설정합니다.

    • Temperature: 0부터 1
    • Top P: 0부터 1
    • Max Output Tokens: 500부터 3024
    • Retrieval K: 1부터 7

  7. Disable grounding RAG engine을 켜면 Retrieval K를 1에서 3 사이로 유지합니다.

  8. Save를 클릭합니다.

    ✓ 저장에 성공하면 모달이 닫힙니다.

이 설정이 제어하는 항목

값이 낮을수록 답변이 더 집중됩니다. 값이 높을수록 다양성이 커집니다. RAG는 챗봇 문서와 검색 설정을 사용합니다. **Agent (Pi)**는 모달에서 RAG 전용 제어 항목을 숨깁니다. Disable grounding RAG engine을 켜면 답변 전에 컨텍스트를 직접 미리 가져옵니다. 토큰을 더 사용하지만 검색 신뢰성은 높아집니다. 이 설정은 챗봇 답변과 연결된 음성 흐름에 영향을 줍니다.

Skill Mode 사용​

GenAI 설정에서 Vertex ADK를 통해 답변을 스트리밍해야 할 때 Skill Mode를 사용하세요. Streamliner는 서비스가 시작될 때 설치된 스킬을 동기화합니다. 새 스킬이나 업데이트된 스킬은 보통 다음 배포 후 표시됩니다.

skill 라우팅

Use Skill Mode를 켜면 스킬 기반 채팅 요청이 **Agent (Pi)**로 라우팅됩니다. AVA는 내부적으로 Vertex ADK 스킬을 계속 사용합니다.

  1. Advanced Settings를 클릭합니다.

  2. Use Skill Mode를 켭니다.

  3. booking-assistant와 같은 Skill Name을 입력합니다.

  4. Save를 클릭합니다.

    ✓ Advanced Settings를 다시 열어도 설정이 유지됩니다. ✓ 모달에 스킬 이름이 그대로 유지됩니다.

Skill 이름 규칙

Skill Name에는 소문자, 숫자, 하이픈만 사용할 수 있습니다. Use Skill Mode가 켜져 있으면 이 필드는 필수입니다. Vertex ADK가 뒤에서 skill을 실행합니다.

skill이 표시되지 않는 경우

스킬 패키지를 추가하거나 업데이트한 뒤 관리자에게 Streamliner를 다시 시작해 달라고 요청하세요. 그래도 스킬이 로드되지 않으면 스킬 이름이 패키지 이름과 정확히 일치하는지 확인하세요.

Quick Setup 사용(선택 사항)​

  1. 페이지 헤더에서 Quick Setup을 클릭합니다.
  2. 마법사를 따라 메시지와 어조를 생성합니다.
  3. 필드에 입력된 결과를 검토합니다.
  4. 유지할 각 섹션에서 Save를 클릭합니다.

채팅 모드 선택​

  1. Widget & Access 탭을 엽니다.

  2. 다음 모드 중 하나를 선택합니다.

    • AI only
    • Live chat only
    • Hybrid (AI + live chat)

    ✓ 선택한 모드가 강조되고 적용됩니다.

예약 확인 이해하기​

일부 챗봇 흐름에서는 객실별 도움말을 제공하기 전에 투숙객에게 투숙 정보 확인을 요청합니다. AVA는 Checkout과 동일한 방식으로 일치 여부를 확인하고 해당 예약 신원을 채팅에 유지합니다. 이 기능을 켜면 위젯 미리보기에 본인 확인 양식과 확인 완료 상태가 표시됩니다.

단계AVA가 확인하는 항목결과
객실 조회투숙객의 객실 번호AVA가 해당 객실의 활성 checked-in 또는 due-out 예약 하나를 찾습니다
투숙객 일치투숙객 이름AVA가 일치하는 표준 신원을 반환합니다
연결된 예약채팅에 이미 연결된 예약AVA가 추가 확인 안내를 건너뛰고 저장된 객실을 유지합니다
재확인이전에 확인한 신원AVA가 퍼지 매칭 없이 저장된 신원을 확인합니다
확인된 채팅 액세스이 대화 중 연결된 예약AVA가 투숙객 서비스 요청에 사용할 확인된 투숙 증명을 유지합니다

  1. 먼저 투숙객에게 객실 번호를 요청합니다.

  2. 그런 다음 대표 투숙객의 이름을 요청합니다.

  3. PMS에 표시된 것과 동일한 철자를 사용합니다.

  4. 투숙객이 이미 확인되었다면 다시 묻지 말고 저장된 신원을 재확인합니다.

  5. 투숙객이 새 채팅을 시작할 때까지 연결된 예약을 계속 사용합니다.

    ✓ 투숙객이 이미 예약을 연결했다면 AVA가 해당 예약 신원을 재사용합니다.

    ✓ 확인에는 Checkout과 동일한 객실 및 이름 규칙이 적용됩니다.

일치 동작

예약 확인은 Checkout과 동일한 투숙객 매칭기를 재사용합니다. Checkout의 객실 정렬, 원문 이름 처리, 첫 번째 일치 동작을 유지합니다. 정확히 하나의 활성 checked-in 또는 due-out 예약이 일치할 때만 AVA가 객실을 연결합니다. 활성 일치 항목이 없거나 여러 개이면 예약은 확인되지 않은 상태로 유지됩니다. 연결된 예약을 사용하면 투숙객이 이미 투숙 정보를 연결한 경우 AVA가 두 번째 안내를 건너뛸 수 있습니다. 투숙객이 예약을 바꾸면 AVA가 객실과 이름을 다시 요청합니다.

PMS 호환성

AVA는 연결된 PMS 구성에서 예약 확인 동작을 선택할 수 있습니다. 이 흐름을 위해 PMS 버전을 입력하거나 관리할 필요가 없습니다.

미리보기 확인

Guest reservation verification을 저장한 후 위젯 미리보기를 엽니다. 일반적인 채팅 시작 화면 대신 본인 확인 양식이 표시되어야 합니다.

투숙객 서비스 요청 처리​

확인된 투숙 중인 투숙객은 호텔에서 구성한 서비스를 텍스트 채팅으로 요청할 수 있습니다. 요청 가능한 유형에는 편의시설, 청소, 수하물, 모닝콜, 문제 신고, 피드백 및 기타 서비스가 포함될 수 있습니다.

투숙객의 작업채팅 동작
이용 가능한 서비스 문의채팅에서 확인된 투숙에 사용하도록 설정된 서비스를 나열합니다
서비스 요청 또는 취소요청을 생성하거나 취소하기 전에 채팅에 미리보기를 표시합니다
미리보기 확인이후 명확한 확인을 받은 뒤에만 요청을 제출하며, 투숙객은 내부 요청 필드를 입력하지 않습니다
요청 상태 확인채팅에서 해당 채팅으로 생성된 요청의 상태를 표시합니다
확인이 필요합니다

채팅은 첫 메시지만으로 서비스 요청을 생성하거나 취소하지 않습니다. 투숙객은 이후 메시지에서 정확한 미리보기를 확인해야 합니다. 투숙객이 미리 준비된 요청 식별자나 기타 내부 필드를 제공할 필요는 없습니다. AVA는 서버에 보관된 대기 중인 미리보기에 확인을 연결합니다.

투숙객은 객실 번호가 포함된 현재의 확인된 투숙 상태여야 합니다. 확인되지 않은 투숙객은 일반적인 호텔 문의를 계속할 수 있지만 서비스 요청을 제출할 수는 없습니다. 예약 확인이 완료되면 AVA는 활성 대화에 대해 확인된 투숙 증명을 유지합니다. 그러면 투숙객은 예약을 다시 확인하지 않고 지원되는 서비스 요청을 계속할 수 있습니다.

투숙객 서비스 요청 테스트​

  1. 객실 QR 코드 또는 예약 확인을 통해 테스트 투숙객을 확인합니다.

  2. 이용 가능한 투숙객 서비스를 요청합니다.

  3. 사용 설정된 서비스 하나를 요청합니다.

  4. 미리보기를 검토한 후 별도의 메시지로 확인합니다.

    ✓ 투숙객이 정확한 미리보기를 확인한 후에만 요청이 표시됩니다. ✓ 투숙객은 내부 식별자를 입력하지 않고 표시된 요청을 확인합니다.

투숙객 서비스 요청이 표시되지 않음​

보이는 현상: 확인된 투숙객이 서비스를 요청했지만 채팅에서 요청 흐름을 제공하지 않습니다.

해결 방법:

  1. 투숙객이 체크인했고 객실이 배정되었는지 확인합니다.
  2. 투숙객이 예약 확인을 완료했거나 올바른 객실 QR 코드를 사용했는지 확인합니다.
  3. 요청한 서비스가 호텔에 사용 설정되어 있는지 확인합니다.
  4. 서비스 요청을 테스트할 때 Answer Engine이 **Agent (Pi)**로 설정되어 있는지 확인합니다.

보이는 현상: 투숙객이 예약을 연결했지만 같은 채팅에서 투숙객 서비스를 제공할 수 없습니다.

해결 방법:

  1. 투숙객에게 같은 대화에서 새 메시지를 보내 달라고 요청합니다.
  2. 예약이 체크인 상태이고 객실 번호가 있는지 확인합니다.
  3. Answer Engine이 **Agent (Pi)**로 설정되어 있는지 확인합니다.
  4. 문제가 계속되면 새 채팅을 시작하고 다시 테스트합니다.
  5. 투숙객이 사용 설정된 서비스를 여전히 요청할 수 없으면 지원팀에 문의합니다.

라이브 채팅 시간 설정​

투숙객이 정해진 운영 시간에만 직원에게 연결되게 하려면 라이브 채팅 시간을 사용합니다. 일정은 호텔 시간대를 사용합니다. 운영 시간 외에는 투숙객에게 부재 중 메시지가 표시됩니다. 요일마다 여러 시간 구간을 설정할 수 있습니다.

  1. Widget & Access 탭을 엽니다.

  2. Limit live chat to operating hours를 켭니다.

  3. Timezone 칩을 확인합니다.

  4. 잘못되었다면 Settings → Essentials → Hotel Basic Details에서 Timezone을 업데이트합니다.

  5. 요일별로 운영 시간을 추가합니다.

  6. Copy Mon → weekdays, Copy Mon → all days, Set 24/7, 또는 Clear all을 사용해 빠르게 채웁니다.

  7. 하루가 닫힌 상태로 남아 있으면 Open this day를 사용합니다.

  8. Save changes를 클릭합니다.

    ✓ 상태 pill에 Open now 또는 Closed now가 표시됩니다. ✓ 투숙객은 운영 시간에만 직원에게 연결됩니다. ✓ 운영 시간 외에는 부재 중 메시지가 표시됩니다. ✓ 답변은 최신 일정을 사용합니다. ✓ 잘못된 시간은 빨간 테두리와 도움말 텍스트로 표시됩니다.

안전한 일정 대체값

일정 데이터가 불완전하거나 잘못된 형식이면 Streamliner가 안전한 대체 일정을 불러옵니다. 그래도 페이지를 열고 편집기를 검토한 뒤 수정된 일정을 저장할 수 있습니다.

읽기 전용 시간대

이 페이지의 시간대는 항상 호텔 시간대와 일치합니다. Change 링크를 사용해 Settings → Essentials → Hotel Basic Details를 엽니다.

랜딩 페이지 링크 만들기​

  1. Widget & Access에서 Landing Pages를 찾습니다.

  2. Create Landing Page를 클릭합니다.

    ✓ 투숙객용 새 링크가 표시됩니다.

  3. View QR로 투숙객 코드를 미리 봅니다.

  4. 객실이나 환영 구역에 인쇄할 안내물이 필요하면 Download chatbot QR을 클릭합니다.

인쇄된 객실 QR 코드 만들기​

인쇄된 객실 QR 코드는 공유 챗봇 랜딩 페이지를 열고 스캔한 객실을 컨텍스트로 포함합니다. 정확히 하나의 활성 투숙 중인 예약이 해당 객실과 일치하면 AVA가 채팅 세션을 해당 투숙에 연결합니다. 투숙객이 텍스트 채팅이나 음성 기능을 사용하기 전에 연결된 투숙 컨텍스트가 새로 고쳐집니다. PMS 기능 계약이 해당 상태를 지원하면 AVA는 하나의 원문 DUE_OUT 투숙에도 일치시킵니다. 그렇지 않으면 인쇄된 객실 QR 조회는 CHECKED_IN 투숙만 일치시킵니다. AVA는 QR 코드에 인코딩된 정확한 객실 값을 사용합니다. AVA가 고유한 활성 투숙 중인 예약 하나를 찾지 못하면 객실은 확인되지 않은 힌트로 남습니다. CCI가 일시적으로 투숙을 확인하지 못해도 QR 링크는 계속 사용할 수 있습니다. Mr 또는 Ms와 같은 투숙객 호칭은 PMS 기록에 남아 있을 수 있습니다. AVA는 채팅 세션을 연결할 때 투숙객의 이름과 성을 사용합니다.

객실 액세스 필요

AVA는 객실 액세스 구성에서 객실 번호를 불러옵니다. 먼저 챗봇 랜딩 페이지를 만드세요.

  1. Chatbot → Setup에서 Widget & Access를 엽니다.

  2. Shared chatbot landing page에 선택 항목이 없으면 랜딩 페이지를 만듭니다.

  3. Room QR Code에서 공유 챗봇 랜딩 페이지를 선택합니다.

  4. Generate를 클릭합니다.

    ✓ AVA가 코드가 없는 각 객실에 대해 활성 QR 코드 하나를 만듭니다.

  5. 객실을 선택한 다음 Print selected를 클릭합니다.

    ✓ 객실을 선택하지 않으면 AVA가 모든 활성 객실 QR 코드를 인쇄합니다.

  6. 용지를 인쇄하고 각 코드를 해당 객실에 배치합니다.

인쇄된 객실 QR 코드 관리​

  • 객실 코드 하나를 인쇄하려면 Print를 클릭합니다.
  • 코드를 교체했거나 공유된 것으로 의심되면 Regenerate를 클릭합니다.
  • 인쇄된 코드의 작동을 중지하려면 Disable을 클릭합니다.
  • 비활성화된 코드를 복원하려면 Enable을 클릭합니다.
재생성하면 이전 코드가 무효화됩니다

재생성 직후 객실 안내판을 인쇄하고 교체하세요. 이전 QR 토큰은 작동하지 않습니다.

인쇄된 위치 QR 코드 만들기​

로비나 수영장과 같은 공용 구역에 사용할 이름이 지정된 QR 코드를 만듭니다. 각 코드는 선택한 공유 챗봇 랜딩 페이지를 위치 컨텍스트와 함께 엽니다.

  1. Chatbot → Setup에서 Widget & Access를 엽니다.

  2. Shared chatbot landing page에 선택 항목이 없으면 랜딩 페이지를 만듭니다.

  3. Location QR Code에서 공유 챗봇 랜딩 페이지를 선택합니다.

  4. Main entrance와 같은 고유한 Location name을 입력합니다.

  5. Add location을 클릭합니다.

    ✓ 새 위치가 QR 코드 목록에 표시됩니다.

  6. 활성 위치를 하나 이상 선택한 다음 Print selected를 클릭합니다.

  7. 인쇄된 각 코드를 해당 이름의 위치에 배치합니다.

위치 이름

위치 이름은 최대 100자까지 입력할 수 있습니다. 이름은 대소문자를 구분하지 않고 일치합니다.

인쇄된 위치 QR 코드 관리​

  • 위치 코드 하나를 인쇄하려면 Print를 클릭합니다.
  • 코드를 교체했거나 공유된 것으로 의심되면 Regenerate를 클릭합니다.
  • 인쇄된 코드의 작동을 중지하려면 Disable을 클릭합니다.
  • 비활성화된 코드를 복원하려면 Enable을 클릭합니다.
재생성하면 이전 코드가 무효화됩니다

재생성 직후 위치 안내판을 인쇄하고 교체하세요. 이전 QR 토큰은 작동하지 않습니다.

위치 QR 개인정보 보호​

위치 QR 코드는 일반적인 투숙객 지원을 위한 위치 컨텍스트를 제공합니다. 예약을 확인하거나 투숙을 채팅 세션에 연결하지 않습니다. 또한 예약 확인, CCI 조회 또는 투숙 컨텍스트를 요청하지 않습니다. 위치 QR 세션의 영상 통화에는 예약 기반 보강 정보가 전달되지 않습니다.

QR 유형예약 및 투숙 동작
Room QR고유한 CHECKED_IN 투숙 하나를 연결할 수 있으며, PMS 기능 계약이 지원하면 원문 DUE_OUT도 연결할 수 있습니다
Location QR위치 컨텍스트만 유지하며 예약을 연결하지 않습니다
공용 구역에 위치 코드를 배치하세요

로비, 시설 및 기타 공용 구역에는 위치 QR 코드를 사용하세요. 객실별 투숙 연결이 적절한 곳에서만 객실 QR 코드를 사용하세요.

인쇄된 QR 레이아웃 사용자 지정​

객실 및 위치 QR 인쇄 용지에 하나의 템플릿을 사용합니다. QR 코드 뒤에 흰색 배경을 두면 QR 코드를 읽을 수 있습니다.

인쇄 배경 업로드​

  1. QR Print Template에서 Upload background image를 클릭합니다.

  2. PNG, JPG/JPEG 또는 단일 페이지 PDF 파일을 선택합니다.

  3. 파일 크기를 10 MB 이하로 유지합니다.

    ✓ 템플릿이 미리보기에 표시됩니다.

PDF 파일은 한 페이지여야 합니다

AVA는 페이지가 0개이거나 여러 개인 PDF 파일을 거부합니다.

QR 필드 배치​

  1. QR Code를 배경으로 드래그하거나 필드를 클릭한 뒤 미리보기를 클릭합니다.

  2. 객실 또는 위치 이름을 표시하려면 QR Label을 배경으로 드래그합니다.

  3. 필드를 선택해 X, Y, Width, Height 값을 편집합니다.

  4. QR Code를 정사각형으로 유지합니다. AVA가 너비와 높이를 1:1 비율로 고정합니다.

  5. QR Label의 글꼴 크기, 텍스트 색상 및 정렬을 설정합니다.

  6. 미리보기 토글을 사용해 템플릿 필드 또는 샘플 인쇄 값을 확인합니다.

  7. Save design을 클릭합니다.

    ✓ 레이아웃이 인쇄된 객실 및 위치 QR 코드에 적용됩니다.

QR Label은 객실이나 위치마다 자동으로 바뀝니다. QR Print Template을 제거하면 AVA의 기본 3개 배치 인쇄 용지로 돌아갑니다.

허용 도메인 관리​

  1. Whitelisted Domains에 yourhotel.com과 같은 도메인을 입력합니다.
  2. Add Domain을 클릭합니다.
  3. 토글로 도메인을 활성화하거나 비활성화합니다.
  4. 위젯이 해당 도메인에서 더 이상 작동하지 않아야 할 때만 도메인을 제거합니다.

문제 해결​

Save 버튼이 비활성화됨​

보이는 현상: 메시지나 지시문을 저장할 수 없습니다.

해결 방법:

  1. 필드가 비어 있지 않은지 확인합니다.
  2. 불필요한 공백을 제거한 뒤 다시 시도합니다.
  3. 플랜에 Chatbot 기능이 포함되어 있는지 확인합니다.

고급 설정이 저장되지 않음​

보이는 현상: Save 버튼이 계속 비활성화되거나 유효성 검사 오류가 표시됩니다.

해결 방법:

  1. 현재 고급 값이 로드될 때까지 기다립니다.
  2. 빨간색 유효성 검사 메시지를 모두 확인합니다.
  3. Max Output Tokens를 500과 3024 사이로 유지합니다.
  4. Retrieval K를 1과 7 사이로 유지합니다.
  5. Disable grounding RAG engine이 켜져 있으면 Retrieval K를 1과 3 사이로 유지합니다.
  6. 다시 Save를 시도합니다.

RAG 제어 항목이 보이지 않음​

보이는 현상: Retrieval K 또는 Disable grounding RAG engine을 찾을 수 없습니다.

해결 방법:

  1. Advanced Settings를 엽니다.

  2. 현재 Answer Engine을 확인합니다.

  3. RAG를 선택합니다.

  4. Save를 클릭합니다.

    ✓ RAG 전용 제어 항목이 다시 표시됩니다.

Retrieval K 범위가 너무 좁아 보임​

보이는 현상: Retrieval K가 1에서 3까지만 허용됩니다.

해결 방법:

  1. Disable grounding RAG engine을 끕니다.
  2. Retrieval K를 다시 확인합니다.
  3. 업데이트된 설정을 저장합니다.

Skill Mode가 저장되지 않음​

보이는 현상: Use Skill Mode를 켠 뒤 저장에 실패합니다.

해결 방법:

  1. Skill Name이 비어 있지 않은지 확인합니다.
  2. 소문자, 숫자, 하이픈만 사용합니다.
  3. booking-assistant와 같은 이름을 사용해 봅니다.
  4. 다시 Save를 클릭합니다.

Skill Mode가 skill을 찾지 못함​

보이는 현상: 배포 후 skill이 표시되지 않습니다.

해결 방법:

  1. 다음 배포가 끝날 때까지 기다립니다.
  2. skill 패키지 이름이 Skill Name과 일치하는지 확인합니다.
  3. 시작 후 skill을 추가했다면 관리자에게 Streamliner를 다시 시작해 달라고 요청합니다.
  4. 그래도 skill이 로드되지 않으면 지원팀에 문의합니다.

예약 확인에서 투숙을 찾지 못함​

보이는 현상: 챗봇이 투숙객과 예약을 일치시키지 못합니다.

해결 방법:

  1. 투숙객이 올바른 객실 번호를 입력했는지 확인합니다.
  2. 예약의 대표 투숙객 이름을 요청합니다.
  3. 해당 객실에 정확히 하나의 예약이 체크인되어 있는지 확인합니다. PMS가 DUE_OUT을 기본 지원하면 퇴실 당일 투숙도 일치할 수 있습니다.
  4. 여러 활성 투숙이 객실을 공유하면 프런트 데스크에 PMS 데이터를 수정해 달라고 요청합니다.
  5. 확인 흐름을 다시 시도합니다.

확인 미리보기에 계속 일반 채팅이 표시됨​

보이는 현상: 위젯 미리보기에 본인 확인 양식이 표시되지 않습니다.

해결 방법:

  1. Widget & Access를 엽니다.
  2. Guest reservation verification을 켭니다.
  3. Save를 클릭합니다.
  4. 미리보기 패널을 새로 고칩니다.
  5. 미리보기 모드가 확인 화면을 숨기고 있지 않은지 확인합니다.

한 번 확인한 뒤 다시 실패함​

보이는 현상: 투숙객이 성공적으로 확인된 뒤 나중에 확인할 때 실패합니다.

해결 방법:

  1. 투숙객에게 같은 객실 번호와 투숙객 이름을 다시 사용하도록 요청합니다.
  2. 투숙객이 여전히 같은 예약을 사용하고 있는지 확인합니다.
  3. 투숙객이 예약을 바꿨다면 새 채팅을 시작합니다.
  4. 대화를 새로 고치고 다시 시도합니다.

랜딩 페이지가 생성되지 않음​

보이는 현상: 랜딩 페이지를 만들 때 오류가 발생합니다.

해결 방법:

  1. 페이지를 새로 고친 뒤 다시 시도합니다.
  2. 이전 페이지를 교체하라는 안내가 나오면 따릅니다.
  3. 그래도 실패하면 지원팀에 문의합니다.

객실 QR 코드가 생성되지 않음​

보이는 현상: Generate가 계속 비활성화되거나 AVA가 객실을 로드하지 못합니다.

해결 방법:

  1. 챗봇 랜딩 페이지를 하나 이상 만듭니다.
  2. 호텔의 객실 액세스가 구성되어 있는지 확인합니다.
  3. Chatbot → Setup을 새로 고칩니다.
  4. 랜딩 페이지를 선택한 다음 Generate를 다시 클릭합니다.

위치 QR 코드가 생성되지 않음​

보이는 현상: Add location이 계속 비활성화되거나 저장에 실패합니다.

해결 방법:

  1. 챗봇 랜딩 페이지를 하나 이상 만듭니다.

  2. Location QR Code에서 랜딩 페이지를 선택합니다.

  3. 1~100자 사이의 위치 이름을 입력합니다.

  4. 다른 위치에서 같은 이름을 사용하고 있지 않은지 확인합니다.

  5. Add location을 다시 클릭합니다.

    ✓ 대소문자만 다른 이름도 중복으로 처리됩니다.

위치 QR 코드를 사용할 수 없음​

보이는 현상: 투숙객이 위치 코드를 스캔했지만 채팅이 열리지 않습니다.

해결 방법:

  1. Chatbot → Setup에서 Location QR Code를 엽니다.
  2. 코드가 비활성화되어 있는지 확인합니다.
  3. Enable을 클릭하거나 Regenerate를 클릭한 뒤 교체 코드를 인쇄합니다.
  4. 선택한 랜딩 페이지가 여전히 존재하는지 확인합니다.

인쇄된 객실 QR 코드가 더 이상 작동하지 않음​

보이는 현상: 투숙객이 객실 코드를 스캔했지만 챗봇이 열리지 않습니다.

해결 방법:

  1. Chatbot → Setup에서 Room QR Code를 엽니다.
  2. 코드가 비활성화되어 있는지 확인합니다.
  3. Enable을 클릭하거나 Regenerate를 클릭한 뒤 교체 코드를 인쇄합니다.
  4. 랜딩 페이지가 여전히 존재하는지 확인합니다.

QR 인쇄 템플릿 업로드 실패​

보이는 현상: AVA가 배경 파일을 거부하거나 업로드 오류를 표시합니다.

해결 방법:

  1. PNG, JPG/JPEG 또는 PDF 파일을 사용합니다.
  2. 파일 크기를 10 MB 이하로 유지합니다.
  3. PDF를 사용하는 경우 추가 페이지를 제거하고 한 페이지만 업로드합니다.
  4. Chatbot → Setup을 새로 고친 뒤 파일을 다시 업로드합니다.

QR 인쇄 디자인이 저장되지 않음​

보이는 현상: Save design이 실패하거나 새로 고친 뒤 위치가 사라집니다.

해결 방법:

  1. 배경 미리보기가 계속 로드되는지 확인합니다.
  2. 미리보기에 필수 QR Code 필드를 배치합니다.
  3. QR Code의 너비와 높이를 같게 유지합니다.
  4. Save design을 다시 클릭합니다.

인쇄된 QR 용지가 기본 레이아웃을 사용함​

보이는 현상: 인쇄 용지가 AVA의 표준 3개 배치 레이아웃을 사용합니다.

해결 방법:

  1. Chatbot → Setup → Widget & Access로 돌아갑니다.
  2. QR Print Template에 저장한 배경이 계속 표시되는지 확인합니다.
  3. 템플릿이 없으면 다시 업로드하고 Save design을 클릭합니다.
  4. 템플릿이 표시된 후 QR 코드를 다시 인쇄합니다.

객실 QR 등록 실패​

보이는 현상: 투숙객이 객실 QR 코드를 스캔했지만 등록에 실패합니다. guest.property title should not exist라는 오류가 표시될 수 있습니다.

해결 방법:

  1. 투숙객에게 QR 랜딩 페이지를 새로 고치도록 요청합니다.
  2. 투숙객에게 객실 QR 코드를 다시 스캔하도록 요청합니다.
  3. 투숙객의 투숙 상태가 CHECKED_IN인지 확인합니다. DUE_OUT 투숙은 PMS가 해당 상태를 기본 지원할 때만 일치합니다.
  4. 인코딩된 객실 값이 PMS의 객실 값과 정확히 일치하는지 확인합니다.
  5. 정확히 하나의 활성 투숙이 객실과 일치하는지 확인합니다.
  6. PMS 기록에 투숙객 호칭을 남겨 두세요. 삭제할 필요가 없습니다.
  7. QR 조회가 계속 실패하면 수동 투숙객 확인을 사용합니다.
  8. 등록이 계속 실패하면 지원팀에 문의합니다.

도메인 토글이 동작하지 않음​

보이는 현상: 스위치가 바뀌지만 다시 원래대로 돌아갑니다.

해결 방법:

  1. 페이지를 새로 고칩니다.
  2. 도메인을 제거한 뒤 다시 추가합니다.
  3. 토글을 다시 시도합니다.

운영 시간 외에 부재 중 메시지가 표시됨​

보이는 현상: 라이브 답변을 기대한 시간에 투숙객이 부재 중 메시지를 받습니다.

해결 방법:

  1. Widget & Access를 엽니다.
  2. Limit live chat to operating hours를 확인합니다.
  3. 현재 요일이 열려 있는지 확인합니다.
  4. Timezone 칩이 Settings → Essentials → Hotel Basic Details와 일치하는지 확인합니다.
  5. 변경한 후 다시 저장합니다.
  6. 일정이 방금 변경되었다면 위젯을 새로 고치고 다음 전환을 기다립니다.

아직 해결되지 않았나요?​

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

  • ❌ 객실 번호와 투숙객 이름을 확인한 뒤에도 예약 확인이 계속 실패함
  • ❌ 랜딩 페이지가 생성되지 않음
  • ❌ 문제가 30분 이상 지속됨

함께 보내면 좋은 정보:

  • Chatbot Setup 페이지 또는 대화 스크린샷
  • 시도한 작업과 오류 메시지
  • 확인에 실패한 경우 투숙객 객실 번호와 이름
  • 문제가 시작된 시간