임베디드 채팅

플로팅 버블 대신 페이지 내에 채팅 위젯을 인라인으로 표시하세요

임베드 코드 받기
모든 플랜

개요

기본적으로 Asyntai 채팅 위젯은 웹사이트 모서리에 플로팅 버블로 나타납니다. 임베디드 채팅을 사용하면 페이지에 직접 채팅을 표시할 수도 있습니다 — 예를 들어 홈페이지의 "문의하기" 섹션에 표시할 수 있습니다.

플로팅 버블은 임베디드 채팅과 함께 계속 작동합니다. 임베디드 섹션까지 스크롤하지 않은 방문자도 버블을 사용할 수 있습니다. 둘 다 같은 대화를 공유합니다.

작동 방식

1
스크립트 태그 하나 추가 HTML에서 채팅을 표시하고 싶은 위치에 배치합니다
2
채팅이 인라인으로 렌더링됩니다 위젯이 해당 위치에 항상 표시되며 일반 채팅과 동일한 크기입니다
3
버블이 계속 활성화됩니다 임베디드 채팅을 보지 못한 방문자를 위해 플로팅 버블이 모서리에 유지됩니다
4
공유 대화 임베디드 채팅과 플로팅 위젯 간에 실시간으로 메시지가 동기화됩니다

설정

페이지에서 채팅을 표시하고 싶은 위치에 이 한 줄의 HTML을 추가합니다:

<script src="https://asyntai.com/static/js/chat-embed.js" data-asyntai-id="YOUR_WIDGET_ID"></script>

YOUR_WIDGET_ID를 위젯 ID로 교체하세요. 임베디드 채팅 설정 페이지에서 ID가 미리 입력된 임베드 코드를 찾을 수 있습니다.

참고: 메인 chat-widget.js 스크립트도 페이지에 있어야 합니다. 이미 사이트에 Asyntai 위젯을 설치했다면 이미 처리된 상태입니다.

예시

홈페이지에서 사용하는 방법의 예시입니다:

<section style="max-width: 500px; margin: 0 auto;">
    <h2>Chat with us</h2>
    <p>Ask us anything — our AI assistant is here to help.</p>

    <!-- The chat will appear right here -->
    <script src="https://asyntai.com/static/js/chat-embed.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
</section>

세부 사항

크기

임베디드 채팅은 플로팅 위젯과 동일한 크기로 렌더링됩니다: 데스크톱에서 너비 400px, 높이 650px, 모바일에서 전체 너비, 높이 550px입니다. 부모 컨테이너의 스타일을 지정하여 위치를 제어할 수 있습니다.

플로팅 버블 동작

임베디드 채팅이 화면에 표시되어 있을 때 방문자가 플로팅 버블을 클릭하면 임베디드 채팅으로 스크롤됩니다. 임베디드 채팅이 보이지 않으면 버블이 일반 플로팅 채팅 오버레이를 엽니다.

메시지 동기화

임베디드 채팅과 플로팅 채팅 모두 같은 대화를 공유합니다. 어느 쪽에서 보낸 메시지든 양쪽 모두에 표시됩니다. 동일한 세션, AI 컨텍스트 및 채팅 기록이 사용됩니다.

여러 페이지

일부 페이지에서는 임베디드 채팅을, 다른 페이지에서는 일반 플로팅 위젯을 사용할 수 있습니다. 인라인 채팅을 원하는 페이지에 임베드 스크립트를 포함하기만 하면 됩니다. 대화는 평소와 같이 페이지 간에 이어집니다.

라이브 미리보기

라이브 임베디드 채팅으로 어떻게 보이는지 확인할 수 있습니다:

요구 사항

메인 Asyntai 채팅 위젯(chat-widget.js)이 페이지에 설치되어 있어야 합니다
모든 플랜에서 작동 — 업그레이드 불필요
Shadow DOM을 지원하는 모든 브라우저와 호환됩니다 (모든 최신 브라우저)

팁: 먼저 스테이징 페이지에 임베디드 채팅을 배치하여 테스트하세요. 프로덕션에 배포하기 전에 페이지 레이아웃 내에서 올바르게 보이는지 확인하세요.