대화 화면이란
대화 화면은 방문자가 사이트에서 마주하는 위젯의 표면입니다. 채팅창이 처음부터 펼쳐져 있는 형태가 아닙니다. 화면 구석의 캐릭터 하나로 시작해, 에이전트가 말을 걸거나 방문자가 캐릭터를 누를 때 대화가 열립니다.
이 문서는 방문자에게 보이는 요소만 다룹니다. 요소를 켜고 끄는 방법은 위젯 설정에서 다룹니다.
캐릭터와 말풍선
캐릭터는 화면 가장자리에 항상 떠 있습니다. 드래그하면 위치가 옮겨지고 클릭하면 대화가 열립니다. 캐릭터에는 "드래그로 위치 이동 · 클릭으로 대화" 안내가 붙습니다.
말풍선은 캐릭터 위에 표시됩니다. 에이전트가 먼저 말을 걸 때, 그리고 방문자가 대화 패널을 열지 않고 짧게 주고받을 때 이 말풍선을 씁니다. 읽지 않은 답변이 남아 있으면 캐릭터에 안읽음 배지가 붙습니다.
대화 패널
캐릭터를 누르면 전체 대화 패널이 열립니다. 말풍선에서 짧게 대화하다가 "전체 대화 보기"를 누르면 같은 대화가 패널로 이어집니다. 긴 답변과 표는 패널에서 스크롤로 읽습니다.
패널을 열기 전까지 답변은 말풍선에서 짧은 조각으로 나뉘어 표시됩니다. 조각이 둘 이상이면 "다음 내용"으로 넘기고, 진행 상태가 막대와 숫자로 표시됩니다.

답변 생성 중 표시
방문자가 질문을 보내면 답변이 완성되기 전까지 진행 단계를 한 줄로 표시합니다. 응답이 늦어질 때 방문자가 기다릴지 판단할 수 있게 하기 위해서입니다.
| 문구 | 표시되는 때 |
|---|---|
| 질문을 듣고 있어요 | 질문을 보낸 직후 |
| 생각하고 있어요 | 첫 글자가 늦어질 때 |
| 자료를 확인하고 있어요 | 등록된 지식을 찾을 때 |
| 상품을 찾고 있어요 | 상품 정보를 찾을 때 |
| 장바구니를 확인하고 있어요 | 장바구니를 확인할 때 |
| 답변을 정리하고 있어요 | 마무리 단계 |
답변이 완성되면 글자가 한 번에 정리되어 목록과 표가 제자리를 찾습니다.

답변 끝에 붙는 요소
답변 본문이 끝나면 그 아래에 상품 카드, 링크 버튼, 후속 질문이 순서대로 붙습니다. 셋 다 답변이 완성된 뒤에만 나타납니다.
| 요소 | 나타나는 조건 | 한도 |
|---|---|---|
| 상품 카드 | 답변의 목록 항목에 굵은 제목이나 가격이 있고, 그 항목이 자사 사이트 링크를 가질 때 | 3개. 초과 항목은 본문에 글로 남음 |
| 링크 버튼 | 직접 설치한 위젯에서 답변에 자사 페이지 링크가 한 줄로 들어 있을 때 | 2개 |
| 후속 질문 | 직접 설치한 위젯에서 답변이 완결되고 다음 질문 후보가 있을 때 | 3개, 각 18자 이내 |
카페24 쇼핑몰에서는 서버가 내려준 상품 정보로도 카드가 만들어져 썸네일이 함께 표시됩니다. 직접 설치한 위젯에서 카드를 누르면 새 탭으로 열리고, 쇼핑몰 채널에서는 같은 탭에서 상품 페이지로 이동합니다.
후속 질문은 입력창 안에 번호 붙은 목록으로 놓입니다. 방문자가 하나를 누르면 그 문구가 바로 전송됩니다. 답변이 진행 중이면 목록이 흐려진 채 남아 있다가 다음 답변이 시작되면 새 목록으로 바뀝니다.
예시:
방문자: 겨울 코트 추천해줘
에이전트: 지금 판매 중인 코트 세 가지를 안내합니다. (답변 본문)
답변 아래에 상품 카드 3개, 입력창 안에 "1. 다른 상품 보기 / 2. 배송 문의 / 3. 상담 종료"

상태 안내
답변 대신 상태를 알려야 할 때는 말풍선이 아니라 색 점이 붙은 안내 줄이 표시됩니다. 네 가지를 같은 오류 문구로 묶으면 방문자가 기다리면 되는지, 다시 보내면 되는지 알 수 없기 때문입니다.
| 상황 | 방문자가 보는 것 | 입력창 |
|---|---|---|
| 이용 한도 소진 | 호박색 안내와 "이용 한도를 모두 사용했어요." 이미 받은 답변은 유지 | 잠김 |
| 연결 만료 | "세션이 만료되어 다시 연결하고 있어요. 잠시 후 다시 시도해 주세요." | 사용 가능 |
| 답변 거절 | "죄송해요, 그건 제가 대답할 수 없는 질문이에요." | 사용 가능 |
| 일시 오류 | "일시적인 오류가 발생했어요. 잠시 후 다시 시도해 주세요." | 사용 가능 |
인터넷 연결이 끊기면 화면 아래에 "인터넷 연결이 끊어졌습니다."가 별도로 표시됩니다.
한도 소진 안내가 뜬 뒤에는 새 방문자도 대화를 시작하지 못합니다. 언제 풀리는지는 토큰과 사용량에서 다룹니다.