본문으로 건너뛰기

챗봇 설정하기

빠른 설정

대부분의 호텔은 약 7분이면 메시지, 봇 지시문, 라이브 채팅 시간을 설정할 수 있습니다.

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

이동: Communication Hub → Chatbot → Setup

빠른 참고​

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

플랜 액세스​

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

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

시작하기 전에​

다음 요건을 확인하세요.

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

봇 메시지 구성​

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

  2. Bot Configuration 탭에 머뭅니다.

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

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

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

    ✓ 저장할 때마다 성공 메시지가 표시됩니다.

봇 지시문 설정​

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

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

  3. Save를 클릭합니다.

    ✓ 새 챗봇 답변에 사용할 지시문이 저장됩니다.

저장 후 AI 준비가 완료될 때까지 기다리기​

Default Answer, Bot Instruction, 언어 또는 Skill Mode 설정을 저장하면 AVA가 새 챗봇 요청에 해당 설정을 사용합니다. 연결된 일부 AI 흐름은 백그라운드에서 구성을 계속 준비할 수 있습니다.

  1. 구성 변경 사항을 하나 저장합니다.

  2. 업데이트된 동작을 테스트할 때 새 채팅을 시작합니다.

  3. 답변이 여전히 이전 설정을 사용하면 잠시 기다렸다가 다시 시도합니다.

    ✓ 새 답변은 저장된 최신 구성을 사용합니다.

변경 사항은 한 번에 하나씩 저장하세요

다른 AI 설정을 변경하기 전에 저장 확인을 기다립니다. 이렇게 하면 AVA가 변경 사항을 겹치지 않게 최신 구성을 준비할 수 있습니다.

좋은 지시문 예시

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

여러 줄 지시문

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

Agent (Pi)에 설정 프롬프트 적용​

Answer Engine이 **Agent (Pi)**인 경우 Chat Widget은 저장된 Bot Instruction, 언어 및 Default Answer를 에이전트로 전송합니다. 이 필드를 사용해 에이전트의 어조와 기본 응답을 안내하세요.

이 전달은 Chat Widget의 Pi-agent 트래픽에만 적용됩니다. 음성 및 Request Support Chat 동작은 변경되지 않습니다.

공유 투숙객 메시지 옵션 이해하기​

Chat Widget과 WhatsApp Agent (Pi)의 답변은 완전한 표준 답변을 유지합니다. 번역이 활성화되면 번역된 전달 텍스트도 계속 사용할 수 있습니다. 더 이상 사용하지 않는 적응형 표시 선택기는 버튼, 메뉴 또는 이미지를 선택하지 않습니다.

투숙객에게 표시되는 항목의미
완전한 답변에이전트의 전체 응답을 계속 사용할 수 있습니다
번역된 답변설정된 경우 전달되는 텍스트가 투숙객의 언어로 표시됩니다
이전의 리치 메시지저장된 경우 이전 표시 콘텐츠를 읽을 수 있습니다

새 위젯 및 WhatsApp 에이전트 답변은 전체 텍스트를 유지해야 합니다. 전체 응답이나 번역이 누락되면 AVA 관리자에게 도움을 요청하세요.

예약 질문과 후속 질문에 답변하기​

선택한 스킬이 예약 조회를 지원하면 Agent (Pi)가 예약 질문에 답변할 수 있습니다. 해당 스킬에서 요구하는 세부 정보와 답변 형식을 따르세요.

예를 들어 스킬에서 호텔, 확인 번호 및 도착 날짜를 요청할 수 있습니다.

Agent (Pi)는 선택한 스킬과 저장된 컨텍스트를 사용해 투숙객에게 답변합니다. 스킬이 필요한 예약 세부 정보를 저장하면 투숙객은 구체적인 후속 질문을 할 수 있습니다.

세부 정보가 바뀌면 새로 조회하도록 요청하세요

다른 예약을 확인할 때는 새 호텔, 확인 번호 및 도착 날짜를 제공해야 합니다.

완전한 예약 형식 사용

투숙객에게 한 메시지에 호텔, 확인 번호 및 도착 날짜를 제공하도록 요청하세요. 날짜 형식은 YYYY-MM-DD를 사용합니다.

선택한 호텔로 RAG 답변 범위 제한​

