웹사이트에 챗봇 버튼을 달고 설정하는 방법

FrontierBase Console에서 챗봇을 쓰려면 채널 설정 → 채널 관리에서 채널 정보와 위젯 설정을 먼저 맞춰 둔다.

이름과 언어를 정하고, 프로필을 설정한 다음 설치 코드를 사이트에 넣는다. 표시 방식과 허용 도메인을 확인한 뒤, 필요하면 알림과 이슈 트랙을 켠다. 학습 데이터와 답변 설정은 별도 메뉴에 있다. 위젯이 표시되지 않으면 설치 코드와 허용 도메인을, 답변이 나오지 않으면 채널 상태와 학습 데이터를 확인한다.

FrontierBase Console에 로그인한 뒤 사이드바에서 채널 설정 → 채널 관리를 연다.

탭 오른쪽 가이드를 누르면 같은 화면의 단계별 안내를 바로 따라갈 수 있다.

1. 채널 상세

채널의 기본 정보를 확인하고 수정하는 탭이다. 채널명은 콘솔에 표시되는 이름이고, 채널 언어는 챗봇의 기본 응답 언어다. 플레이그라운드 URL은 채널 식별자로 결정된다.

채널명과 식별자

채널명은 콘솔에 보이는 이름이다. 팀원이 구분하기 쉬운 이름을 쓰면 된다. 예: 구글 랩스, 고객지원 챗봇.

채널 식별자는 코드나 URL에서 채널을 가리킬 때 쓰는 값이다. 보통 만들 때 정해지며 이 화면에서는 수정할 수 없다. 식별자 아래에는 플레이그라운드 주소 미리 보기가 보인다. 배포 전에 이 주소로 챗봇을 열어 보면 된다.

값을 바꾼 뒤에는 아래쪽 저장을 눌러야 반영된다.

국가/지역과 채널 언어

국가/지역과 채널 언어는 한 줄에 나란히 있다. 채널 언어는 이 채널의 기본 응답 언어다. 사이트 방문자가 쓰는 언어와 맞추는 것이 좋다. 나중에 바꿀 수 있지만, 이미 쌓인 학습 데이터와 답변 톤에 어긋나지 않는지 확인한다.

플랜과 상태

플랜은 구독에 따라 표시되며 이 탭에서 직접 바꾸지 않는다.

상태는 데이터셋 준비와 운영 여부에 따라 바뀐다. 라벨 옆 도움말 아이콘에 각 상태 설명이 있다.

• 대기: 데이터셋이 아직 구성되지 않은 상태다. 데이터셋 설정하기로 학습 데이터 화면으로 이동할 수 있다.
• 활성: 정상 운영 중이다. 필요할 때 중지로 일시정지할 수 있다.
• 일시정지: 메시지를 주고받지 않는다. 활성화로 다시 켤 수 있다.
• 삭제됨: 더 이상 사용할 수 없다.

채널이 대기 상태이면 챗봇 버튼은 표시되더라도 질문에 답하지 못하거나 문의 접수 화면만 표시될 수 있다. 위젯을 설치하기 전에 학습 데이터 상태를 확인한다.

청구지 주소와 채널 삭제

같은 탭 아래쪽에서 청구지 주소(사업자명, 사업자 번호, 주소)를 입력할 수 있다. 결제와 세금계산서에 쓰이는 정보이므로 실제 청구 정보와 맞춘다.

맨 아래 채널 삭제는 되돌리기 어렵다. 테스트 채널을 정리할 때만 쓰고, 운영 채널은 삭제 대신 일시정지를 먼저 검토한다.

2. 프로필 관리

고객에게 보이는 브랜드 정보를 설정한다. 로고와 커버, 표시 이름, 채팅 버튼 문구, 안내사항, 대화 시작 메시지를 맞춘 뒤 미리 보기로 확인한다.

로고와 커버

로고는 챗봇 헤더에 보이는 브랜드 이미지다. 커버는 브랜드를 대표하는 큰 이미지다. 둘 다 업로드한 뒤 미리 보기에서 비율과 잘림을 확인한다. 로고 색상이 사이트 헤더와 비슷하면 잘 보이지 않을 수 있으므로 실제 사이트 배경에서도 확인한다.

표시 이름과 채팅 버튼 문구

표시 이름은 위젯 헤더에 나온다. 채널명과 달라도 된다. 채널명은 내부용, 표시 이름은 고객용으로 나누는 경우가 많다.

채팅 버튼 문구는 플로팅 버튼 등에 붙는 짧은 문장이다. 채팅하기, 문의하기처럼 행동이 분명한 말이 알아보기 쉽다.

안내사항과 대화 시작 메시지

안내사항에는 영업시간, 응대 범위, 자주 쓰는 링크를 적어 둔다. 내용이 길면 미리 보기에는 일부만 표시되고 더보기와 접기 기능이 나타난다.

