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

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

임베드 코드 받기

플랫폼:

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

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

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

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

2단계: MODX 템플릿에 추가 (권장)

챗봇을 추가하는 권장 방법은 MODX Manager에서 직접 MODX 템플릿을 편집하는 것입니다:

MODX Manager(관리 패널)에 로그인하세요
왼쪽 사이드바에서 Elements > Templates로 이동하세요
사이트의 템플릿을 여세요 (보통 "BaseTemplate" 또는 활성 템플릿이라고 함)
템플릿 코드에서 닫는 </body> 태그를 찾으세요
닫는 </body> 태그 바로 앞에 Asyntai 임베드 코드를 붙여넣으세요
"Save"를 클릭하여 템플릿을 저장하세요

<!-- Your existing template content -->

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

팁: 닫는 </body> 태그 바로 앞에 코드를 추가하면 모든 페이지 콘텐츠가 로드된 후 챗봇이 로드됩니다. 이는 채팅 위젯의 권장 배치이며 페이지 로딩을 느리게 하지 않습니다.

대체 방법 1: MODX Chunk 사용

MODX Chunk를 사용하여 임베드 코드를 분리하고 재사용할 수 있습니다:

MODX Manager에서 Elements > Chunks로 이동하세요
"New Chunk"를 클릭하여 새 chunk를 만드세요
chunk 이름을 "asyntaiWidget"으로 지정하세요
chunk 콘텐츠 영역에 Asyntai 임베드 코드를 붙여넣으세요
"Save"를 클릭하세요
템플릿을 여세요 (Elements > Templates 아래)
닫는 </body> 태그 바로 앞에 chunk 호출 [[$asyntaiWidget]]을 추가하세요
템플릿을 저장하세요

<!-- In your Template, before </body> -->
[[$asyntaiWidget]]
</body>
</html>

팁: Chunk를 사용하면 특히 사이트에서 여러 템플릿을 사용하는 경우 한 곳에서 임베드 코드를 쉽게 관리하고 업데이트할 수 있습니다.

대체 방법 2: MODX 시스템 설정 사용 (HTML Head/Footer)

일부 MODX 설정에는 시스템 설정을 통한 푸터 스크립트 플레이스홀더가 포함되어 있습니다:

MODX Manager에서 System > System Settings로 이동하세요
"htmlhead"로 필터링하거나 푸터 스크립트용 사용자 정의 시스템 설정을 검색하세요
설정에 푸터 스크립트용 플레이스홀더(예: [[++footer_scripts]])가 있으면 사용할 수 있습니다
시스템 설정 값을 Asyntai 임베드 코드로 설정하세요
닫는 </body> 태그 앞에 해당 플레이스홀더 [[++footer_scripts]]가 템플릿에 있는지 확인하세요
시스템 설정을 저장하세요

<!-- In your Template, before </body> -->
[[++footer_scripts]]
</body>
</html>

참고: 이 방법은 MODX 설정에 푸터 스크립트용 사용자 정의 시스템 설정이 있는지에 따라 다릅니다. 없는 경우 사용자 정의 시스템 설정을 만들고 [[++setting_key]] 구문을 사용하여 템플릿에서 참조할 수 있습니다.

대체 방법 3: MODX 플러그인 사용 (OnWebPagePrerender)

고급 접근 방식으로 모든 페이지에 챗봇 코드를 자동으로 삽입하는 MODX 플러그인을 만들 수 있습니다:

MODX Manager에서 Elements > Plugins로 이동하세요
"New Plugin"을 클릭하여 새 플러그인을 만드세요
플러그인 이름을 "AsyntaiChatbot"으로 지정하세요
다음 PHP 코드를 플러그인 코드 영역에 붙여넣으세요:

$output = &$modx->resource->_output;
$script = '<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>';
$output = str_replace('</body>', $script . '</body>', $output);

"System Events" 탭을 클릭하세요
"OnWebPagePrerender" 옆의 확인란을 선택하여 해당 이벤트에서 이 플러그인을 실행하세요
"Save"를 클릭하세요

중요: YOUR_WIDGET_ID를 Asyntai Dashboard의 실제 위젯 ID로 교체하세요. 이 플러그인은 렌더링되기 전에 MODX 사이트의 모든 페이지에 챗봇 스크립트를 자동으로 삽입합니다.

3단계: 캐시 지우기 및 확인

위의 방법 중 하나를 사용하여 임베드 코드를 추가한 후 MODX 캐시를 지우고 설치를 확인해야 합니다:

MODX Manager에서 Manage > Clear Cache로 이동하세요 (또는 상단 메뉴의 캐시 지우기 아이콘을 클릭하세요)
새 브라우저 탭 또는 시크릿 창에서 웹사이트를 여세요
페이지 오른쪽 하단에 채팅 위젯 버튼이 표시되어야 합니다
클릭하여 올바르게 열리고 작동하는지 확인하세요

위젯이 보이지 않나요? MODX Manager의 Manage > Clear Cache에서 MODX 캐시를 지웠는지 확인하세요. 브라우저 캐시를 지우거나 시크릿 창에서 사이트를 확인해 보세요. 플러그인 방법을 사용한 경우 플러그인에 대해 "OnWebPagePrerender" 시스템 이벤트가 선택되어 있는지 확인하세요.