챗봇에 여러 호텔의 문서가 있으면 AVA는 가능한 경우 질문에서 호텔을 식별합니다. 그런 다음 답변 범위를 일치하는 문서 소스로 좁힙니다.

질문이 둘 이상의 호텔에 해당할 수 있다면 투숙객에게 호텔 이름을 말하도록 요청하세요. AVA가 일치하는 소스를 식별하지 못하면 구성된 문서 범위와 기본 답변 동작을 유지합니다.

고급 답변 설정​

  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을 켜면 답변 전에 컨텍스트를 직접 미리 가져옵니다. 토큰을 더 사용하지만 검색 신뢰성은 높아집니다. 여러 호텔 소스를 사용할 수 있으면 AVA는 질문에 언급된 호텔로 RAG 검색 범위를 좁힐 수 있습니다. Chat Widget은 Bot Instruction과 Default Answer를 **Agent (Pi)**에만 전송합니다. 이 설정은 챗봇 답변과 연결된 음성 흐름에 영향을 줍니다.

Skill Mode 사용​

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

스킬 라우팅

Use Skill Mode를 켜면 스킬 기반 채팅 요청이 **Agent (Pi)**로 라우팅됩니다. Agent (Pi)는 선택한 스킬 패키지를 로드하고 구성된 도구만 노출합니다.

  1. Advanced Settings를 클릭합니다.

  2. Use Skill Mode를 켭니다.

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

  4. Save를 클릭합니다.

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

Skill 이름 규칙

Skill Name에는 소문자, 숫자, 하이픈만 사용할 수 있습니다. Use Skill Mode가 켜져 있으면 이 필드는 필수입니다. Agent (Pi)가 선택한 스킬을 백그라운드에서 실행합니다.

스킬이 표시되지 않는 경우

스킬 패키지를 추가하거나 업데이트한 뒤 관리자에게 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을 저장한 후 위젯 미리보기를 엽니다. 일반적인 채팅 시작 화면 대신 본인 확인 양식이 표시되어야 합니다.

투숙객 피드백 설정​

Feedback Settings를 사용해 투숙객에게 채팅 경험에 대해 질문하세요. 봇이 답변하지 못한 후, 직원이 라이브 채팅을 종료한 후 또는 두 경우 모두 피드백을 받을 수 있습니다.

두 피드백 트리거는 기본적으로 꺼져 있습니다. 설정은 선택한 호텔에 적용되며 서로 독립적으로 변경할 수 있습니다.

이동: Communication Hub → Chatbot → Feedback Settings

설정제어하는 항목투숙객에게 표시되는 내용
Rating style얼굴 또는 별을 사용합니다1에서 5까지의 다섯 가지 선택지
Rating question평점 질문을 설정합니다선택지 위에 표시되는 질문
Ask when a guest goes quiet대화 중단 후속 질문을 시작합니다봇 답변 후 예 또는 아니요 질문
Minutes after bot reply대화 중단 후속 질문을 지연합니다후속 질문이 표시되기 전 대기 시간
Minutes to wait after follow-up평점 요청을 지연합니다평점이 표시되기 전 대기 시간
Ask when staff closes a live chat종료 후 평점 요청을 시작합니다티켓 종료 직후 평점 요청

평점 구성​

  1. Communication Hub → Chatbot → Feedback Settings를 엽니다.

  2. Five faces 또는 Five stars를 선택합니다.

  3. Rating question을 입력합니다.

  4. 위젯 미리보기를 검토합니다.

    ✓ 투숙객은 1부터 5까지 점수 하나를 제출할 수 있습니다.

투숙객이 응답하지 않을 때 피드백 요청​

  1. Ask when a guest goes quiet를 켭니다.

  2. Follow-up question을 입력합니다.

  3. Minutes after bot reply를 1에서 60 사이로 설정합니다.

  4. Minutes to wait after follow-up을 1에서 60 사이로 설정합니다.

  5. Save changes를 클릭합니다.

    ✓ AVA가 설정한 지연 시간 후 후속 질문을 보냅니다. ✓ Yes 답변을 받으면 투숙객의 다음 메시지를 기다립니다. ✓ No 답변을 받으면 평점을 표시합니다. ✓ 투숙객이 새 메시지를 보내면 대기 중인 질문이 취소됩니다.

