먼저 말 걸기란
먼저 말 걸기는 방문자의 행동을 감지해 에이전트가 대화를 시작하는 기능입니다. 방문자가 채팅 버튼을 누를 때까지 기다리지 않고, 매장 직원이 손님을 맞이하듯 정해진 상황에서 말을 겁니다.
말을 거는 경우는 두 종류입니다. 방문 자체에 반응하는 인사와, 커서 움직임에 반응하는 말입니다. 아무 때나 팝업이 뜨는 방식이 아니라 상황과 횟수가 모두 정해져 있습니다.
인사 네 가지
인사는 세 채널 모두에서 나가고 모바일에서도 표시됩니다.
| 인사 | 발동 조건 | 문구 예 |
|---|---|---|
| 첫 인사 | 페이지 진입 후 3~7초 | 👋 안녕하세요! |
| 재방문 인사 | 방문 이력이 있고 마지막 방문에서 하루 이상 경과 | 🙌 어서 오세요, 또 뵙네요! |
| 마지막 인사 | 데스크톱에서 커서가 화면 위쪽 바깥으로 이탈 | 🥺 벌써 가세요? |
| 여정 마무리 | 모바일에서 페이지 하단까지 스크롤 후 정지 | 🙌 여기까지 보셨네요! |
첫 인사가 나가기 전에 방문자가 크게 스크롤하거나 클릭하면 인사는 취소됩니다. 이미 행동을 시작한 방문자에게 뒤늦게 인사하는 것은 방해가 되기 때문입니다.

커서에 반응하는 말
데스크톱에서만 동작합니다. 커서가 어떤 요소 위에 얼마나 머무는지를 보고 상황에 맞는 문구를 고릅니다.
| 상황 | 발동 조건 | 문구 예 |
|---|---|---|
| 이미지 응시 | 이미지·영상 위 1.5초 | 이거 마음에 드세요? 더 자세히 보여드릴까요? |
| 이미지 장시간 응시 | 같은 위치 3초 이상 | 오래 보고 계시네요! 결정에 도움 될 만한 걸 알려드릴까요? |
| 닫기 버튼 망설임 | 닫기 버튼 위 진입 | 벌써 가시려고요? 찾으시던 게 따로 있었나요? |
| 버튼 위 | 버튼·링크 위 1.2초 | 좋은 선택이에요! 천천히 진행하셔도 괜찮아요 :) |
| 추정 버튼 위 | 버튼으로 추정되는 요소 위 | 더 알아보고 싶으세요? 제가 정리해 드릴게요. |
| 입력란 정체 | 입력란 위 5초 이상 | 입력하다 막히셨어요? 제가 도와드릴게요! |
| 큰 제목 위 | 제목 위 1.5초 | 이 부분 궁금하셨어요? 더 설명해 드릴까요? |
한 번 말을 건 요소에는 다시 걸지 않고, 다음 발화까지 20초를 쉽니다. 커서가 지나가기만 한 경우는 세지 않고, 같은 자리에 잠시 멈춘 뒤부터 시간을 측정합니다.
과도한 노출을 막는 규칙
발화 횟수에는 상한이 있습니다. 상한을 넘기면 방문자는 도움이 아니라 방해로 받아들이기 때문입니다.
| 규칙 | 내용 |
|---|---|
| 한 방문 1회 | 페이지를 이동해도 같은 방문 안에서는 인사를 반복하지 않습니다 |
| 24시간 3회 | 같은 방문자에게 인사는 하루 최대 3회입니다. 마지막 인사는 이 횟수에 포함되지 않습니다 |
| 30분 경과는 새 방문 | 탭을 열어 둔 채 30분 이상 자리를 비웠다 돌아오면 새 방문으로 봅니다. 이전 대화는 "이전 대화 N개 보기"로 접히고 인사가 다시 나갑니다 |
| 무반응 3회 | 인사를 세 번 연속 무시하면 24시간 동안 발화를 멈춥니다. 방문자가 캐릭터를 누르거나 말을 걸면 횟수가 초기화됩니다 |
| 답변 중 정지 | 답변을 생성 중이거나 답변 직후에는 먼저 말을 걸지 않습니다 |
| 문구 반복 회피 | 30분 안에는 같은 문구를 다시 쓰지 않습니다 |
문구는 위젯 안에 있습니다
먼저 거는 말은 위젯에 내장된 문구 목록에서 고릅니다. 서버에 묻지 않으므로 지연이 없고 토큰도 소모하지 않습니다. 문구는 한국어와 영어 두 가지이고, 그 밖의 언어 방문자에게는 영어가 표시됩니다.
방문자가 그 말에 답하면 그때부터 페르소나가 등록된 지식으로 답변합니다. 토큰은 이 대화부터 차감됩니다.
위젯 설정에서 끈 기능에 묶인 반응은 발화하지 않습니다. 인사 네 가지는 설정과 무관하게 항상 나갑니다. 커서 반응 전체를 끄려면 설치할 때 hoverDetection을 끕니다.
상품 길게 누르기
직접 설치한 위젯에서 productPress를 켜면 방문자가 상품을 길게 누르거나 커서를 오래 올려 두었을 때 에이전트가 그 상품을 화제로 말을 겁니다. 기본값은 꺼짐입니다.
| 조작 | 기준 시간 |
|---|---|
| 터치 길게 누르기 | 0.55초 |
| 마우스 오래 올려두기 | 0.9초 |
조건이 맞으면 "{상품명}에 관심 있으신가요? 😊"가 표시되고 그 상품에 대한 질문을 바로 이어갈 수 있습니다. 같은 상품에는 6초 안에 다시 반응하지 않고, 답변 생성 중에도 반응하지 않습니다.

다음 단계
- 상품으로 인식되는 요소의 조건은 설치 전 사이트 준비를 참고하세요.
- 기능을 켜고 끄는 방법은 위젯 설정과 SDK 레퍼런스를 참고하세요.
- 인사가 반복될 때는 인사 반복을 참고하세요.