대화 시작 메시지는 채팅을 열었을 때 봇이 먼저 보내는 인사다. 너무 길면 읽기 전에 스크롤이 생기므로, 한두 문장으로 시작하는 편이 낫다.

오른쪽이나 아래의 미리 보기에서 헤더, 시작 메시지, 입력창 배치를 확인한 뒤 저장한다. 미리 보기에만 반영되고 저장을 누르지 않으면 사이트에는 이전 값이 남는다.

채널 상세 프로필 관리 버튼 설치 버튼 설정 허용 도메인 알림 이슈 트랙

고객에게 보여 줄 브랜드 정보를 설정합니다.

로고

커버

커버 이미지

표시 이름

FrontierBase 도우미

채팅 버튼 문구

채팅하기

안내사항

평일 10:00–18:00 응대합니다. 주문 및 배송 문의는 주문번호를 알려 주세요.

대화 시작 메시지

안녕하세요. 무엇을 도와드릴까요?

FrontierBase 도우미

안녕하세요. 무엇을 도와드릴까요?

3. 버튼 설치

사이트에 챗봇을 표시하는 설치 코드를 복사하는 탭이다. 코드를 넣어도 허용 도메인에 해당 사이트가 없으면 위젯이 로드되지 않을 수 있다. 설치와 도메인 등록을 같이 진행한다.

설치 코드 넣기

1. 설치 코드 영역의 코드 복사를 누른다.
2. 챗봇을 보여줄 HTML의 body 안, 가능하면 </body> 바로 앞에 붙여 넣는다.
3. 페이지를 새로고침한 뒤 버튼이 보이는지 확인한다.

설치 코드는 채널마다 다르다. 코드를 임의로 수정하면 위젯이 표시되지 않거나 다른 채널이 연결될 수 있다. 복사한 그대로 넣는 것을 권장한다.

WordPress나 쇼핑몰 빌더처럼 테마 또는 플러그인에 사용자 정의 스크립트 입력란이 있으면 그곳에 넣어도 된다. 캐시 플러그인을 쓰는 사이트는 배포 후 캐시를 비워야 반영되는 경우가 있다.

Google Analytics (선택)

같은 탭에서 Google Analytics 측정 ID(예: G-XXXXXXXXXX)를 넣을 수 있다. 위젯 실행 시 적용된다. 이 항목은 PRO 이상 요금제에서 사용할 수 있다.

학습 데이터와 스크립트 옵션

스크립트에서 dataset_ids를 비워 두면 활성 데이터셋이 하나인 경우 시스템이 해당 데이터셋을 자동으로 선택한다. 여러 개라면 사용할 데이터셋 ID 하나를 지정한다.

<script src="https://cdn.frontierbase.io/widget.js" data-channel="support-bot"></script>

4. 버튼 설정

채팅 위젯이 사이트에 표시되는 방식을 고른다. 모드를 바꾼 뒤에는 저장하고, 플레이그라운드나 실제 페이지에서 한 번 열어 본다.

표시 모드

• 플로팅 모드: 화면 모서리에 채팅 버튼을 표시한다. 대부분의 마케팅 및 고객지원 사이트에 맞다.
• 전체화면 모드: 위젯을 열면 화면 전체를 오버레이로 덮는다. 상담에 집중해야 할 때 쓰기 좋다.
• 에이전트 레이아웃 모드: 측면 패널에 채팅 화면을 열어 본문과 함께 보여 준다. 긴 대화를 보면서 페이지 내용도 확인해야 할 때 유용하다.

오른쪽이나 아래의 예시 이미지로 모드별 모습을 비교할 수 있다.

플레이그라운드

배포 전에 플레이그라운드 URL로 챗봇을 열어 본다. 채널 상세에 표시된 식별자 미리 보기와 같은 형식의 주소다. 사이트에 코드를 넣기 전에 프로필, 시작 메시지, 학습 데이터 반영 여부를 여기서 확인하면 된다.

플로팅 표시 설정

플로팅 모드일 때 플로팅 표시 설정이 열린다. 기기별 표시 여부를 정하고, 버튼을 왼쪽 또는 오른쪽에 배치한 뒤 측면과 하단 여백을 조정할 수 있다.

모바일에서 하단 고정 메뉴나 구매 버튼과 겹치면 하단 여백을 키우거나 정렬을 바꾼다. 태블릿만 끄고 PC와 모바일만 켜 두는 조합도 가능하다.

채널 상세 프로필 관리 버튼 설치 버튼 설정 허용 도메인 알림 이슈 트랙

채팅 위젯이 사이트에 표시되는 방식을 선택합니다.

표시 모드

챗봇이 화면에 노출되는 방식을 선택합니다

플로팅 모드

전체화면 모드

