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

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

임베드 코드 받기

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

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

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

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

2단계: 사용자 정의 HTML 모듈을 사용하여 코드 추가 (권장)

모든 페이지에 챗봇을 추가하는 가장 쉬운 방법은 사용자 정의 HTML 모듈을 사용하는 것입니다:

  1. Joomla 관리자 패널에 로그인하세요
  2. Content → Site Modules로 이동하세요
  3. "New"를 클릭하여 새 모듈을 만드세요
  4. "Custom"(사용자 정의 HTML 모듈)을 선택하세요
  5. "Asyntai Chatbot"과 같은 제목을 입력하세요 (나중에 숨길 수 있음)
  6. "Toggle Editor" 버튼을 클릭하여 원시 HTML 모드로 전환하세요
  7. Asyntai 임베드 코드를 붙여넣으세요
  8. "Position" 필드에서 푸터 위치를 선택하세요 (예: "footer" 또는 "debug")
  9. "Show Title"을 "Hide"로 설정하세요
  10. "Menu Assignment" 탭에서 "On all pages"를 선택하세요
  11. "Save & Close"를 클릭하세요

팁: 코드가 제거되면 System → Global Configuration → Site로 이동하여 기본 편집기를 일시적으로 "None"으로 설정하고, 코드를 추가한 다음 다시 전환하세요.

대체 방법: 템플릿 파일 편집

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

  1. System → Site Templates로 이동하세요
  2. 활성 템플릿 이름을 클릭하세요
  3. 파일 목록에서 "index.php"를 찾아 클릭하세요
  4. 아래로 스크롤하여 닫는 </body> 태그를 찾으세요
  5. </body> 태그 바로 앞에 Asyntai 삽입 코드를 붙여넣으세요
  6. "Save"를 클릭하세요

중요: 템플릿 파일에 대한 변경 사항은 템플릿을 업데이트할 때 손실됩니다. 보다 영구적인 솔루션을 위해 자식 템플릿이나 사용자 정의 HTML 모듈 방법을 사용하는 것을 고려하세요.

대체 방법: 확장 기능 사용

무료 확장 기능을 사용하여 사용자 정의 스크립트를 추가할 수도 있습니다:

  1. Joomla 확장 디렉토리로 이동하십시오
  2. "Add Custom Javascript" 확장 기능을 다운로드하세요
  3. Joomla 관리자에서 System → Install → Extensions로 이동하세요
  4. 확장 기능을 업로드하고 설치하세요
  5. Components → Add Custom Javascript로 이동하세요
  6. Asyntai 임베드 코드를 추가하세요
  7. 모든 페이지에서 로드되도록 설정하세요

3단계: 설치 확인

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

위젯이 보이지 않나요? System → Clear Cache로 이동하여 "Delete All"을 클릭하여 Joomla 캐시를 지우세요. 브라우저 캐시를 지우거나 시크릿 창에서 확인해 보세요.