웹사이트 임베드

한 줄의 script로 웹사이트에 채팅 창을 추가하고, 페이지에서 호출할 수 있는 메서드와 언어 규칙을 안내합니다.

아래의 {API}는 서비스 주소를 의미하며, 관리자 페이지의 '연결' 페이지에서 확인할 수 있습니다.

<script src="{API}/static/aics-widget.js" data-key="pk_xxx" data-api="{API}" async></script>

data-key는 공개 Key이며, 관리자 페이지의 '연결' 페이지에서 복사할 수 있습니다.
'연결' 페이지에서 임베드를 허용할 웹사이트(예: https://shop.example.com)를 등록하세요. 다른 웹사이트는 공개 Key를 가지고 있어도 사용할 수 없습니다. 출시 전에 반드시 입력하세요.
선택 사항: data-theme="dark"를 사용하면 다크 스타일이 적용됩니다.
선택 사항: data-language="de" — 웹사이트 자체가 다국어인 경우 현재 페이지의 언어를 전달하면 상담이 기본적으로 이 언어를 사용합니다(방문자는 여전히 변경할 수 있습니다). 지원되는 언어 코드는 오픈 API 개요를 참고하세요.
선택 사항: data-language="auto" — 페이지의 <html lang>을 기본 언어로 사용하며, 이후 페이지 언어가 바뀌면(단일 페이지 앱에서 새로고침 없이 lang 속성을 변경해도) 상담 창도 자동으로 따라 바뀝니다.

페이지에서 다음과 같이 호출할 수 있습니다:

메서드	기능
`AICS.open()` / `AICS.close()` / `AICS.toggle()`	상담 창을 열고, 닫고, 전환합니다. 예를 들어 '상담 문의' 버튼에 연결할 수 있습니다
`AICS.identify(userToken)`	고객이 로그인한 후 상담에 누구인지 알려줍니다(로그인한 고객 식별 참고)
`AICS.setLanguage(code)`	웹사이트 언어가 바뀔 때 호출하면 상담 창과 이후의 답변이 함께 바뀝니다. 예: `AICS.setLanguage("ja")`. `zh-Hans`, `pt-BR` 같은 표기도 허용됩니다
`AICS.reset()`	고객이 로그아웃할 때 호출합니다. 상담 창을 제거하고 현재 세션을 버립니다. 스크립트를 다시 로드하면 익명의 새 창이 되며, 다음 사람은 이전 사람의 대화를 볼 수 없습니다

언어

상담 창은 방문자의 위치(IP)에 따라 해당 언어로 표시됩니다. 인터페이스 문구와 환영 메시지를 포함합니다. data-language가 설정된 경우 페이지 언어를 우선합니다. 위치를 판단할 수 없으면 관리자 페이지에 설정된 '기본 언어'를 사용합니다.
AI는 고객이 사용하는 언어를 따라 답변합니다. 고객이 보낸 내용에서 언어를 알 수 없을 때(이모지, 주문 번호)는 위에서 판단한 언어를 사용합니다.
고객은 창 상단의 언어 메뉴에서 변경할 수 있고, AI에게 "영어로 답변해 주세요"라고 직접 말할 수도 있습니다. 이후 AI는 고객이 다른 언어로 작성하더라도 계속 이 언어를 사용합니다.
웹사이트 언어 전환(AICS.setLanguage 또는 data-language="auto"일 때 <html lang> 변경)도 고객의 선택으로 간주되며, 위 방법들과 마지막으로 선택한 것이 우선합니다. 다만 페이지를 열 때의 기본 언어는 고객이 선택한 언어를 덮어쓰지 않습니다.
관리자 페이지의 '봇 설정 → 언어'에서 IP 기반 판단을 끄고, 기본 언어를 변경하고, 개방할 언어를 제한할 수 있습니다.
리버스 프록시나 CDN 뒤에 배포하는 경우 서버 측에서 TRUSTED_PROXIES 또는 COUNTRY_HEADER를 설정해야 하며, 그렇지 않으면 방문자의 실제 IP를 가져올 수 없습니다.

이 페이지가 도움이 되었나요?

마지막 업데이트: 2026년 10월 31일