직원이 라이브 채팅을 종료한 후 피드백 요청​

  1. Ask when staff closes a live chat를 켭니다.

  2. Save changes를 클릭합니다.

    ✓ 직원이 티켓을 종료한 후 AVA가 평점을 표시합니다. ✓ 이 규칙은 추가 후속 질문을 보내지 않습니다.

피드백 시점

AVA는 새 피드백 질문에 가장 최근에 저장된 설정을 사용합니다. 이미 질문에 답변 중인 투숙객은 표시된 선택지를 사용해 해당 질문을 완료할 수 있습니다.

피드백 변경 사항 저장 또는 버리기​

  1. 저장하기 전에 실시간 미리보기를 검토합니다.

  2. 새 설정을 적용하려면 Save changes를 클릭합니다.

  3. 마지막으로 저장한 설정을 복원하려면 Discard를 클릭합니다.

    ✓ AVA가 설정을 업데이트하는 동안 페이지에 Saving이 표시됩니다. ✓ 저장 중에는 편집이 일시적으로 비활성화됩니다. ✓ 성공 메시지가 저장된 설정을 확인합니다.

호텔 컨텍스트

호텔을 전환하면 AVA가 피드백 설정을 다시 로드합니다. 변경 사항을 저장하기 전에 항상 호텔 이름을 확인하세요.

투숙객 서비스 요청 처리​

확인된 투숙 중인 투숙객은 호텔에서 구성한 서비스를 텍스트 채팅으로 요청할 수 있습니다. 요청 가능한 유형에는 편의시설, 청소, 수하물, 모닝콜, 문제 신고, 피드백 및 기타 서비스가 포함될 수 있습니다. 날짜가 중요한 요청의 경우 AVA는 호텔의 현재 날짜, 시간 및 시간대를 사용합니다. 투숙객의 기기가 다른 시간대를 사용하더라도 이 시간대를 유지합니다. 이를 통해 투숙객은 “내일 아침 7시 30분”과 같은 표현을 사용할 수 있습니다.

투숙객의 작업채팅 동작
이용 가능한 서비스 문의채팅에서 확인된 투숙에 사용하도록 설정된 서비스를 나열합니다
서비스 요청 또는 취소요청을 생성하거나 취소하기 전에 채팅에 미리보기를 표시합니다
미리보기 확인정확한 미리보기에 명확히 동의하는 다음 메시지가 있어야만 요청을 제출합니다
요청 상태 확인채팅에서 해당 채팅으로 생성된 요청의 상태를 표시합니다
이미 활성화된 항목 요청일치하는 요청이 이미 활성화되어 있음을 채팅에서 설명합니다
새 항목과 활성 항목을 함께 요청새 요청과 이미 활성화된 항목을 구분해 채팅에서 표시합니다

이용 가능한 서비스 선택 지원​

채팅은 호텔의 서비스 카탈로그를 기준으로 편의시설, 기타 및 문제 요청을 확인합니다. 투숙객이 카탈로그 항목 하나의 정확한 이름을 사용하면 코드 없이도 채팅에서 일치시킵니다. 이름을 일치시킬 때 대소문자는 구분하지 않습니다. 투숙객이 무언가가 고장 났거나 결함이 있거나 작동하지 않는다고 말하면 채팅은 이를 문제 요청으로 처리합니다. 첫 번째 문제 이름이 목록에 없으면 Live Chat은 이용 가능한 문제 이름을 사용해 한 번 다시 시도합니다. 문제 하나가 적합하면 채팅은 정확히 목록에 있는 이름으로 요청을 준비합니다. 적합한 문제가 없으면 채팅은 투숙객에게 목록에 있는 문제 중에서 선택하도록 요청하거나 일치하는 문제가 없다고 설명합니다. 채팅은 목록에 없는 문제 이름을 준비하지 않습니다. 투숙객의 요청에 설명이 더 필요하면 채팅에서 관련된 이용 가능한 서비스를 이름으로 표시합니다. 한 서비스가 명확히 맞으면 채팅은 해당 서비스로 다시 시도합니다. 여러 서비스가 맞을 수 있으면 채팅에서 투숙객에게 이름으로 선택하도록 요청합니다. 중복 이름에는 “Hand Towel (1)” 및 “Hand Towel (2)”와 같은 번호가 붙습니다. 중복 항목이 표시되면 투숙객은 번호가 붙은 이름을 선택해야 합니다. 다시 시도해도 성공하지 않으면 선택 가능한 옵션이 있을 때 동일한 선택 안내를 사용합니다.