에이전트 레이아웃 모드

플로팅 표시 설정

PC에서 표시

태블릿에서 표시

모바일에서 표시

5. 허용 도메인

등록된 도메인에서만 챗봇 위젯을 실행할 수 있다. 위젯을 설치할 운영, 스테이징, 로컬 미리 보기 환경의 호스트를 모두 등록한다.

도메인 추가

1. 도메인 추가를 누른다.
2. example.com처럼 호스트만 입력한다. 프로토콜(https://)과 경로는 넣지 않는다.
3. 추가 후 목록에 보이는지 확인한다.

보안을 위해 허용 도메인을 최소 한 개는 남겨 두어야 한다. 마지막 하나를 지우려고 하면 안내가 뜬다.

*를 등록하면 모든 도메인이 허용된다. 빠른 테스트에는 편하지만, 운영 환경에서는 실제 도메인만 남기는 편이 안전하다.

www.example.com과 example.com을 둘 다 쓰면 각각 등록해야 할 수 있다. 위젯이 표시되지 않으면 브라우저 주소창의 호스트와 목록이 같은지부터 확인한다.

6. 알림

채널 관련 이메일을 받을지 항목별로 켠다. 모두 켜 두면 메일이 잦아질 수 있으니, 실제로 확인할 항목만 남긴다. 바꾼 뒤에는 저장을 눌러야 적용된다.

결제와 토큰

• 결제 알림: 다음 정기 결제 하루 전에 관리자에게 메일을 보낸다. 카드 만료나 잔액 문제를 미리 확인하기 좋다.
• 토큰 잔량 알림: 남은 토큰이 각각 50%와 10% 미만으로 내려가면 메일을 보낸다. 사용량이 많은 채널은 켜 두는 편이 안전하다.

요약 메일

• 응답 요약: 전날의 채팅 응답 요약을 매일 보낸다. 운영 현황을 메일로 확인할 때 쓴다.
• 미응답 질문: 봇이 답하지 못한 질문을 모아 매일 보낸다. 학습 데이터를 보강할 후보를 고를 때 유용하다.

알림은 채널이나 계정에 등록된 관리자 이메일 주소로 발송된다. 메일이 오지 않으면 스팸함과 등록된 관리자 이메일 주소를 확인한다.

7. 이슈 트랙

챗봇이 학습 데이터만으로 답하기 어려운 질문을 받으면 방문자에게 문의 접수를 안내할 수 있다. 접수한 내용은 콘솔에서 보고, 필요하면 Zendesk나 웹훅으로 넘긴다.

이슈 트랙 켜기

상단 스위치로 이슈 트랙을 켠다. 꺼 두면 문의 접수 안내와 연동 설정이 비활성화된다. 켠 뒤에도 학습 데이터가 충분하면 일반 답변으로 끝나는 경우가 많다. 학습 데이터가 부족하면 문의 안내가 더 자주 표시될 수 있다.

Zendesk

Zendesk로 티켓을 만들려면 스위치를 켠 뒤 서브도메인, Zendesk 이메일, API 토큰을 입력한다. 값이 틀리면 문의는 콘솔에만 남고 티켓이 안 생길 수 있으므로, 저장 후 테스트 문의를 한 건 넣어 본다.

웹훅

문의 알림을 자체 시스템으로 받으려면 웹훅을 켠다. 알림 받을 주소에 HTTPS URL을 넣고, 필요하면 보안 키를 설정한다. 문의가 접수되면 지정한 주소로 알림이 간다. 방화벽이나 인증이 있는 URL이면 FrontierBase에서 접근할 수 있는지 확인한다.

설정을 마치면 저장한다. 이후 콘솔에서 접수된 항목을 확인하고, 반복되는 질문에 답할 수 있도록 관련 내용을 학습 데이터에 추가한다.

설정 순서

1. 채널 상세에서 이름, 언어, 상태를 확인하고, 대기 상태라면 학습 데이터부터 준비한다.
2. 프로필 관리에서 로고, 표시 이름, 시작 메시지를 맞춘 뒤 미리 보기로 확인한다.
3. 버튼 설치로 코드를 넣고, 허용 도메인에 사이트 주소를 등록한다.
4. 버튼 설정에서 표시 모드와 플로팅 여백을 고르고 플레이그라운드로 시험한다.
5. 운영에 맞춰 알림과 이슈 트랙을 켠 뒤 저장한다.

위젯이 표시되지 않으면 사이트가 현재 채널의 허용 도메인에 등록되어 있는지, 설치 코드가 현재 채널에서 발급된 것인지 확인한다. 위젯은 표시되지만 답변이 나오지 않으면 채널 상태와 학습 데이터를 확인한다. 채널 관리 설정을 마쳤다면 FrontierBase Console에서 학습 데이터와 답변 설정을 확인한다.