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

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

임베드 코드 받기

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

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

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

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

2단계: 커스텀 코드 모듈 사용 (권장)

챗봇을 추가하는 가장 쉬운 방법은 PrestaShop Addons 마켓플레이스의 무료 "Custom Code" 모듈을 사용하는 것입니다:

  1. PrestaShop 백오피스에 로그인합니다
  2. Modules → Module Manager로 이동합니다
  3. "Upload a module"을 클릭하거나 마켓플레이스에서 "Custom Code" 또는 "Header Footer Scripts"를 검색합니다
  4. "Custom JS and CSS" 또는 유사한 모듈을 설치합니다
  5. 설치가 완료되면 모듈의 구성으로 이동합니다
  6. "Footer Scripts" 또는 "Before </body>" 섹션을 찾습니다
  7. Asyntai 임베드 코드를 붙여넣으세요
  8. "Save"를 클릭하세요

팁: 이 용도로 사용할 수 있는 인기 무료 모듈에는 "Custom JS and CSS Pro", "Custom Code", "Header and Footer Scripts"가 있습니다. 이러한 모듈은 테마 및 PrestaShop 업데이트 시에도 유지됩니다.

대안: 테마 템플릿 편집 (PrestaShop 1.7+/8)

테마의 푸터 템플릿에 직접 코드를 추가할 수 있습니다:

  1. FTP 또는 파일 관리자를 통해 PrestaShop 파일에 접근합니다
  2. 테마 폴더로 이동합니다: themes/your_theme/templates/_partials/
  3. footer.tpl 파일을 엽니다 (일부 테마에서는 templates/layouts/layout-both-columns.tpl을 확인하세요)
  4. 닫는 </body> 태그 또는 {block name='javascript_bottom'} 섹션을 찾습니다
  5. 닫는 </body> 태그 바로 앞에 Asyntai 임베드 코드를 붙여넣으세요
  6. 파일을 저장하세요
  7. PrestaShop 캐시 지우기: Advanced Parameters → Performance → Clear cache

중요: 테마 파일의 변경 사항은 테마 업데이트 시 덮어쓰기될 수 있습니다. 보다 영구적인 솔루션을 위해 자식 테마 또는 모듈 사용을 고려하세요.

대안: 테마의 커스텀 JavaScript 파일 사용

Many PrestaShop themes include a custom.js file for your own scripts:

  1. themes/your_theme/assets/js/로 이동합니다
  2. custom.js라는 파일을 찾습니다 (없으면 생성합니다)
  3. 다음 코드를 추가하여 챗봇을 동적으로 로드합니다:
    (function() {
      var script = document.createElement('script');
      script.async = true;
      script.src = 'https://asyntai.com/static/js/chat-widget.js';
      script.setAttribute('data-asyntai-id', 'YOUR_WIDGET_ID');
      document.body.appendChild(script);
    })();
  4. YOUR_WIDGET_ID를 실제 위젯 ID로 교체하세요
  5. PrestaShop 캐시를 지웁니다

대안: 간단한 모듈 생성 (개발자용)

개발자의 경우, displayFooter 훅을 사용하여 간단한 모듈을 만들 수 있습니다:

  1. 폴더를 생성합니다: modules/asyntaichatbot/
  2. 다음 코드로 asyntaichatbot.php를 생성합니다:
    <?php
    class AsyntaiChatbot extends Module {
      public function __construct() {
        $this->name = 'asyntaichatbot';
        $this->version = '1.0.0';
        $this->author = 'Your Name';
        parent::__construct();
        $this->displayName = 'Asyntai Chatbot';
      }
      public function install() {
        return parent::install() && $this->registerHook('displayFooter');
      }
      public function hookDisplayFooter($params) {
        return '<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>';
      }
    }
  3. YOUR_WIDGET_ID를 실제 위젯 ID로 교체하세요
  4. Modules → Module Manager를 통해 모듈을 설치합니다

3단계: 설치 확인

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

위젯이 보이지 않나요? PrestaShop 캐시를 지우세요: Advanced Parameters → Performance → Clear cache로 이동합니다. 또한 브라우저 캐시를 지우거나 시크릿 창에서 확인해 보세요. 커스텀 모듈을 사용하는 경우, Module Manager에서 활성화되어 있는지 확인하세요.