라이브 음성 카탈로그 이름

라이브 음성 후속 대화 중에는 어시스턴트가 이미 투숙객에게 표시한 이름을 유지합니다. 문제 및 기타 서비스 이름은 빈 번호 옵션으로 바뀌지 않고 계속 표시됩니다. 중복 이름에는 투숙객이 올바른 항목을 선택할 수 있도록 계속 번호가 붙습니다.

투숙객은 내부 서비스 코드나 식별자를 알 필요가 없습니다.

이 확인 절차를 통해 잘못된 요청이 Housekeeping으로 전달되는 것을 방지합니다. 투숙객에게 정확한 옵션이 표시되도록 호텔의 서비스 카탈로그를 최신 상태로 유지하세요.

투숙객에게 표시되는 항목해야 할 일
추천 서비스 하나이름이 투숙객의 요청과 일치하는지 확인합니다
여러 서비스 이름투숙객에게 이름으로 하나를 선택하도록 요청합니다
관련 서비스 이름 없음서비스 카탈로그를 검토하고 직원의 도움을 안내합니다
문제 신고에는 목록에 있는 문제 이름을 사용합니다

투숙객의 표현이 카탈로그와 일치하지 않으면 채팅에 표시된 문제 이름 중에서 선택하도록 안내하세요. 투숙객은 내부 문제 코드를 알 필요가 없습니다.

중복 서비스 이름은 확인이 필요합니다

여러 카탈로그 항목이 같은 이름을 공유하면 채팅에서 카탈로그 순서에 따라 번호가 붙은 이름을 표시합니다. 투숙객에게 이용 가능한 이름 중 일치하는 번호가 붙은 서비스를 선택하도록 요청하세요. 번호가 없는 공통 이름은 여전히 모호하므로 채팅에서 투숙객에게 선택하도록 요청합니다.

여러 수하물 요청하기​

수하물 수거를 요청할 때 투숙객에게 가방 개수를 포함하도록 안내하세요. AVA는 해당 수량을 요청 미리보기와 제출된 벨보이 작업에 반영합니다.

투숙객 메시지예상 동작
“객실에서 가방 두 개를 수거해 주세요”미리보기와 작업에 가방 수량 2개가 표시됩니다
“객실에서 제 가방을 수거해 주세요”요청을 확인하기 전에 미리보기를 주의 깊게 검토합니다

AVA가 수량을 식별한 후 투숙객에게 전체 미리보기를 확인하도록 요청하세요.

모닝콜 요청하기​

가능하면 투숙객에게 모닝콜 시간과 날짜를 포함하도록 안내하세요. AVA는 호텔에 구성된 시간대를 사용해 상대 날짜를 해석합니다.

투숙객 메시지예상 동작
“내일 아침 7시 30분에 깨워 주세요”AVA가 호텔의 다음 달력 날짜에 대한 요청을 준비합니다
“7시 30분에 깨워 주세요”AVA가 어느 날짜를 의미하는지 투숙객에게 묻습니다

날짜가 중요한 요청을 테스트하기 전에 호텔의 시간대를 확인하세요. Settings → Essentials → Hotel Basic Details로 이동해 Timezone을 확인합니다.

확인이 필요합니다

채팅은 첫 메시지만으로 서비스 요청을 생성하거나 취소하지 않습니다. 한 번의 투숙객 메시지로 요청을 준비하고 확인할 수는 없습니다. 투숙객은 이후 메시지에서 정확한 미리보기를 확인해야 합니다. Agent (Pi)는 정해진 확인 문구를 일치시키는 대신 다음 메시지가 실제 동의인지 판단합니다. 질문, 망설임, 수정 또는 관련 없는 단어는 요청을 확인하는 것으로 처리되지 않습니다. 투숙객이 미리 준비된 요청 식별자나 기타 내부 필드를 제공할 필요는 없습니다. AVA는 서버에 보관된 대기 중인 미리보기에 확인을 연결합니다. 투숙객의 답변이 불명확하면 AVA는 다시 묻기 전에 해당 미리보기를 폐기합니다. 다음 확인으로는 이전 미리보기를 제출할 수 없습니다. AVA는 동일한 요청을 다시 준비하고 내용을 읽어 준 다음 다시 한 번 확인을 요청합니다.

