대시보드 + AI 인사이트
운영 현황을 한눈에 파악하고 즉시 조치가 필요한 항목을 발견합니다. AI 인사이트는 챗봇 운영 품질을 자동 진단·개선 제안합니다.
메뉴 위치 · 목적
- 대시보드:
/property/dashboard— 좌측 사이드바 → 홈 그룹 (최상단) - AI 인사이트:
/property/ai-insights— 좌측 사이드바 → 홈 그룹
목적: 챗봇 운영의 모든 핵심 지표를 한눈에 파악하고 즉시 조치가 필요한 항목을 발견합니다. AI 인사이트는 챗봇 운영 품질을 진단하고 개선 제안을 받습니다.
본 챕터 캡처 이미지
| 파일명 | 캡처 대상 |
|---|---|
01-01-dashboard-main.png | 대시보드 진입 직후 전체 화면 |
01-02-warning-banner.png | 사용량 80%·100% 알림 배너 (배너 색·문구가 다름) |
01-03-cards-row1.png | 1행 카드: 현재 플랜 / 사용 기간 / AI 사용량 / 메시지 |
01-04-cards-row2.png | 2행 카드: 미처리 서비스 요청 / 미해결+플래그 / 만족도 / 쿠폰 |
01-05-chart.png | 메시지/토큰 추이 차트 + 4종 기간 토글 |
01-06-top-questions.png | 자주 묻는 질문 TOP 10 도넛 차트 (미응답 0건일 때) |
01-07-unanswered-card.png | 미응답 질문 TOP 5 카드 (미응답 있을 때 도넛 대체) |
01-08-charge-modal.png | 사용량 80%↑일 때 "충전하기" 버튼 클릭 시 열리는 충전 모달 |
01-09-org-dashboard.png | 조직 권한 로그인 시 보이는 조직 대시보드 |
01-10-ai-insights.png | AI 인사이트 페이지 진입 — 4 카드 + 프롬프트 품질 점수 |
01-11-prompt-quality.png | 프롬프트 품질 상세 — 강점/개선/누락 정보 3분할 |
1.1 대시보드 화면 구성
대시보드 진입 시 다음과 같이 위에서 아래로 배치됩니다.
(1) 상단 알림 배너 (조건부 노출)
| 배너 종류 | 노출 조건 | 표시 |
|---|---|---|
| Free 체험 만료 임박 | 체험 종료 15일 이내 | 노란색 배너 + "결제 페이지로 이동" 버튼 |
| AI 사용량 알림 | 사용량 80% 이상 (단일 배너, 100% 도달 시 빨강·문구 변경) | 80~89%: 노란색 / 90~99%: 진한 노랑 / 100%+: 빨강 + 충전 안내 |
(2) 핵심 지표 카드 (2행 × 4개)
1행
| 카드 | 표시 내용 | 클릭 동작 |
|---|---|---|
| 현재 플랜 | 플랜명만 | 카드 자체 클릭 동작 없음 — 카드 안 "업그레이드" 버튼만 작동 |
| 사용 기간 | 시작일 ~ 만료일, 남은 일수 | 만료 7일 이내일 때 카드 빨간색 + "연장하기 →" 링크 노출 |
| AI 사용량 | 사용률 (%) | 카드 자체 클릭 동작 없음. 80% 이상일 때 카드 안 "충전하기 →" 버튼 노출 |
| 메시지 (이번 사이클) | 누적 메시지 수 | 카드 자체 클릭 동작 없음 |
2행
| 카드 | 표시 내용 | 클릭 동작 |
|---|---|---|
| 미처리 서비스 요청 | 컨시어지 요청 중 미처리 건수 | 클릭 시 컨시어지 그룹의 요청 메뉴로 이동 (메뉴 라벨은 업종에 따라 "요청 관리"·"룸서비스 요청" 등) |
| 미해결 + 품질 플래그 | "개선필요" 영역의 누적 건수 | 클릭 시 AI 응답 관리 페이지로 이동 |
| 만족도 | 별점 평균 | 카드 자체 클릭 동작 없음 |
| 쿠폰 | 사용 가능 쿠폰 개수 | 클릭 시 /property/coupons 직접 이동 (사이드바 메뉴 X) |
(3) 메시지·토큰 추이 차트
기간 토글: 오늘 / 7일 / 30일 / 월별 + 지표 토글: 메시지 / 토큰
- 신규 운영 초기에는 7일 추이로 사용 패턴을 파악하시고, 운영이 안정되면 월별 추이로 트렌드를 보세요.
- 갑자기 메시지 수가 급증하면 분석 → 채팅 내역에서 어떤 질문이 많이 들어왔는지 점검합니다.
(4) 자주 묻는 질문 TOP 차트
미응답 질문 상태에 따라 다음 둘 중 하나가 표시됩니다.
| 상태 | 표시 |
|---|---|
| 미응답 질문 0건 | 자주 묻는 질문 TOP 10 도넛 차트 |
| 미응답 질문 1건 이상 | "미응답 질문 TOP 5" 카드가 도넛 차트를 대체 표시 (우선 처리하라는 신호) |
(5) 튜토리얼 퀘스트 카드 (운영 초기 노출, 일부 구현 예정)
- 첫 운영 단계에서 권장 작업을 단계별 안내합니다.
- 퀘스트 완료 시 쿠폰 등의 보상이 지급됩니다 (관리자 수동 발급은 일부 구현 예정).
1.2 자주 발생하는 상황과 처리
- 챗봇 응답이 즉시 일시 중단됩니다.
- 알림 배너에 충전 안내가 표시되며, 사용자가 직접 다음 중 하나로 복구합니다.
- AI 사용량 카드 또는 배너의 "충전하기" 버튼 → 충전 모달에서 패키지 추가 구매 (즉시 복구)
- 현재 플랜 카드의 "업그레이드" 버튼 → 상위 플랜으로 변경 (다음 사이클부터 한도 증가)
- 사용 기간은 결제일 기준 매월 같은 날 갱신됩니다.
- 예: 결제일이 5일이면 매월 5일 → 다음 달 4일까지가 한 사이클이고, 매월 5일 0시에 사용량이 자동 리셋됩니다.
- 충전한 사용량은 사이클 갱신 시 소멸됩니다. 사이클 만료 5일 이내 충전 시 화면에 "충전된 토큰 중 미사용분은 갱신 시 초기화됩니다" 경고가 표시되니 주의하세요.
- 대시보드에서 차트의 급증 시점을 확인합니다.
- 분석 → 채팅 내역 메뉴에서 같은 기간으로 날짜 필터를 적용해 대화 내용을 살펴봅니다.
- AI 응답 관리 → 미해결 질문 탭에 같은 시점에 등록된 미해결 질문이 있으면 신규 패턴일 가능성이 큽니다 → 학습 도구로 등록 (§3, §11 참고).
1.3 조직(Organization) 모드 사용자 안내
운영사·본부 권한으로 로그인하시면 조직 대시보드가 별도로 표시됩니다.
- 이번 달 메시지 수 (집계)
- 이번 달 토큰 수치 (% 아니라 원시 수치 표시)
- 채팅 링크 (운영사용)
- 소속 업체 목록 (슬러그 표시)
1.4 AI 인사이트
메뉴 위치: 좌측 사이드바 → 홈 그룹 → AI 인사이트 (/property/ai-insights)
무엇을 보나: AI가 자동 분석한 챗봇 운영 진단 결과 — 시스템 프롬프트(추가 안내 규칙) 품질 점수, 강점·개선 사항·누락 정보, 자주 묻는 질문 클러스터, 최근 분석 활동 타임라인.
4 카드 구성
| 카드 | 내용 |
|---|---|
| 개선 제안 대기 건수 | AI 자동 작업이 분석한 검토 대기 후보 |
| 자주 묻는 질문 클러스터 수 | 의미 단위로 묶인 질문 그룹 수 |
| 프롬프트 품질 점수 | 0~100점 — 시스템 프롬프트의 구조·완성도 |
| 프롬프트 등급 | A·B·C·D·F 5단계 (E 없음) |
프롬프트 품질 상세 (3분할)
- 강점: 잘 작성된 부분 → 그대로 유지
- 개선 사항: 보강이 필요한 영역 → 추가 안내 규칙 수정
- 누락 정보: 필수인데 빠진 영역 (예: 자사 응대 채널·환불 정책·운영시간 등) → 즉시 추가
- 품질 등급 해석: B 등급 이상이면 잘 작성된 프롬프트로 판단합니다. C 이하면 누락 정보·금지 행동·자사 응대 채널 등을 보강하세요.
자주 묻는 질문 도넛 차트
- 클러스터별 빈도와 % 표시 (TOP 10)
- 클릭 시 해당 클러스터에 속한 사용자 질문 목록 드릴다운
최근 분석 활동 타임라인
다음 분석 결과가 시간순으로 표시됩니다 — 어떤 분석이 언제 수행됐는지 감사 흔적.
- 자동 분류 (Phase 17 RAG 청크 분류)
- 품질 점검 (시스템 프롬프트 품질 평가)
- 안내 규칙 분석
- 문의 답변 초안 (관리자 → 업체 문의에 AI 초안 제공)
- AI 자동 작업 — 미해결 분석
- AI 자동 작업 — 품질 플래그 분석
1.5 다음으로 봐야 할 메뉴
대시보드에서 이상 신호를 발견하셨다면 다음 메뉴로 이동해 처리하세요.
| 신호 | 다음 메뉴 |
|---|---|
| 미해결 질문 / 품질 플래그 누적 | §3 AI 응답 관리 (챗봇 관리 그룹) |
| 미처리 서비스 요청 | §4 컨시어지 |
| 사용량·만족도 추이 분석 | §5 분석 (고객 인사이트 / 채팅 내역 / 만족도 평가) |
| 사용량 한도 도달 | §7 결제 / 충전 / 플랜 |
챗봇 관리
챗봇의 정체성·디자인·콘텐츠(FAQ·키워드·문서)·노출(QR)을 한 그룹에서 관리합니다.
메뉴 위치 · 하위 메뉴
- 그룹: 좌측 사이드바 → 챗봇 관리
- 하위 메뉴: 챗봇 설정 / AI 응답 관리(§3) / 동의어 관리(기업·AS센터만) / QR / 링크
본 챕터 캡처 이미지
| 파일명 | 캡처 대상 |
|---|---|
02-01-chatbot-tabs.png | 챗봇 설정 페이지 6개 탭 (기본 설정/채팅 디자인/체크리스트/FAQ 관리/키워드 응답/추가 안내 규칙) |
02-02-basic-greeting.png | 기본 설정 탭 — 환영/폴백/시스템 프롬프트 영역 |
02-03-basic-tone-language.png | 기본 설정 탭 — AI 응답 톤 + 다국어 지원 언어 영역 |
02-04-basic-rag.png | 기본 설정 탭 하단 — 매뉴얼 관리 (RAG, 기업·AS센터 한정) |
02-05-design-template.png | 채팅 디자인 탭 — 템플릿 갤러리 |
02-06-design-customize.png | 채팅 디자인 탭 — 좌측 커스터마이저 + 우측 미리보기 |
02-07-checklist.png | 체크리스트 탭 — 카테고리별 폼 필드 (값 입력만) |
02-08-faq-list.png | FAQ 관리 탭 — 좌측 목록 + 우측 챗봇 미리보기 |
02-09-faq-edit.png | FAQ 등록 모달 |
02-10-keyword-list.png | 키워드 응답 탭 — 메인 키워드 + 추가 키워드 수 |
02-11-keyword-edit.png | 키워드 등록 모달 — 응답 타입(텍스트/버튼) |
02-12-rule.png | 추가 안내 규칙 탭 |
02-13-synonym.png | 동의어 관리 (기업·AS센터 한정) |
02-14-qr-link.png | QR / 링크 페이지 — 위젯/iframe/QR/URL 4가지 노출 |
02-15-qr-print.png | QR 인쇄 디자인 화면 (페이지 안 버튼으로 진입) |
2.1 챗봇 설정 (6개 탭)
메뉴 위치: 챗봇 관리 → 챗봇 설정 (/property/chatbot-settings)
운영의 거의 모든 콘텐츠 설정이 이 페이지의 6개 탭에 집약. URL에 ?tab=... 쿼리로 직접 이동 가능.
| 탭 ID | 탭 라벨 | 무엇을 관리? |
|---|---|---|
settings | 기본 설정 | 환영 메시지, 폴백, 시스템 프롬프트, AI 톤, 다국어, 매뉴얼(RAG) |
design | 채팅 디자인 | 색상, 말풍선, 폰트, 테마 (템플릿 또는 직접 커스터마이징) |
checklist | 체크리스트 | 카테고리별 폼 필드에 값 입력 (운영 정보) |
faq | FAQ 관리 | 자주 묻는 질문 1문1답 |
keyword | 키워드 응답 | 단어 트리거 답변 |
rule | 추가 안내 규칙 | 시스템 프롬프트로 항상 주입되는 정책·톤·금지 |
2.1.1 기본 설정 탭
무엇을 하는 곳: 챗봇 정체성·인사말·답변 방식·다국어·문서 자료 설정.
주요 입력 항목
| 항목 | 설명 | 작성 팁 |
|---|---|---|
| 환영 메시지 | 고객이 챗봇을 처음 열었을 때 보이는 인사 | 1~2줄, 친근한 톤 + 어떤 도움 가능한지 한 줄 |
| 폴백 메시지 | AI가 답할 수 없을 때 자동 출력되는 안내 | "정확한 안내가 어렵습니다. 자사 응대 채널(전화·카카오톡 등)로 문의해 주세요" |
| 시스템 프롬프트(추가 안내 규칙) | 모든 답변에 항상 적용되는 챗봇 성격·정책·금지 | §2.1.6 참조 |
| AI 응답 톤(temperature) | 정확함(0.3) / 균형(0.7) / 창의적(1.2) 3단계 프리셋 | 정확함(0.3) 권장 |
| 다국어 지원 언어 | 챗봇이 응대할 언어 선택 (한국어 포함 12개 중) | 등록한 언어에서만 UI/키워드/컨시어지 매칭 동작. 미설정 언어는 영어로 답변 |
다국어 동작 정확화
- AI 답변 자체는 고객 입력 언어에 자동 대응 (한국어/영어/일본어/중국어 등 모두)
- UI/키워드 응답/컨시어지 키워드 매칭은 등록 언어에서만 동작
- 미설정 언어 → 시스템 안내(폴백 등)는 영어로
매뉴얼 관리 (RAG) — 기업·AS센터 업종만
기본 설정 탭 하단의 매뉴얼 관리 섹션은 업종이 기업 또는 AS센터일 때만 노출됩니다. 호텔/펜션·음식점·일반 업체에는 등록 UI 자체가 없습니다.
| 등록 방법 | 지원 형식 |
|---|---|
| 파일 업로드 | PDF / DOCX / XLSX / TXT / CSV 5종 |
| 웹사이트 크롤링 | URL 입력 → 자동 크롤링·임베딩 |
등록한 자료는 AI 답변 시 의미 기반(임베딩) 검색으로 인용되며, 출처도 함께 표시됩니다. 등록한 청크는 매뉴얼 관리 영역의 [AI 자동 분류 시작] 버튼으로 분석되어 FAQ/키워드/추가 안내 규칙 후보로 추천됩니다.
AI 자동 분류 (Phase 17)
- 트리거: 매뉴얼 관리 영역의 [AI 자동 분류 시작] 버튼 — 운영자 수동 클릭만 가능 (자동 정기 실행 없음)
- 플랜 차단: Free 플랜에서는 사용 불가. Basic 플랜 이상에서 사용 가능
- 토큰: 업체 부담 — 분류에 사용된 토큰은 업체 월 한도(usage_logs)에 차감됩니다
- 사용 한도: 마지막 분류 이후 새로 추가된 청크가 있으면 다시 사용 가능. 같은 청크 반복 분류는 결과 차이 + 토큰 낭비 방지를 위해 차단 — 사이트를 재크롤링하거나 PDF를 추가하면 자동으로 다시 활성화됩니다
- 결과: AI가 청크를 읽고 FAQ/키워드/추가 안내 규칙 후보를 추출해 검수 모달에 노출. 운영자가 일괄 검토·승인 시 실제 등록
자주 발생하는 상황
- AI 응답 톤이 창의적(1.2)으로 설정되어 있을 가능성. 기본 설정 탭에서 정확함(0.3)으로 변경.
- FAQ가 등록되어 있다면 매칭 우선순위가 높아 답변 일관성 향상.
- 계정 → 업체 정보에서 업체명·로고를 수정하면 챗봇 헤더에 자동 반영.
2.1.2 채팅 디자인 탭
무엇을 하는 곳: 챗봇 위젯 시각 디자인(색상·말풍선·배경·폰트). 변경 사항은 우측 미리보기에서 실시간 확인.
주요 기능
- 템플릿 갤러리: 업종·분위기별 디자인 템플릿 — 한 번 클릭으로 전체 적용
- 색상 커스터마이징: 메인 컬러·말풍선·배경·텍스트 색상 직접 지정
- 말풍선 모양: 둥근 / 알약 / 각진 3종
- 폰트: 한글 폰트 4종 (Pretendard / Noto Sans KR / IBM Plex Sans KR / system-ui) — 영문 폰트 별도 선택 옵션 없음
- 라이트/다크 미리보기 토글: 양쪽 모드 결과 동시 점검
자주 발생하는 상황
- 위젯은 브라우저에 캐시되어 있을 수 있음. 강력 새로고침(Ctrl+Shift+R / Cmd+Shift+R)으로 적용 확인.
- 그래도 안 바뀌면 임베드 스크립트가 최신 버전인지 — §2.3 QR/링크에서 새 코드 발급해 교체.
2.1.3 체크리스트 탭
무엇을 하는 곳: 챗봇 응답에 자동으로 반영되는 운영 정보(WiFi·체크인 시간·부서별 연락처 등)를 카테고리별 폼 필드에 값으로 입력하는 탭.
사용 흐름
- 카테고리별 폼 필드(예: WiFi 비밀번호·체크인 시간·부서별 연락처)에 값 입력
- 저장 → 시스템 프롬프트로 주입 → 챗봇 응답에 즉시 반영
업종별 시드
업종 선택 시 권장 카테고리·필드가 자동 시드됩니다. 모든 업종 시드에 "응답 스타일" 항목(친절·간결·존댓말 등)이 공통 포함되어 있어, 추가 안내 규칙에 같은 항목을 중복 등록할 필요는 없습니다.
2.1.4 FAQ 관리 탭
무엇을 하는 곳: 자주 묻는 질문에 대한 정확한 1문1답 등록. 사용자가 비슷한 질문을 다양한 표현으로 해도 AI가 의미 기반으로 매칭해 등록 답변 사용.
등록 흐름
- 신규 등록 버튼 클릭 → 모달 열림
- 질문: 자연스러운 한 문장 (예: "환불은 어떻게 받나요?")
- 답변: 2~5줄, 단계별 정보가 있다면 번호 목록(1. 2. 3.)으로 정리
- 저장 → 즉시 챗봇 응답에 반영
작성 팁
- 답변에 자사 응대 채널 링크/번호를 함께 표기하면 AI가 답을 못 찾을 때도 일관 안내 가능
- 같은 의도의 다른 표현(동의어)은 별도 등록할 필요 없이 의미 기반 매칭으로 자동 처리
- 너무 일반적인 질문(예: "도와주세요")은 등록하지 마세요 — 매칭이 잘못 일어날 수 있음
미리보기
FAQ 관리 탭 우측에는 챗봇 미리보기 패널이 sticky 표시되어 등록 후 즉시 테스트 가능합니다.
2.1.5 키워드 응답 탭
무엇을 하는 곳: 사용자 메시지에 특정 단어가 들어오면 자동 트리거되는 답변 등록.
매칭 방식 — 부분 문자열 매칭 (대소문자 무시)
키워드 응답은 정확 매칭이 아니라 부분 문자열 매칭입니다. 예: 메인 키워드 "가격" 등록 시 "가격이 얼마예요?", "가격표 주세요"처럼 키워드가 메시지의 일부에 포함되기만 하면 매칭됩니다.
등록 흐름
- 신규 등록 버튼 클릭
- 메인 키워드: 가장 대표적인 단어 1개 (예: "가격")
- 추가 키워드: 같은 의도의 다른 표현 (예: "요금", "비용", "얼마")
- 응답 타입 선택: 텍스트 또는 버튼
- 텍스트: 답변 텍스트 입력
- 버튼: 버튼 라벨 + 클릭 시 이동할 URL
- 저장
작성 팁
- 너무 짧은 단어(예: "네", "응")는 의도치 않게 매칭되니 피하세요
- 여러 키워드 그룹으로 자주 묻는 단어 군을 묶으세요 — 예: "가격/요금/비용/얼마" 한 그룹으로 가격 페이지 안내
- 답변에 외부 링크 포함 가능 (자사 홈페이지·상세 페이지·자사 응대 채널 안내)
2.1.6 추가 안내 규칙 탭
무엇을 하는 곳: 모든 답변에 항상 적용되는 챗봇 성격·정책·금지 사항을 시스템 프롬프트로 등록. FAQ·키워드와 달리 개별 매칭 X, 항상 컨텍스트 주입.
추가 안내 규칙에 들어가야 하는 것
- 챗봇 정체성: "당신은 [업체명]의 고객 응대 챗봇입니다"
- 금지 사항: 가격 할인 약속·구체 수치 약속·다른 업체와 비교 등 금지
- 에스컬레이션 룰: 정확한 안내 어려울 시 자사 응대 채널 안내
- 자사 응대 채널 정보: 전화번호·카카오톡 채널 ID·이메일 등을 명시
- 자주 발생하는 오해 정정: 업체 특수 용어·자주 잘못 이해하는 부분
- 운영 정책: 결제·환불·서비스 처리 룰
작성 예시
## 챗봇 정체성 - 당신은 [업체명]의 고객 응대 챗봇입니다. ## 금지 행동 - 가격 할인이나 특정 약속을 절대 하지 않으며, 가격 정책은 공식 안내로 대체합니다. ## 에스컬레이션 - 자세한 안내가 필요한 경우 자사 응대 채널로 안내합니다. ## 자사 응대 채널 - 전화: 000-0000-0000 (평일 10:00~19:00) - 카카오톡: @[채널명] - 이메일: support@example.com
2.2 동의어 관리 기업·AS센터 전용
메뉴 위치: 챗봇 관리 → 동의어 관리 (/property/synonyms)
노출 조건: 업종이 기업 또는 AS센터일 때만 사이드바에 노출
무엇을 하는 곳: RAG(문서) 검색 시 동의어를 확장해 매칭률 향상. 예: 사용자가 "휴가" 입력 시 등록 동의어 "연차"·"휴무"도 검색에 포함.
등록 흐름
- 메인 단어 입력 (예: "환불")
- 동의어 입력 — 쉼표(,) 구분 (예: "취소, 반품, 돌려받기")
- 저장
자주 발생하는 상황
- 업종이 기업·AS센터가 아닌 경우 메뉴 자체가 노출되지 않습니다. 업종 변경이 필요하면 OA Chatbot 고객센터 → 1:1 문의로 신청해 주세요.
2.3 QR / 링크
메뉴 위치: 챗봇 관리 → QR / 링크 (/property/qr)
무엇을 하는 곳: 챗봇을 고객에게 노출하는 4가지 방법 — 위젯 임베드 / iframe / QR 코드 / 전용 URL — 을 한 페이지에서 발급·관리. QR 인쇄 디자인은 별도 사이드바 메뉴가 아니라 본 페이지의 버튼으로 진입합니다.
4가지 노출 방법
| 방법 | 사용처 | 발급 |
|---|---|---|
| 위젯 임베드 스크립트 | 자사 홈페이지 우측 하단 챗봇 위젯 | <script> 코드를 </body> 직전에 붙여넣기 |
| iframe 임베드 | 페이지 일부 영역에 챗봇 화면 직접 표시 | <iframe> 코드 복사 |
| QR 코드 | 매장 안내문·전단·테이블 스티커·명함 | PNG 다운로드 (SVG 미지원) |
| 전용 URL | 카카오톡/문자/이메일 직접 공유 | URL 복사 (https://oachat.ai/chat/{슬러그}) |
QR 인쇄 디자인
QR / 링크 페이지 안의 "QR 인쇄 디자인" 버튼을 클릭해 진입합니다 (사이드바 별도 메뉴 아님). 카드 색상·로고·문구를 조정하고 인쇄용 PDF/이미지로 다운로드 가능합니다.
자주 발생하는 상황
- 브라우저 캐시 또는 CDN 캐시 문제. 강력 새로고침(Ctrl+Shift+R)으로 확인.
- 그래도 안 바뀌면 임베드 스크립트가 최신 버전인지 — 본 페이지에서 다시 복사해 교체.
OA Chatbot 사용 가이드북
AI 챗봇 SaaS 플랫폼 운영 메뉴얼 — 업체(Property) 운영자용
가이드북 소개
본 가이드는 호텔/펜션·음식점·병원·쇼핑몰·교육·AS센터·기업 등 다양한 업종에서 OA Chatbot을 운영하시는 모든 분들을 대상으로 합니다.
목차 — 11개 섹션
| 01 | 대시보드 + AI 인사이트 운영 현황 한눈에 + 챗봇 품질 자동 진단 |
| 02 | 챗봇 관리 챗봇 설정 6탭 · 동의어 · QR/링크 |
| 03 | AI 응답 관리 ⭐ 미해결 질문 · 품질 플래그 · 자동 작업 |
| 04 | 컨시어지 (서비스 요청) 카테고리 · 키워드 · 폼 빌더 · 요청 처리 |
| 05 | 분석 고객 인사이트 · 채팅 내역 · 만족도 평가 |
| 06 | 외부 연동 SMS / Slack / Sheets / Monday / Webhook |
| 07 | 결제 / 충전 / 플랜 쿠폰 · 결제 내역 · 사용량 충전 · 플랜 변경 |
| 08 | 직원 / 권한 계정 추가 · 권한 그룹 6종 |
| 09 | 자주 묻는 질문 운영 중 가장 자주 받는 질문 모음 |
| 10 | 트러블슈팅 장애·문제 상황별 빠른 진단 |
| ⭐ | 1분 가이드 자주 마주치는 상황별 빠른 처리 |
가이드북 사용 안내
- 각 메뉴는 좌측 사이드바에서 접근합니다. 사이드바 메뉴 구조는 업종에 따라 일부 차이가 있을 수 있습니다.
- 모바일에서도 동일 메뉴 접근이 가능하며, 화면 상단 햄버거(≡) 버튼으로 펼칠 수 있습니다.
- 가격·플랜별 한도·요금제 비교는 https://oachat.ai/pricing 에서 확인하세요. 본 가이드에는 구체 가격 수치를 포함하지 않습니다.
- 검색(Ctrl+K)으로 빠르게 탐색하실 수 있습니다.
"1:1 문의" vs "자사 응대 채널" 구분 중요
가이드북 전반에서 다음 두 표현을 명확히 구분합니다.
| 표현 | 의미 |
|---|---|
| 1:1 문의 | 운영자(업체)가 OA Chatbot 본사에 시스템·결제·기능 문의 — 좌측 메뉴 → 고객센터 → 1:1 문의 |
| 자사 응대 채널 | 업체가 자기 고객에게 안내하는 응대 방법 (전화·카카오톡·이메일 등 — 업체별 자체 채널) |
AI 응답 관리 ⭐
챗봇이 답변하지 못한 질문·문제 응답을 모아 학습합니다. 챗봇 응답 품질을 가장 효과적으로 끌어올리는 메뉴입니다.
메뉴 위치 · 페이지 구조
- 메뉴 위치: 좌측 사이드바 → 챗봇 관리 → AI 응답 관리 (
/property/ai-response) - 페이지 구조: 단일 페이지 + 2개 탭 (미해결 질문 / 품질 플래그) + AI 자동 작업 모달
본 챕터 캡처 이미지
| 파일명 | 캡처 대상 |
|---|---|
03-01-overview.png | AI 응답 관리 진입 — 2탭 헤더 + 우상단 AI 자동 작업 버튼 |
03-02-unanswered-list.png | 미해결 질문 탭 — 클러스터별 빈도 |
03-03-unanswered-resolve.png | 미해결 항목 클릭 시 학습 등록 모달 (FAQ/키워드/추가 안내 선택) |
03-04-quality-list.png | 품질 플래그 탭 — 4종 라벨 필터 (정보 부족 제외) |
03-05-quality-detail.png | 품질 플래그 상세 — 대화 맥락 + 학습 옵션 |
03-06-auto-action-modal.png | AI 자동 작업 모달 — 후보 검수 + 일괄 승인 |
3.1 학습 도구 3종 — 어디다 등록?
운영의 핵심은 들어온 질문을 어디에 등록할지 결정하는 것입니다.
| 도구 | 매칭 방식 | 언제 사용 | 등록 위치 |
|---|---|---|---|
| FAQ | 의미 기반 매칭 (다양한 표현 자동 인식) | 명확한 1문1답이 가능할 때 | 챗봇 관리 → 챗봇 설정 → FAQ 관리 |
| 키워드 응답 | 부분 문자열 매칭(대소문자 무시) | 단어 트리거로 동일 답변 | 챗봇 관리 → 챗봇 설정 → 키워드 응답 |
| 추가 안내 규칙 | 매칭 X — 모든 답변에 항상 컨텍스트로 주입 | 정책·톤·금지·자사 응대 채널 안내 | 챗봇 관리 → 챗봇 설정 → 추가 안내 규칙 |
결정 트리
3.2 미해결 질문 탭
위치: AI 응답 관리 페이지 → 미해결 질문 탭 (기본 활성)
무엇을 하는 곳: AI가 답변하지 못한 사용자 질문이 자동으로 누적되는 학습 대기열. 같은 의도의 질문은 자동 클러스터링되며 발생 횟수 높은 순으로 정렬.
화면 구성
- 목록 정렬: 빈도 ↓ / 최근 발생 시각 ↓
- 상태 필터: 대기 / 처리됨 / 무시
- 항목 클릭: 학습 등록 모달 열림
학습 등록 흐름
- 항목 선택 → 학습 등록 모달
- 등록 위치 선택: FAQ / 키워드 응답 / 추가 안내 규칙 (§3.1 결정 트리 참조)
- 답변 작성 → 저장
- 항목 상태 자동으로 처리됨으로 변경, 챗봇 응답에 즉시 반영
- 무시: 학습 가치 없는 노이즈 질문(욕설·테스트·랜덤 텍스트)은 무시 처리
3.3 품질 플래그 탭
위치: AI 응답 관리 페이지 → 품질 플래그 탭
무엇을 하는 곳: 응답 품질에 문제가 있다고 분류된 대화를 모아 보여주는 영역. AI 또는 패턴 매칭이 자동 부착한 품질 플래그가 있는 사용자 메시지가 표시됩니다.
품질 플래그 5종 (한글 라벨)
| 플래그 라벨 | 의미 | 부착 방식 | 필터 노출 |
|---|---|---|---|
| 불만족 | 사용자가 화났거나 욕설 표현 | 패턴 매칭 (욕설·"말이 안통하네" 등) | ✅ 필터 가능 |
| 직원 요청 | 사용자가 사람 담당자 요청 | 패턴 매칭 ("AI 말고", "직원 연결") | ✅ |
| 범위 밖 | 챗봇 역할 범위 밖 질문 | 백그라운드 AI 분류 | ✅ |
| 검색 미매칭 | RAG 문서 검색 매칭 실패 (RAG 사용 업종 한정) | 시스템 자동 | ✅ |
| 정보 부족 | AI가 "정보 없음·답변 불가"로 응답 | 백그라운드 AI 분류 | ❌ — 미해결 질문 탭에서 별도 처리 |
라벨별 권장 처리
| 라벨 | 권장 처리 |
|---|---|
| 불만족 / 직원 요청 | 추가 안내 규칙 보강 — 욕설·공격적 표현 응대 룰, 에스컬레이션 룰 |
| 범위 밖 | 추가 안내 규칙에 답변 가능 범위 명시 또는 무시 처리 |
| 검색 미매칭 | FAQ 등록 또는 문서 자료 추가 (RAG 사용 업종 한정) |
3.4 AI 자동 작업 (자동 분류 + 일괄 등록)
위치: AI 응답 관리 페이지 → 우상단 AI 자동 작업 버튼
무엇을 하는 곳: AI가 미해결 질문·품질 플래그를 분석해 FAQ/키워드/추가 안내 규칙 후보를 자동 추천합니다. 운영자는 후보를 일괄 검수·승인합니다.
동작 방식
- 분석 트리거 — 운영자가 수동으로 버튼 클릭 시에만 분석 시작 (자동 정기 실행 없음)
- 분석 데이터 소스:
- 미해결 질문 — 빈도 높은 패턴 → FAQ/키워드 후보
- 품질 플래그 — 응대 톤·정책 패턴 → 추가 안내 규칙 후보
- 2단계 프롬프팅: Stage1 분류·초안 생성 → Stage2 검증·개선
- 후보를 검수 모달로 노출 → 운영자 승인 시 실제 등록
3.5 AI 챗봇 점검
위치: 좌측 사이드바 → 챗봇 관리 그룹 → AI 챗봇 점검 (AI 응답 관리 다음)
무엇을 하는 곳: 등록한 챗봇 자료(FAQ · 키워드 응답 · 추가 안내 규칙 · 체크리스트) 전체를 AI가 한 번에 점검해 정리할 항목을 추천합니다. 위치 부적절·중복·의도 충돌·동기화 누락 등 운영자가 발견하기 어려운 구조적 문제를 잡아냅니다.
동작 방식
- [점검 시작하기] 또는 [다시 점검] 버튼 클릭
- 백그라운드 분석 진행 — 약 10~30초 소요. 페이지를 떠나도 계속 진행
- 결과 노출 — 카테고리별 탭(전체 / 키워드 응답 / FAQ / 추가 안내 규칙 / 체크리스트 / 중복)으로 분류된 추천 카드
- 같은 항목 다중 추천은 카드 1개로 그룹화 — 카드 클릭 시 모달 안에서 추천별로 [✓ 적용 완료] / [✗ 무시] 처리
점검 항목 (룰)
| 룰 | 설명 |
|---|---|
| 중복 등록 | 키워드 응답 ↔ FAQ ↔ 추가 안내 규칙에 같은 내용이 중복 등록 |
| 위치 부적절 | 키워드 응답에 들어가야 할 정보가 추가 안내 규칙에 박혀 있거나 그 반대 |
| 의도 충돌 | 한 키워드 응답의 서브 키워드들이 서로 다른 의도(위치/긴급/분쟁 등)인데 답변이 한 의도에만 맞춰진 경우 — 분리 권장 |
| 키워드 형식 | 서브 키워드가 자연어 문장 형태(공백 7자+)라 substring 매칭 거의 불가능 — 짧은 핵심 단어로 단축 권장 |
| FAQ 답변 길이 | 답변 500자 초과 — 자주 묻는 질문 chip 클릭 시 가독성 ↓ + 매번 토큰 비용 누적 |
| FAQ 질문 형태 | 질문이 35자 초과이거나 슬래시·쉼표로 키워드 나열 — chip 디스플레이 잘림 + 정확 매칭 0% |
| FAQ ↔ 체크리스트 동기화 | FAQ 답변에 등록된 정형 정보(시간/Wi-Fi 비번/주소 등)가 체크리스트와 다른 값이거나 미등록 — 정책 변경 시 한쪽만 수정되어 정보 불일치 위험 |
처리 흐름
- 카드 클릭 → 모달에서 현상 / 사용자 영향 / 기대 효과 / 권장 액션과 원본 내용 확인
- 안내된 메뉴로 이동해 직접 수정 (예: 챗봇 관리 → 키워드 응답 / FAQ / 챗봇 설정 → 추가 안내 규칙)
- 모달로 돌아와 [✓ 적용 완료] 또는 [✗ 무시] 클릭
- 처리된 추천은 좌측 4px 색상 바 + 안내 띠로 명시되어 진행 상황을 한눈에 확인
3.6 챗봇 응답률
응답률 산식·집계 단위는 §5.1 고객 인사이트 참조.
컨시어지 (서비스 요청)
채팅에서 AI가 단순 답변을 넘어 실제 서비스 요청·주문을 폼으로 받아 접수까지 자동화합니다.
메뉴 위치 · 하위 페이지
- 그룹: 좌측 사이드바 → {컨시어지/룸서비스 등 — 업종별 라벨} 그룹
- 서비스 설정 (
/property/room-service-settings) — 카테고리 관리·폼 빌더 등이 모두 이 페이지의 탭으로 통합 - 요청 관리 (또는 "컨시어지 내역") — 들어온 요청 처리
- 매출내역 / 매출분석 — 결제된 요청 매출 집계
본 챕터 캡처 이미지
| 파일명 | 캡처 대상 |
|---|---|
04-01-settings-tabs.png | 서비스 설정 페이지 진입 (탭: 카테고리 관리 / 폼 필드 / 운영시간 등) |
04-02-category-list.png | 카테고리 관리 탭 — 카테고리 목록 |
04-03-category-edit.png | 카테고리 등록·수정 모달 (이름·키워드 칩별 입력) |
04-04-form-builder.png | 폼 빌더 — 카테고리별 입력 필드 |
04-05-request-list.png | 요청 관리(컨시어지 내역) 목록 |
04-06-request-detail.png | 요청 상세 — 처리·환불·고객 연락 |
04-07-trigger-flow.png | 채팅 → 매칭 → 1턴 안내 → 폼 노출 흐름 |
04-08-operating-hours.png | 업체 전역 운영시간 설정 |
4.1 컨시어지 활용 (업종별)
| 업종 | 활용 예시 |
|---|---|
| 호텔/펜션 | 어메니티 요청, 추가 침구, 모닝콜, 체크아웃 연장 |
| 음식점/카페 | 추가 주문, 포장 요청, 알레르기 정보 |
| 병원/클리닉 | 진료 예약 변경, 처방전 재발급 |
| 쇼핑몰/매장 | 사이즈 변경, 색상 문의, 재입고 알림 |
| 기업/AS센터 | AS 신청, 견적 요청, 상담 예약 |
동작 흐름 (4단계)
4.2 카테고리 관리 (서비스 설정 → 카테고리 관리 탭)
메뉴 위치: 컨시어지 그룹 → 서비스 설정 페이지 → 카테고리 관리 탭
무엇을 하는 곳: 어떤 종류의 서비스 요청을 받을지 카테고리로 묶어 관리. 카테고리마다 트리거 키워드와 폼 필드가 별도 설정.
등록 흐름
- 카테고리 추가 → 모달
- 이름 입력 (예: "객실 비품", "추가 주문", "AS 신청")
- 트리거 키워드 — 칩(chip) 단위 입력 (콤마 구분 X) — 예: "수건"·"가운"·"어메니티" 각각 칩으로 추가
- 저장 → 즉시 적용
4.3 폼 빌더 (입력 필드 설정)
메뉴 위치: 컨시어지 그룹 → 서비스 설정 → 카테고리 클릭 → 폼 필드 탭
무엇을 하는 곳: 카테고리별로 사용자가 입력할 폼 필드를 설계.
지원 필드 타입 5종
| 타입 | 용도 | 예시 |
|---|---|---|
| text | 자유 입력 | 이름, 메모 |
| number | 숫자 입력 | 수량, 인원 |
| textarea | 긴 텍스트 | 요청 사항 |
| select | 단일 선택 | 사이즈(S/M/L), 좌석 |
| checkbox-group | 다중 선택 | 알레르기 항목, 옵션 다중 (콤마 구분 저장) |
4.4 요청 관리 (컨시어지 내역)
메뉴 위치: 컨시어지 그룹 → 요청 메뉴 (라벨은 업종별로 다름 — 일반적으로 "컨시어지 내역" 또는 "요청 관리")
상태 흐름
환불 — 결제 상태와 분리
요청 상태와 결제 상태는 별도 항목입니다.
- 결제 안 된 요청 취소 → 단순 요청 상태만 변경
- 결제된 요청 환불 → 결제 상태를 "환불됨"으로 변경 (별도 처리)
처리 시 주의
- 외부 연동 자동 동기화: 상태 변경은 Slack/Sheets/Monday/Webhook 4채널에 자동 반영. 외부 시스템에서는 상태와 메모만 수정 가능, 데이터 삭제 금지
- 고객 연락처: 폼에 연락처 필드가 있다면 직접 통화/문자
4.5 운영시간 — 업체 전역 1쌍
메뉴 위치: 컨시어지 그룹 → 서비스 설정 → 운영시간 영역 (또는 챗봇 관리 → 운영시간)
무엇을 하는 곳: 서비스 요청 접수 가능 시간을 정하고, 외 시간엔 자동 안내·차단.
- 운영시간: 서비스 요청 접수 가능 시간
- 운영시간 외 동작: AI가 자동으로 운영시간을 안내하고 폼 노출 차단
4.6 자주 발생하는 상황
- 1턴 안내 끝에 확인 버튼이 노출되거나, 사용자가 명확한 긍정 답변("네", "신청해주세요")을 입력해야 폼이 노출됩니다 — 의도된 2턴 플로우.
- 운영시간 외 시간일 가능성. 운영시간 내인지, 카테고리 활성 상태인지 확인.
- 외부 연동 설정 — 컨시어지·예약 별도 토글 + 채널별 인증 정보 정상 입력 여부 확인. §6 참조.
분석
챗봇 운영 성과를 다각도로 분석합니다 — 응답률·만족도·매출·자주 묻는 질문·AI 운영 자동화 결과.
메뉴 위치 · 하위 메뉴
- 그룹: 좌측 사이드바 → 분석 그룹
- 하위 메뉴: 고객 인사이트 / 채팅 내역 / 만족도 평가
본 챕터 캡처 이미지
| 파일명 | 캡처 대상 |
|---|---|
05-01-customer-insights.png | 고객 인사이트 진입 — 4 카드 |
05-02-customer-charts.png | 만족도·자주 묻는 질문 차트 영역 |
05-03-chat-history.png | 채팅 내역 — 날짜 + 기간 프리셋 |
05-04-chat-detail.png | 채팅 상세 |
05-05-satisfaction.png | 만족도 평가 페이지 |
5.1 고객 인사이트
메뉴 위치: 분석 → 고객 인사이트
4 카드 구성 (실제 코드 기준)
| 카드 | 표시 내용 |
|---|---|
| 총 대화 수 | 누적 대화 세션 수 |
| AI 응답률 | 아래 "AI 응답률 산식" 참조 |
| AI 사용량 | 사이클 사용률 (%) |
| 절감 효과(ROI) | AI 응답 1건당 평균 시간 절감 + 인건비 환산 추정치 |
AI 응답률 산식
- 분자: 기간 내 모든 AI 응답 메시지
- 분모: AI 응답 + 미해결 질문 누적 카운트
- 집계 기간: 롤링 7일 / 30일 (카드 토글로 전환)
응답률 올리려면
- 미해결 질문을 학습 도구(FAQ/키워드)로 정기 등록
- 품질 플래그 검토로 응대 톤 보강
- 추가 안내 규칙에 자사 응대 채널 안내 룰 명시 → 폴백도 정상 응답 톤 유지
만족도·자주 묻는 질문 차트
- 만족도 차트: 별점 분포·추이
- 자주 묻는 질문 TOP 10 차트 (고객 인사이트 페이지 기준)
- 리포트 미리보기에 표시되는 자주 묻는 질문은 TOP 5
5.2 채팅 내역
메뉴 위치: 분석 → 채팅 내역
무엇을 하는 곳: 지난 대화를 날짜 단위로 조회. 운영 트러블슈팅·고객 응대 후속 활용.
필터
- 날짜 범위: 시작일·종료일 지정
- 기간 프리셋 버튼: 1주 / 2주 / 1달
자주 발생하는 상황
- Free 플랜: 7일간 보존
- 유료 플랜: 무제한 보존
- (보존 정책은 OA Chatbot 시스템 정책이며, 업체 추가 안내 규칙과는 무관합니다)
5.3 만족도 평가
메뉴 위치: 분석 → 만족도 평가
무엇을 하는 곳: 채팅 종료 시 고객이 남긴 별점·코멘트를 모아 보는 페이지. 만족도 추이와 코멘트 검색 가능.
외부 연동
챗봇이 받은 컨시어지 요청·예약·상태 변경을 외부 운영 도구로 실시간 동기화하고 SMS도 발송합니다.
메뉴 위치 · 하위 메뉴
- 그룹: 좌측 사이드바 → 외부 연동 그룹
- 연동 설정 (
/property/integrations) — 채널별 인증·활성화 - 연동 로그 — 동기화 성공/실패 이력 조회
본 챕터 캡처 이미지
| 파일명 | 캡처 대상 |
|---|---|
06-01-integration-tabs.png | 연동 설정 진입 — 5채널 탭 (SMS / Slack / Sheets / Monday / Webhook) |
06-02-sms.png | SMS 탭 — 발신번호·충전 |
06-03-slack.png | Slack 탭 — "Slack 연결하기" OAuth 버튼 |
06-04-sheets.png | Sheets 탭 — Service Account 이메일 + Spreadsheet ID |
06-05-monday.png | Monday 탭 — API Token + 자동 보드 생성 안내 |
06-06-webhook.png | Webhook 탭 — URL 입력 + 연동 가이드 링크 |
06-07-test-result.png | Slack 연결 테스트 결과 (Slack만 지원) |
06-08-integration-log.png | 연동 로그 페이지 |
6.1 지원 채널 (5종) — SMS 첫 탭
연동 설정 페이지에 5개 탭이 있습니다. 첫 탭이 SMS입니다.
| 탭 | 인증 방식 | 특징 |
|---|---|---|
| SMS | 발신번호 등록 + 패키지 충전 | 컨시어지 요청·예약 알림 등에 SMS 발송 |
| Slack | "Slack 연결하기" 버튼 → OAuth 원클릭 (Webhook URL은 폴백) | 실시간 메시지 |
| Google Sheets | Service Account 이메일을 시트에 공유 + Spreadsheet ID 입력 (OAuth 사용 안 함) | 행 단위 누적 |
| Monday.com | API Token 입력 → 카테고리별 보드 자동 생성 (컬럼 매핑 UI 없음) | 보드/아이템으로 관리 |
| Webhook | 임의 HTTPS URL 입력 | 자체 시스템 연동, JSON POST 수신 |
6.2 채널별 설정
Slack — OAuth 원클릭
- Slack 탭 진입 → "Slack 연결하기" 버튼
- Slack OAuth 화면에서 워크스페이스·채널 선택 → 자동 토큰 발급
- (대안) 직접 Webhook URL 입력 — 폴백용
Google Sheets — Service Account
- 본 페이지에서 안내된 Service Account 이메일(고정 주소)을 복사
- 운영자가 알림 받을 시트의 공유 권한에 해당 이메일을 편집자로 추가
- Spreadsheet ID를 본 페이지에 입력 → 저장
Monday.com — 카테고리별 자동 보드 생성
- Monday API Token 발급 (Monday → 개인 설정 → API)
- Token 입력 + 저장
- 카테고리별로 보드/아이템이 자동 생성됩니다 — 컬럼 매핑 UI는 없으며 시스템이 자동 처리
Webhook
- 자체 시스템에 HTTPS 엔드포인트 준비 (POST 수신)
- URL 입력 + 저장
- 페이로드 형식은 본 페이지의 "연동 가이드" 링크에서 확인
6.3 컨시어지 vs 부킹(예약) 외부 연동 — 별도 토글
중요: 컨시어지(서비스 요청)와 부킹(예약) 외부 연동은 별도로 관리됩니다.
- 같은 Slack 채널을 양쪽에서 사용해도 양쪽 토글을 각각 켜야 알림 발송
- 한쪽 토글만 켠 상태로 다른 쪽 알림이 안 온다고 오해하지 마세요
6.4 연결 테스트 — Slack만 지원
연결 테스트 버튼은 Slack 탭에만 존재합니다. Sheets/Monday/Webhook은 자체 채널에서 알림 도착 여부를 직접 확인해야 합니다.
6.5 연동 로그
메뉴 위치: 외부 연동 → 연동 로그
연동 호출의 성공/실패·타임스탬프·페이로드를 확인할 수 있습니다. 알림이 안 오면 우선 이 메뉴에서 호출 시도가 됐는지 확인하세요.
6.6 자주 발생하는 상황
- 외부 시스템(Sheets·Monday 등)에서는 상태와 메모만 수정 가능, 데이터 삭제 금지입니다. 자사 데이터와 불일치가 발생하며 동기화가 깨집니다.
- 데이터 정정이 필요하면 고객센터 → 1:1 문의로 신청해 주세요.
- Token 만료 가능성 — 채널별 설정 재확인 + Slack은 연결 테스트 실행
- 연동 로그에서 호출 시도 여부 확인
결제 / 충전 / 플랜
플랜·사용량·SMS 충전·결제 내역을 관리합니다. 별도 통합 메뉴는 없고 진입점이 분산되어 있습니다.
진입점 (분산)
- 계정 → 결제 내역: 결제·환불·영수증 조회
- 대시보드 AI 사용량 카드 → 충전하기 버튼(80%↑부터 노출): 사용량 충전
- 대시보드 현재 플랜 카드 → 업그레이드 버튼: 플랜 변경
- 외부 연동 → SMS 탭 → "+ 충전하기" 모달: 문자 패키지 추가
/property/coupons(사이드바 메뉴 없음, 대시보드 쿠폰 카드 또는 직접 URL): 쿠폰함
본 챕터 캡처 이미지
| 파일명 | 캡처 대상 |
|---|---|
07-01-coupon.png | 쿠폰함 페이지 |
07-02-plan-upgrade.png | 플랜 업그레이드 — 플랜 카드 + 월간/연간 토글 |
07-03-token-charge.png | 사용량 충전 모달 (대시보드 AI 사용량 카드의 "충전하기" 버튼) |
07-04-billing-history.png | 계정 → 결제 내역 |
07-05-receipt.png | 토스 PG 영수증 |
07-06-sms-charge.png | SMS 충전 모달 (외부 연동 → SMS 탭 → "+ 충전하기") |
7.1 쿠폰함
진입: 대시보드 쿠폰 카드 클릭 → /property/coupons (사이드바 메뉴 없음)
무엇을 하는 곳: 튜토리얼 퀘스트·이벤트로 받은 쿠폰을 보관하고 사용합니다. 사용 시 AI 사용량 한도에 즉시 합산.
사용 흐름
- 쿠폰함 → "사용 가능" 탭
- 사용할 쿠폰 클릭 → 사용 버튼
- AI 사용량 한도에 즉시 합산
발급 경로
- 튜토리얼 퀘스트: 첫 운영 단계 권장 작업 완료 시 자동 지급
- 이벤트: 비정기 프로모션 보상
- 관리자 수동 발급은 일부 미구현 — 필요 시 OA Chatbot 고객센터 문의
만료 정책
- 만료 임박 14일 이내: 화면에 임박 표시
- 사이클 만료 5일 이내 사용 시: "충전된 토큰 중 미사용분은 갱신 시 초기화" 경고
7.2 플랜 업그레이드
진입: 대시보드 → 현재 플랜 카드 → "업그레이드" 버튼 (또는 플랜 만료 시 자동 노출 페이지)
플랜 종류
| 플랜 | 특징 |
|---|---|
| Free | 무료 체험 (자동 결제 X) |
| Basic | 소규모 운영 |
| Premium | 대부분 운영 가능 (라이브챗 등 일부 기능은 구현 예정) |
| Custom | 대규모 운영·맞춤 — OA Chatbot 고객센터 문의 (랜딩 "엔터프라이즈" 옵션과 동일) |
월간/연간 토글
- 연간 결제 시 일부 개월 무료 (정확한 비율은 가격 페이지 참조)
- 다운그레이드 시 현재 플랜 만료일까지 사용 후 자동 전환
- Free 체험 종료 시 자동 결제로 전환되지 않음 — 업체가 직접 유료 전환 신청
7.3 사용량(토큰) 충전
진입: 대시보드 → AI 사용량 카드의 "충전하기" 버튼(사용량 80%↑일 때 노출)
사용량 충전 정책
- 충전된 사용량은 사이클 갱신 시 소멸됩니다
- 차감 우선순위: 기본 제공분 → 충전분
7.4 SMS 충전
진입: 외부 연동 → SMS 탭 → "+ 충전하기" 모달
SMS 충전 정책
- 매월 무상 발송 건수 + 충전 패키지 양쪽 운영
- 메시지 종류별 차감 비율 다름 (SMS·LMS·MMS 별도)
- 차감 우선순위: 무상 발송분 → 충전분
- 충전한 SMS 패키지는 소모 전까지 영구 보존됩니다 (사이클 갱신과 무관).
7.5 결제 내역 + 영수증 / 세금계산서
메뉴 위치: 좌측 사이드바 → 계정 → 결제 내역 (/property/billing)
영수증
- 영수증 버튼 클릭 → 토스페이먼츠 PG 영수증 페이지 즉시 표시
세금계산서 발급
- 별도 세금계산서가 필요한 경우 고객센터 → 1:1 문의로 사업자 정보(상호·사업자등록번호·이메일)와 함께 신청 → 수기 발행
7.6 환불 정책 (요약)
| 항목 | 환불 방식 |
|---|---|
| 플랜 결제 | 일할 계산 — 사용일수 차감 후 잔여분 환불. 결제 당일은 1일 사용 처리. 시작일 전이면 전액 환불 — 1:1 문의 |
| 사용량 충전 | 1%라도 사용한 경우 환불 불가. 미사용분은 1:1 문의 |
| SMS 충전 | 1%라도 사용한 경우 환불 불가. 미사용분은 1:1 문의 |
| 컨시어지(서비스 요청) | 업체가 고객에게 직접 환불 처리합니다 (요청 관리 메뉴에서 환불 상태 변경). 부킹(예약)과 동일 패턴. |
| 부킹(예약) | 업체에서 설정한 환불 정책에 따라 처리 (구현 예정) |
환불 신청은 좌측 메뉴 → 고객센터 → 1:1 문의 메뉴에서 결제 건과 사유를 함께 제출.
직원 / 권한
운영팀 멤버 계정을 추가하고 메뉴별 접근 권한을 부여합니다.
메뉴 위치
- 좌측 사이드바 → 계정 → 직원 관리 (
/property/staff)
본 챕터 캡처 이미지
| 파일명 | 캡처 대상 |
|---|---|
08-01-staff-list.png | 직원 목록 |
08-02-staff-add.png | 직원 추가 모달 (권한 그룹 6종 체크박스) |
08-03-staff-edit.png | 직원 수정 모달 (비밀번호 재설정도 여기서) |
8.1 직원 추가
추가 흐름
- 추가 버튼 → 모달
- 이름, 아이디(영문/숫자/밑줄), 비밀번호 입력
- 권한 그룹 체크박스로 선택 (다음 절 참조)
- 저장 → 즉시 로그인 가능
8.2 권한 그룹 (6종)
| 라벨 | 접근 가능 영역 |
|---|---|
| 챗봇 설정 | 챗봇 관리 그룹 (챗봇 설정·AI 응답 관리·동의어·QR/링크) |
| 컨시어지 | 컨시어지 그룹 (서비스 설정·요청 관리·매출내역·매출분석) |
| 예약 관리 | 예약 메뉴 — 숙박업 업종에만 노출 |
| 외부 연동 | 외부 연동 그룹 (연동 설정·연동 로그) |
| 채팅 | 분석 그룹 (고객 인사이트·채팅 내역·만족도 평가) |
| 직원 관리 | 계정 → 직원 관리 |
자주 발생하는 상황
- 업체 관리자(오너)가 직원 관리 메뉴에서 직원 행을 클릭 → 수정 모달에서 새 비밀번호 입력해 저장하면 됩니다.
- 비밀번호 찾기(이메일 발송) 기능은 업체 관리자(오너) 계정에만 제공됩니다 — 직원 계정은 오너 경유 필요.
자주 묻는 질문
운영 중 가장 자주 받는 질문 모음입니다.
FAQ 모음
- 임베드 스크립트가
</body>직전에 정확히 들어갔는지 확인 (§2.3) - 브라우저 강력 새로고침 (Ctrl+Shift+R)
- 광고 차단 확장 프로그램 영향 가능 — 시크릿 창에서 테스트
- 사용량 한도 도달 시 응답 일시 중단 가능성 — 대시보드 사용률 확인
- 시스템 프롬프트가 매우 길면 처리 시간 증가 — 추가 안내 규칙 분량 검토
- AI 응답 톤이 창의적(1.2)으로 설정되어 있을 가능성 — 정확함(0.3) 권장 (§2.1.1)
- FAQ에 등록되지 않은 질문은 매번 AI가 새로 생성하므로 표현이 달라질 수 있음 → FAQ 등록 권장
- 새로운 질문 패턴 유입 가능성 — 미해결 질문 확인 (§3.2)
- 응답률은 롤링 7일/30일 집계라 단기 변동이 크게 보일 수 있음
- 연동 로그 메뉴에서 호출 시도 여부 우선 확인 (§6.5)
- Slack은 연결 테스트 재실행 — Sheets/Monday/Webhook은 자체 채널 직접 확인
- 컨시어지·부킹 별도 토글 — 양쪽 모두 켜져 있는지 확인
- AI 답변 자체는 고객 입력 언어에 자동 대응합니다 (한국어/영어/일본어/중국어 등)
- 단 UI/키워드 응답/컨시어지 키워드 매칭은 챗봇 설정에서 등록한 언어에서만 동작. 미설정 언어 시스템 안내는 영어로
- 관리자/대시보드 화면 자체의 풀 다국어 인터페이스는 단계적으로 확장 예정 (구현 예정)
- 네, 환불을 지원합니다. 모든 환불은 1:1 문의로 신청합니다 — §7.6 참조
- 영수증: 계정 → 결제 내역 → "영수증" 버튼 (토스 PG 영수증)
- 세금계산서: 고객센터 → 1:1 문의로 사업자 정보와 함께 신청 → 수기 발행
- 업체 관리자(오너)가 직원 관리 메뉴에서 수정 모달로 재설정 가능 (§8.2)
- 모든 통신 HTTPS 암호화, 비밀번호 bcrypt 해싱 저장. 자체 호스팅 인프라 보관
트러블슈팅
장애·문제 상황별 빠른 진단표.
10.1 위젯이 안 보임
| 증상 | 진단 | 처리 |
|---|---|---|
| 홈페이지에 위젯 아이콘 없음 | 임베드 스크립트 미설치 | §2.3 코드 발급·설치 |
| 콘솔 에러 메시지 노출 | 스크립트 차단 | 광고 차단 확장 프로그램·CORS 설정 확인 |
10.2 응답이 안 옴 / 느림
| 증상 | 처리 |
|---|---|
| 응답 시간 길어짐 | OpenAI 부하 또는 토큰 한도 도달 — 대시보드 사용률 확인 |
| "토큰 한도 도달" 메시지 노출 | AI 사용량 카드의 충전하기 버튼 또는 플랜 업그레이드 |
| 일부 사용자에게만 응답 안 옴 | 채팅 Rate Limit (도배 방지) — 의도된 동작 |
10.3 사용량이 갑자기 빠르게 올라가요
| 가능 원인 | 확인 방법 |
|---|---|
| 신규 트래픽 유입 | 대시보드 차트에서 시점별 추이 |
| 같은 사용자 도배 | 분석 → 채팅 내역에서 기간별 |
| RAG 청크 매우 큰 PDF | 챗봇 설정 → 기본 설정 → 매뉴얼 관리 (RAG 업종 한정) |
| 긴 시스템 프롬프트 | 챗봇 설정 → 추가 안내 규칙 분량 검토 |
10.4 외부 연동 알림 누락
| 증상 | 처리 |
|---|---|
| 일부 채널만 알림 안 옴 | 연동 로그에서 호출 시도 확인 + Slack은 연결 테스트 재실행 |
| 컨시어지는 오는데 부킹 안 옴 | 컨시어지·부킹 별도 토글 — 양쪽 켜져 있는지 |
| 알림에 누락 정보 | 페이로드 명세는 외부 연동 페이지의 연동 가이드 링크 |
10.5 결제 실패
| 증상 | 처리 |
|---|---|
| 결제창 카드 거절 | 카드사 한도·해외 결제 차단 확인 |
| 결제는 됐는데 플랜 적용 안 됨 | 결제 결과는 토스 콜백으로 즉시 반영됩니다. 새로고침 후에도 계정 → 결제 내역에서 상태가 정상이 아니면 고객센터 → 1:1 문의 |
| 환불 신청 처리 안 됨 | 결제 내역 → 환불 상태 확인, 7일 이상 지연 시 1:1 문의 |
10.6 그 외 문제
위 항목에 해당하지 않는 OA Chatbot 시스템 관련 문제(결제·플랜·기능 장애 등)는 좌측 메뉴 → 고객센터 → 1:1 문의로 접수해 주세요. 영업일 기준 1일 이내 답변.
1분 가이드
자주 마주치는 상황별 빠른 처리 — 운영 중 자주 마주치는 3가지 상황에서 어떤 학습 도구를 어디에 등록할지 빠르게 결정.
학습 도구 3종 — 빠른 결정 표
| 도구 | 매칭 방식 | 이런 질문에 |
|---|---|---|
| FAQ | 의미 기반 — 다양한 표현 자동 매칭 | 정확한 1문1답 가능 |
| 키워드 응답 | 부분 문자열 매칭(대소문자 무시) | 단어 트리거로 같은 답 |
| 추가 안내 규칙 | 매칭 X — 모든 답변에 항상 컨텍스트 주입 | 정책·톤·금지·자사 채널 안내 |
결정 트리
시나리오 1. AI가 답변 못한 질문 발견
상황: 분석 → 고객 인사이트 응답률 카드가 낮거나, AI 응답 관리 → 미해결 질문 탭에 새 항목 누적.
1-A. FAQ로 등록 (정확한 1문1답)
- 실제 미응답 사례:
"객단가는 부가세 포함인가요?" - 판단: 답이 짧고 명확함 (yes/no + 한 줄) → FAQ가 정답
- 등록 흐름:
- AI 응답 관리 → 미해결 질문 탭 → 해당 항목 클릭
- 학습 등록 모달 → FAQ 선택
- 답변 작성: "객단가는 부가세 별도이며, 결제 시 부가세가 추가됩니다."
- 저장 → 즉시 챗봇 응답에 반영
- 효과: 같은 질문이 다양한 표현으로 들어와도 의미 기반 매칭으로 동일 답변 출력
1-B. 키워드 응답으로 등록 (단어 트리거)
- 실제 미응답 사례:
"헬스장은 어딨나요","사우나는 어딨어요" - 판단: 다양한 부대시설 단어로 위치 질문 — 단어 매칭만으로 일관 답변 가능 → 키워드 응답이 정답
- 등록 흐름:
- 챗봇 관리 → 챗봇 설정 → 키워드 응답 → 신규 등록
- 메인 키워드: "부대시설"
- 추가 키워드: "헬스장", "사우나", "수영장", "시설", "어디" (각각 칩으로 추가)
- 답변: "부대시설은 지하 1층 또는 안내 데스크에서 확인하실 수 있습니다. 자세한 위치는 자사 응대 채널로 문의해 주세요."
- 효과: 단어 변형(헬스장/헬스/사우나)에도 동일 답변 자동 트리거 (부분 문자열 매칭)
1-C. 추가 안내 규칙으로 등록 (공통 정책)
- 실제 미응답 사례:
"후불결제로 하면 안될까요"+"더 자세하게 설명해줘" - 판단: 결제 정책·답변 형식 같이 모든 채팅에서 일관 적용해야 하는 룰 → 추가 안내 규칙
- 등록 흐름: 챗봇 관리 → 챗봇 설정 → 추가 안내 규칙 → 텍스트 추가:
## 결제 정책 - 결제는 선결제만 가능하며, 후불결제는 지원하지 않습니다. ## 답변 형식 - 자세한 안내가 필요한 경우 자사 응대 채널(전화·카카오톡·매장 방문 등)로 안내합니다.
- 효과: FAQ에 없는 새 질문이 들어와도 정책 위반 답변 자동 차단
시나리오 2. AI 응답률이 낮음
상황: 고객 인사이트 응답률 카드가 낮거나, 미해결 질문이 누적되는 시점.
2-A. 같은 단어 반복 미응답 → 키워드 응답으로 일괄 해결
- 실제 미응답 패턴:
"방충망","환풍기","선풍기"(같은 날 연속) - 발견: AI 응답 관리 → 미해결 질문 탭에서 같은 단어 반복 클러스터
- 판단: 시설/비품 단어 트리거 → 키워드 응답
- 등록:
- 메인 키워드: "객실 비품"
- 추가 키워드: "방충망", "환풍기", "선풍기", "가전", "비품"
- 답변: "객실 비품 안내는 인포메이션 또는 자사 응대 채널로 별도 요청해 주세요."
2-B. 비슷한 의도 다양한 표현 → FAQ로 의미 매칭
- 실제 미응답 패턴:
"조식 설정","조식 설정하는 법","조식 추가","조식 설정 어떻게 해"(같은 주에 4번) - 발견: 미해결 질문 메뉴에서 같은 의도 4번 누적
- 판단: 표현은 다르지만 의도 동일 → FAQ는 의미 기반 매칭이라 모두 잡음
- 등록: FAQ 질문 "조식을 어떻게 설정하나요?" → 단계별 절차 입력
- 효과: 위 4개 변형 모두 자동 매칭
2-C. 답변할 수 없는 영역 반복 → 추가 안내 규칙으로 가드
- 실제 미응답 사례:
"가져다 주세요","와인말고 병이여"— 채팅에서 직접 주문 처리 요청 - 판단: 채팅 직접 주문은 정책상 불가 → 추가 안내 규칙
- 등록:
## 주문/요청 처리 규칙 - 채팅에서 직접 주문을 받지 않으며, 부가서비스 메뉴 또는 자사 응대 채널로 안내합니다.
시나리오 3. 고객이 불만 / 감정 표현
상황: AI 응답 관리 → 품질 플래그 탭에서 불만족 라벨이 부착된 대화 발견.
3-A. 답변이 헛돌 때 → 추가 안내 규칙에 "에스컬레이션 룰"
- 실제 사례:
"아니 말이 안통하네"(고객 2~3회 시도 후 불만 표출) - 판단: 같은 답변 반복 → 사용자가 이해 못함 신호 → 추가 안내 규칙 자동 에스컬레이션
- 등록:
## 에스컬레이션 - 같은 질문에 답변이 명확히 닿지 않으면 추가 설명 시도 후 자사 응대 채널로 안내합니다. - "말이 안통한다", "이해 안 된다" 같은 표현 감지 시 즉시 자사 응대 채널 안내.
3-B. 욕설·공격적 표현 → 추가 안내 규칙에 "응대 톤"
- 실제 사례:
"시* 미*놈아","똑바로 알려줘 ㅅ*!"(욕설 동반 불만) - 판단: AI가 욕설에 휘말리지 않고 차분히 응대 → 추가 안내 규칙 응대 톤 고정
- 등록:
## 비속어/공격적 표현 응대 - 욕설이나 공격적 표현이 들어와도 동요하지 않고 정중한 톤 유지. - 동일한 응대 반복하지 말고, 핵심 답변 + 자사 응대 채널 안내로 마무리.
3-C. 같은 정보 반복 요청 → FAQ 등록 또는 답변 보강
- 실제 사례:
"다리미 있나요","고데기 있나여"(어메니티 안내 부족) - 판단: 어메니티 정보 부족 패턴 → FAQ 등록
- 등록: FAQ 질문 "객실 어메니티는 무엇이 있나요?" → 항목 + 미비치 시 요청 방법
마무리 — 운영 루틴 추천
| 주기 | 작업 |
|---|---|
| 매일 | 대시보드에서 사용률·미처리 요청 확인 |
| 매주 | AI 응답 관리 → 미해결 질문 + 품질 플래그 탭 점검 + 학습 등록 |
| 매주 | AI 인사이트 자동 분석 결과 확인 (B등급 이상 유지 권장) |
| 필요 시 | AI 자동 작업 버튼 수동 트리거 — 미해결 패턴 누적 시 일괄 분석·후보 검수 |
| 월 1회 | 분석 → 고객 인사이트 추이로 응답률·만족도 트렌드 |
| 분기 1회 | 추가 안내 규칙 전체 점검 + 갱신 |
이 루틴만 지키셔도 챗봇 응답 품질은 점점 안정되고, 운영 부담은 점점 줄어듭니다.