October CMS에 Asyntai AI 챗봇을 추가하는 방법

October CMS 웹사이트를 위한 단계별 가이드

임베드 코드 받기

플랫폼:

1단계: 임베드 코드 가져오기

먼저 Asyntai 대시보드로 이동하여 "임베드 코드" 섹션까지 아래로 스크롤하십시오. 다음과 같은 형태의 고유 임베드 코드를 복사하십시오:

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

참고: 위의 코드는 예시일 뿐입니다. 개인 위젯 ID가 포함된 고유한 임베드 코드를 대시보드에서 복사해야 합니다.

2단계: 레이아웃 템플릿에 추가 (권장)

챗봇을 추가하는 권장 방법은 October CMS 백엔드에서 기본 레이아웃을 편집하는 것입니다:

October CMS 백엔드에 로그인하세요
메인 메뉴에서 CMS > Layouts로 이동하세요
기본 레이아웃을 여세요 (보통 default.htm)
닫는 태그를 찾으세요 </body> 태그와 {% scripts %} 플레이스홀더
Asyntai 임베드 코드를 바로 앞에 추가하세요 {% scripts %} 및 </body>:
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> {% scripts %} </body>
"Save"를 클릭하여 변경 사항을 적용하세요

팁: Placing the script before {% scripts %} and </body> ensures it loads after the page content, which is recommended for chat widgets and won't slow down your page loading.

Alternative Method 1: Using {% put scripts %} Block

October CMS 스크립트 플레이스홀더를 사용하여 페이지나 파셜에서 챗봇을 삽입할 수 있습니다:

CMS 편집기에서 page 또는 partial을 여세요
다음 코드를 사용하여 추가하세요 {% put scripts %} 블록:
{% put scripts %} <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> {% endput %}
대시보드에서 YOUR_WIDGET_ID를 실제 위젯 ID로 교체하세요
"Save"를 클릭하세요

참고: For this method to work, your layout must include the {% scripts %} placeholder in its markup. This is where October CMS renders all injected scripts. Most default layouts already include this tag.

대체 방법 2: Component PHP 사용

프로그래밍 방식을 선호하는 경우 사용자 정의 컴포넌트를 통해 챗봇 스크립트를 추가할 수 있습니다:

October CMS 플러그인에서 component를 만들거나 수정하세요
컴포넌트의 onRun() 메서드에서 addJs() 메서드를 사용하세요:
public function onRun() { $this->addJs('https://asyntai.com/static/js/chat-widget.js', [ 'async' => true, 'data-asyntai-id' => 'YOUR_WIDGET_ID' ]); }
YOUR_WIDGET_ID를 실제 위젯 ID로 교체하세요
챗봇을 표시하려는 페이지에 컴포넌트를 등록하세요

팁: 컴포넌트를 사용하면 챗봇이 언제 어디서 로드되는지 프로그래밍 방식으로 제어할 수 있습니다. onRun() 내부에 조건부 로직을 추가하여 사용자 역할, 페이지 유형 또는 기타 기준에 따라 로딩을 제어할 수 있습니다.

대체 방법 3: 파셜 사용

챗봇 위젯을 위한 재사용 가능한 파셜을 만들 수 있습니다:

October CMS 백엔드에서 CMS > Partials로 이동하세요
"+ Add"를 클릭하여 새 파셜을 만드세요
이름을 asyntai-widget.htm으로 지정하세요
파셜에 Asyntai 임베드 코드를 추가하세요:
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
"Save"를 클릭하세요
레이아웃 템플릿을 열고 </body> 앞에 파셜을 포함하세요:
{% partial 'asyntai-widget' %}
레이아웃을 저장하세요

팁: 파셜을 사용하면 레이아웃에서 파셜 포함을 추가하거나 제거하기만 하면 전체 사이트에서 챗봇을 쉽게 활성화하거나 비활성화할 수 있습니다.

3단계: 설치 확인

변경 사항을 저장한 후, 새 브라우저 탭이나 시크릿 창에서 October CMS 웹사이트를 방문하세요. 오른쪽 하단에 채팅 위젯 버튼이 표시되어야 합니다. 클릭하여 올바르게 열리고 작동하는지 확인하세요.

위젯이 보이지 않나요? CMS 백엔드에서 모든 변경 사항을 저장했는지 확인하세요. 브라우저 캐시를 지우거나 시크릿 창에서 확인하세요. 사이트에서 캐시를 사용하는 경우 명령줄에서 php artisan cache:clear를 실행하거나 백엔드의 Settings > System > Clear Cache 옵션을 사용하여 October CMS 캐시를 지우세요.

레이아웃 선택: 챗봇을 표시하려는 페이지가 올바른 레이아웃을 사용하고 있는지 확인하세요. CMS > Pages에서 페이지를 열고 페이지 설정의 Layout 드롭다운을 확인하여 페이지가 사용하는 레이아웃을 확인할 수 있습니다.