서비스가 바쁠 때는 확인에 시간이 더 걸릴 수 있습니다

Housekeeping이 느리거나 첫 번째 응답이 유실되면 AVA는 확인을 다시 시도합니다. 실패를 알리기 전까지 투숙객이 약 17초 정도 기다릴 수 있습니다. 재시도에서는 동일한 요청 세부 정보를 사용하므로 모닝콜이 중복으로 생성되지 않습니다. 투숙객에게 확인을 다시 보내지 말고 결과를 기다리도록 안내하세요.

이미 활성화된 서비스 요청 설명하기​

채팅은 요청된 각 항목을 투숙객의 활성 요청과 대조합니다. 이미 활성화된 항목을 실패한 요청으로 설명하지 않습니다. 해당 항목에 대해 다른 작업을 생성하지도 않습니다.

투숙객의 요청투숙객에게 안내되는 내용
이미 활성화된 항목만 요청해당 항목이 이미 활성화되어 있음을 안내합니다
새 항목과 이미 활성화된 항목을 함께 요청새로 요청된 항목과 이미 활성화된 항목을 구분해 안내합니다

항목이 이미 활성화되어 있으면 기존 요청을 기다리도록 투숙객에게 안내하세요. 활성 요청을 변경해야 한다면 프런트 데스크에 문의하도록 안내하세요.

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

투숙객 혜택 질문에 답변하기​

확인된 투숙객은 포함된 혜택에 대해 텍스트 채팅이나 음성 어시스턴트로 질문할 수 있습니다. 예를 들어 조식 포함 여부, 오늘 이용 가능 여부, 다음 이용 가능 날짜를 물어볼 수 있습니다.

어시스턴트는 확인된 투숙을 자동으로 확인합니다. 투숙객은 질문에 예약 또는 객실 식별자를 제공할 필요가 없습니다. PMS 연결, 혜택 카탈로그 및 요금 플랜 할당을 최신 상태로 유지하세요.

투숙객 질문예상 답변
조식이 포함되어 있나요?포함 또는 미포함
오늘 조식을 이용할 수 있나요?오늘 이용 가능 또는 오늘 이용 불가
언제 이용할 수 있나요?제공되는 경우 다음 이용 가능 날짜
직원의 사용 처리는 별도로 진행됩니다

투숙객에 대한 답변은 혜택을 사용 처리하지 않습니다. 직원은 계속 Entitlements를 사용해 허용량을 확인하고 사용량을 기록합니다.

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

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

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

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

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

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

  5. 지원되지 않는 서비스 이름을 테스트합니다.

    ✓ 채팅에서 확인된 투숙에 이용 가능한 서비스를 표시합니다. ✓ 여러 서비스가 맞을 수 있으면 채팅에서 투숙객에게 이름으로 선택하도록 요청합니다. ✓ 채팅에서 잘못된 요청을 Housekeeping으로 보내지 않습니다.

  6. 목록에 없는 문제 카탈로그 이름으로 고장을 신고합니다.

    ✓ 채팅은 이용 가능한 문제 이름을 사용해 한 번 다시 시도합니다. ✓ 일치하는 문제에는 목록에 있는 정확한 이름을 사용합니다. ✓ 적합한 문제가 없으면 채팅은 투숙객에게 선택하도록 요청하거나 일치하는 문제가 없다고 말합니다.

  7. 미리보기에 모호하게 답한 다음 채팅이 다시 묻고 나서 확인합니다.

    ✓ 채팅은 나중의 확인을 수락하기 전에 요청을 다시 준비하고 내용을 읽어 줍니다.

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

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

해결 방법:

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

요청한 서비스를 사용할 수 없다고 채팅에서 말함​

보이는 현상: 투숙객이 서비스를 말했지만 채팅에서 이용 가능한 서비스 중 하나를 선택하라고 요청합니다.

