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

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

임베드 코드 받기

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

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

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

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

2단계: Header and Footer Scripts 모듈 사용 (권장)

챗봇을 추가하는 가장 쉬운 방법은 "Header and Footer Scripts" 모듈을 사용하는 것입니다:

  1. Drupal 관리자 패널에 로그인하세요
  2. Extend로 이동하여 "Install new module"을 클릭하세요
  3. "Header and Footer Scripts"를 검색하거나 Drupal.org에서 다운로드하십시오
  4. 모듈을 설치하고 활성화하세요
  5. Configuration → Development → Header and Footer Scripts로 이동하세요
  6. "Footer" 탭을 클릭하세요
  7. 푸터 스크립트 텍스트 영역에 Asyntai 임베드 코드를 붙여넣으세요
  8. "설정 저장"을 클릭하세요

팁: 푸터 섹션에 코드를 추가하면 페이지 콘텐츠 이후에 로드되어 채팅 위젯에 권장됩니다.

대안: 테마 템플릿 편집

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

  1. 테마 폴더로 이동하세요: themes/your_theme/
  2. html.html.twig 파일을 여세요 (존재하지 않으면 새로 만드세요)
  3. 닫는 </body> 태그를 찾으세요
  4. </body> 태그 바로 앞에 Asyntai 삽입 코드를 붙여넣으세요
  5. 파일을 저장하세요
  6. Drupal 캐시를 지우세요: Configuration → Performance → Clear all caches

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

대안: 라이브러리 사용 (개발자용)

Drupal의 에셋 라이브러리 시스템 사용을 선호하는 개발자의 경우:

  1. 테마의 *.libraries.yml 파일을 생성하거나 편집하세요
  2. 새 라이브러리 항목을 추가하세요:
    asyntai-chatbot:
    js:
    https://asyntai.com/static/js/chat-widget.js: { type: external, attributes: { async: true, data-asyntai-id: YOUR_WIDGET_ID } }
  3. 테마의 *.info.yml 파일에 라이브러리를 연결하세요:
    libraries:
    - your_theme/asyntai-chatbot
  4. Drupal 캐시를 지우세요

3단계: 설치 확인

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

위젯이 보이지 않나요? Configuration → Performance → Clear all caches로 이동하여 Drupal 캐시를 반드시 지우세요. 브라우저 캐시를 지우거나 시크릿 창에서 확인해 보세요.