MIRA-CHATBOT GUIDE

가입부터 홈페이지 설치까지

처음 사용하는 운영자가 실제 챗봇을 게시하는 데 필요한 순서만 모았습니다.

계정과 최초 설정

고객사 계정 만들기
가입 페이지에서 고객사명, 담당자명, 이메일과 비밀번호를 등록합니다.
제품과 원문 준비
제품을 만든 뒤 매뉴얼 PDF·DOCX, 사양표 XLSX, 공식 URL을 원문 관리에서 등록합니다.
질문 생성과 검수
예상 질문을 생성하고 근거와 답변을 확인한 뒤 승인합니다.
챗봇 설정과 게시
이름·아이콘·색상과 답변 안내 문구를 저장하고 게시 버전을 만듭니다.

고객사 계정 만들기 →

원문과 질문 운영

답변의 근거는 생성된 질문이 아니라 현재 활성화된 공식 원문입니다. 선택한 제품에 등록된 모든 활성 자료를 함께 검색하며, 질문 확장은 고객의 다양한 표현을 원문과 연결하는 검색 보조 자료로 사용합니다.

원문 등록→처리 완료→질문 생성→검수·승인

새 매뉴얼은 언제 적용되나요?

원문 관리에 등록한 매뉴얼이 ready가 되면 해당 제품 챗봇이 최신 활성 버전을 답변 근거로 자동 사용합니다. 재수집한 새 버전이 활성화되면 이전 버전은 검색에서 제외됩니다.

이름·아이콘·색상

운영 설정에서 5가지 기본 아이콘을 고르거나 직접 만든 이미지를 등록하고 회사명과 챗봇 이름을 저장합니다. 선택한 아이콘은 제품·챗봇의 실시간 미리보기, 플로팅 버튼, 채팅 헤더와 중앙 환영 화면에 함께 표시됩니다. 제품·챗봇에서는 테마, 크기, 위치, 환영 문구와 채팅창 하단 안내문을 편집합니다. 외부 챗봇은 전화·이메일·웹 문의·홈페이지 이동 버튼 없이 질문과 근거 답변에 집중합니다.

외부 반영 규칙

초안 저장 후 게시해야 설치된 챗봇에 변경 내용이 나타납니다.

외부 홈페이지 설치

챗봇 게시
미게시 초안은 외부 홈페이지에서 열 수 없습니다.
홈페이지 Origin 등록
예: 페이지 주소가 https://www.example.com/product라면 https://www.example.com만 등록합니다.
플로팅 버튼 코드 복사
제품·챗봇의 설치 영역에서 생성된 코드를 복사합니다.
공통 푸터에 한 번 삽입
닫는 body 태그 바로 앞이나 사이트 전체 사용자 지정 HTML 영역에 붙입니다.

코드를 다시 붙여야 하나요?

아니요. 최초 설치 후에는 관리 화면에서 수정하고 다시 게시하면 됩니다.

페이지마다 다른 챗봇을 쓸 수 있나요?

가능합니다. 같은 홈페이지 Origin을 여러 챗봇에 허용 등록한 뒤, 회사 소개·제품 A·제품 B 페이지에 각각 해당 챗봇의 설치 코드를 넣으세요. 단 한 페이지에는 플로팅 버튼 하나를 권장하며, 여러 봇이 필요하면 위치·간격을 다르게 설정하거나 두 번째 봇은 본문 삽입 방식으로 사용하세요.

CSP로 버튼이 차단될 때

설치 코드는 있는데 버튼이 보이지 않는다면 홈페이지의 Content-Security-Policy를 확인합니다. 설치 코드의 서버 주소를 아래 세 지시문에 허용해야 합니다.

script-src  https://chat.mirachat.co.kr
connect-src https://chat.mirachat.co.kr
frame-src   https://chat.mirachat.co.kr
img-src     https://chat.mirachat.co.kr

CSP를 직접 바꿀 수 없다면

현재 iframe 설치 방식은 홈페이지 제작사나 호스팅 관리자의 허용 설정이 필요합니다. 설치 화면과 이 항목을 전달해 요청하세요. Google Tag Manager도 사이트 CSP에 따라 함께 차단될 수 있습니다.

Gemini 사용량과 비용 확인

운영 설정에서 최근 요청 수, 성공·429·오류, 기록 토큰과 추정 비용을 확인합니다. 제품과 챗봇을 선택하면 해당 범위의 사용량만 표시됩니다.