해결 방법:

  1. 투숙객에게 이용 가능한 서비스 중 하나를 이름으로 선택하도록 요청합니다.
  2. 해당 서비스가 호텔의 서비스 카탈로그에서 사용 설정되어 있는지 확인합니다.
  3. 투숙객에게 객실 번호가 있는 현재의 확인된 투숙이 있는지 확인합니다.
  4. 카탈로그 또는 투숙객 구성을 업데이트한 후 다시 시도합니다.
  5. 사용 설정된 서비스를 계속 이용할 수 없으면 지원팀에 문의합니다.

채팅에서 투숙객의 문제 신고를 거부함​

보이는 현상: 투숙객이 고장 난 것을 신고했지만 채팅에서 즉시 거부합니다.

해결 방법:

  1. 투숙객에게 객실 번호가 있는 현재의 확인된 투숙이 있는지 확인합니다.
  2. 해당 문제가 호텔의 서비스 카탈로그에서 사용 설정되어 있는지 확인합니다.
  3. 투숙객에게 목록에 있는 문제 이름 중 하나를 사용하도록 요청합니다.
  4. 첫 번째 응답에 이용 가능한 문제가 표시되지 않았다면 새 메시지로 다시 시도합니다.
  5. 채팅에서 계속 문제 신고를 거부하면 지원팀에 문의합니다.

채팅에서 요청을 다시 준비하라고 요청함​

보이는 현상: 투숙객이 모호하게 동의한 후 나중에 “예”라고 답해도 요청이 제출되지 않습니다.

해결 방법:

  1. 채팅에서 요청을 다시 준비하고 내용을 읽어 주도록 합니다.
  2. 투숙객에게 변경되지 않은 전체 미리보기를 확인하도록 요청합니다.
  3. 호텔 카탈로그에서 중복 서비스 이름을 서로 구분되게 유지합니다.
  4. 채팅에서 요청을 다시 준비하지 않으면 지원팀에 문의합니다.

모닝콜 요청에서 날짜를 묻는 경우​

보이는 현상: 투숙객이 “내일”이라고 말했지만 채팅에서 어느 날짜를 의미하는지 묻습니다.

해결 방법:

  1. Settings → Essentials → Hotel Basic Details에서 Timezone을 확인합니다.
  2. 투숙객에게 정확한 날짜와 시간을 제공하도록 요청합니다.
  3. 요청을 제출하기 전에 미리보기를 확인합니다.

확인된 모닝콜에서 오류를 보고함​

보이는 현상: 투숙객이 모닝콜을 확인했지만 채팅에서 오류를 보고합니다.

해결 방법:

  1. 투숙객에게 다시 시도하도록 요청하기 전에 확인 응답이 완료될 때까지 기다립니다.
  2. Tasks 또는 Housekeeping에서 모닝콜을 확인합니다.
  3. 원래 모닝콜이 표시되면 다른 요청을 만들지 않습니다.
  4. 요청이 표시되지 않으면 투숙객에게 한 번 다시 시도하도록 요청합니다.
  5. 다시 시도해도 실패하면 지원팀에 문의합니다.

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

해결 방법:

  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를 클릭합니다.

    ✓ 상태 표시기에 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을 클릭합니다.

랜딩 페이지 이름 동기화​

가맹점 이름을 변경한 후 이 작업을 사용하세요. 챗봇 랜딩 페이지 이름을 현재 가맹점 이름과 일치하도록 업데이트합니다. 기존 페이지는 페이지 ID와 API 키를 유지하면서 AVA가 URL 경로를 업데이트합니다. 페이지를 삭제하고 다시 만들어도 현재 merchant 이름이 사용됩니다.

  1. Communication Hub → Chatbot → Setup → Widget & Access를 엽니다.

  2. 업데이트할 랜딩 페이지를 찾습니다.

  3. Sync Url Name을 클릭합니다.

    ✓ 랜딩 페이지에 현재 가맹점 이름이 사용됩니다. ✓ 페이지 콘텐츠와 API 키를 계속 사용할 수 있습니다. ✓ 랜딩 페이지 목록이 새로 고쳐지고 열려 있던 QR 미리보기가 닫힙니다.

  4. 표시된 URL이 변경되었다면 랜딩 페이지 링크를 다시 복사합니다.

  5. 인쇄된 QR 안내물에서 이전 링크를 사용한다면 교체합니다.

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

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

객실 액세스 필요

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

  1. Communication Hub → 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. Communication Hub → 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. 위젯이 해당 도메인에서 더 이상 작동하지 않아야 할 때만 도메인을 제거합니다.

문제 해결​

Chatbot Setup이 표시되지 않음​

보이는 현상: Communication Hub에서 Chatbot → Setup을 찾을 수 없습니다.

해결 방법:

  1. 플랜에 Chatbot 기능이 포함되어 있는지 확인합니다.
  2. 관리자에게 역할에 chatbot_setup:manage 권한을 부여해 달라고 요청합니다.
  3. 액세스 권한을 변경한 후 AVA를 새로 고칩니다.

Chatbot Setup으로 직접 이동하는 링크에도 이 권한이 필요합니다.

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가 스킬을 찾지 못함​

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

해결 방법:

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

챗봇이 계속 이전 지시문이나 기본 답변을 사용함​

보이는 현상: 테스트 답변이 계속 이전 지시문이나 기본 답변을 따릅니다.

해결 방법:

  1. 저장 알림이 표시되었는지 확인합니다.
  2. 새 채팅을 시작하고 다시 테스트합니다.
  3. 답변이 여전히 이전 설정을 사용하면 잠시 기다립니다.
  4. 기존 채팅 세션에서 테스트하지 않습니다.
  5. 새 채팅에서도 이전 구성을 사용하면 지원팀에 문의합니다.

Agent (Pi)에 공급자 오류가 표시됨​

보이는 현상: 투숙객 요청에 답변 대신 Agent (Pi) 공급자 오류가 표시됩니다.

이 메시지는 일반적인 챗봇 오류보다 공급자 실패 원인을 더 명확하게 보여줄 수 있습니다. 호텔에 Pi 오류 알림이 설정되어 있으면 AVA는 지원 담당자에게 Telegram 요약도 보냅니다. 알림에는 가맹점, 원인, 시간, 요청 ID 및 대화 ID가 포함됩니다. 투숙객 메시지, 프롬프트, 자격 증명 또는 원시 공급자 오류는 포함되지 않습니다.

해결 방법:

  1. 공급자 또는 요청 세부 정보가 포함된 전체 오류 메시지를 저장합니다.
  2. 투숙객에게 요청을 한 번 다시 보내 달라고 요청합니다.
  3. Pi 동작이 예상되는 경우에만 Answer Engine이 **Agent (Pi)**로 설정되어 있는지 확인합니다.
  4. 선택한 스킬과 챗봇 설정이 계속 저장되어 있는지 확인합니다.
  5. 공급자 오류가 다시 나타나면 지원팀에 문의합니다.

지원팀이 일치하는 서비스 로그를 찾을 수 있도록 요청 ID를 함께 전달하세요.

지원 요청에 공급자 자격 증명이나 API 키를 공유하지 마세요.

저장 중 AI 구성이 변경됨​

보이는 현상: "GenAI configuration changed while saving. Please retry."라는 메시지와 함께 저장에 실패합니다.

이 메시지는 최신 Skill Mode 필드가 없는 이전 호텔 레코드에서 나타날 수 있습니다. 서비스가 업데이트되면 이러한 레거시 구성도 정상적으로 저장할 수 있습니다.

해결 방법:

  1. 다른 저장 작업이 아직 처리 중이면 잠시 기다립니다.
  2. Communication Hub → Chatbot → Setup을 새로 고칩니다.
  3. 최신 값이 표시되는지 확인합니다.
  4. Save를 다시 클릭합니다.
  5. AVA에서 구성을 다시 준비하라고 요청하면 준비 작업을 다시 시도합니다.
  6. 다시 시도한 후에도 메시지가 반복해서 나타나면 지원팀에 문의합니다.
실제 동시 변경

다른 사람이 먼저 구성을 변경한 경우 AVA는 여전히 저장을 거부합니다. 페이지를 새로 고치고 최신 값을 검토한 다음 변경 사항을 다시 저장하세요. 이전 구성에는 데이터베이스 백필이 필요하지 않습니다.

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

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

해결 방법:

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

투숙객 혜택 답변이 누락되거나 거부됨​

보이는 현상: 확인된 투숙객이 혜택에 대해 질문했지만 어시스턴트가 거부하거나 답변하지 못합니다.

투숙객에게 혜택이 없으면 어시스턴트는 해당 혜택이 포함되지 않았다고 답변해야 합니다. Entitlements가 빈 결과를 반환할 때는 정상적인 답변입니다.

해결 방법:

  1. 투숙객에게 확인된 현재 투숙이 있는지 확인합니다.
  2. PMS 연결이 활성 상태인지 확인합니다.
  3. 혜택이 투숙객의 요금 플랜에 할당되어 있는지 확인합니다.
  4. 같은 예약에 대해 Entitlements를 확인합니다.
  5. 투숙객에게 질문을 다시 보내 달라고 요청합니다.

Entitlements에 혜택이 표시되지 않으면 어시스턴트는 해당 혜택이 포함되지 않았다고 답변해야 합니다. 그 대신 어시스턴트가 거부하면 대화 세부 정보와 함께 지원팀에 문의합니다.

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

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

해결 방법:

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

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

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

해결 방법:

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

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

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

해결 방법:

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

랜딩 페이지 이름이 최신 상태가 아님​

보이는 현상: 챗봇 랜딩 페이지에 이전 가맹점 이름이 계속 표시됩니다.

해결 방법:

  1. Communication Hub → Chatbot → Setup → Widget & Access를 엽니다.
  2. 올바른 호텔을 보고 있는지 확인합니다.
  3. 해당 랜딩 페이지의 Sync Url Name을 클릭합니다.
  4. 랜딩 페이지 목록을 새로 고칩니다.
  5. 필요한 경우 링크를 다시 복사하고 인쇄된 QR 안내물을 교체합니다.
  6. 이름이 변경되지 않으면 지원팀에 문의합니다.

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

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

해결 방법:

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

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

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

해결 방법:

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

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

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

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

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

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

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

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

해결 방법:

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

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

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

해결 방법:

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

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

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

해결 방법:

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

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

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

해결 방법:

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

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

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

해결 방법:

  1. Communication Hub → 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. 일정이 방금 변경되었다면 위젯을 새로 고치고 다음 전환을 기다립니다.

피드백 설정이 저장되지 않음​

보이는 현상: Save changes가 비활성화된 상태로 유지되거나 AVA가 설정을 거부합니다.

해결 방법:

  1. Rating question을 입력합니다.
  2. Follow-up question을 입력합니다.
  3. 두 지연 필드를 모두 1분에서 60분 사이로 설정합니다.
  4. 계정에 chatbot_setup:manage 권한이 있는지 확인합니다.
  5. Save changes를 다시 클릭합니다.

피드백 설정이 로드되지 않음​

보이는 현상: 피드백 제어 항목 대신 페이지에 오류가 표시됩니다.

해결 방법:

  1. 플랜에 Chatbot 기능이 포함되어 있는지 확인합니다.
  2. 역할에 chatbot_setup:manage 권한이 있는지 확인합니다.
  3. Try again을 클릭합니다.
  4. 호텔을 전환한 후 AVA를 새로 고칩니다.
  5. 페이지가 계속 로드되지 않으면 지원팀에 문의합니다.

버리기를 눌러도 변경 사항이 복원되지 않음​

보이는 현상: 미리보기 또는 필드에 저장하지 않은 값이 계속 표시됩니다.

해결 방법:

  1. 페이지 로드가 완료될 때까지 기다립니다.
  2. AVA에 Saving이 표시되지 않는지 확인합니다.
  3. Discard를 다시 클릭합니다.
  4. 호텔 컨텍스트가 최근에 변경되었다면 페이지를 새로 고칩니다.
  5. 저장된 값이 계속 잘못 표시되면 지원팀에 문의합니다.

투숙객에게 피드백 질문이 표시되지 않음​

보이는 현상: 위젯에 후속 질문이나 평점 요청이 표시되지 않습니다.

해결 방법:

  1. Communication Hub → Chatbot → Feedback Settings를 엽니다.
  2. Ask when a guest goes quiet 또는 Ask when staff closes a live chat이 켜져 있는지 확인합니다.
  3. 투숙객이 웹사이트 채팅 위젯을 사용하고 있는지 확인합니다.
  4. 대화 중단 피드백의 경우 두 지연 시간이 모두 지나갈 때까지 기다립니다.
  5. 대화가 변경되었다면 투숙객에게 새 메시지를 보내도록 요청합니다.

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

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

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

함께 보내면 좋은 정보:

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