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" 모듈을 사용하는 것입니다:
- Drupal 관리자 패널에 로그인하세요
- Extend로 이동하여 "Install new module"을 클릭하세요
- "Header and Footer Scripts"를 검색하거나 Drupal.org에서 다운로드하십시오
- 모듈을 설치하고 활성화하세요
- Configuration → Development → Header and Footer Scripts로 이동하세요
- "Footer" 탭을 클릭하세요
- 푸터 스크립트 텍스트 영역에 Asyntai 임베드 코드를 붙여넣으세요
- "설정 저장"을 클릭하세요
팁: 푸터 섹션에 코드를 추가하면 페이지 콘텐츠 이후에 로드되어 채팅 위젯에 권장됩니다.
대안: 테마 템플릿 편집
테마의 템플릿 파일에 직접 코드를 추가할 수 있습니다:
- 테마 폴더로 이동하세요:
themes/your_theme/ - html.html.twig 파일을 여세요 (존재하지 않으면 새로 만드세요)
- 닫는
</body>태그를 찾으세요 </body>태그 바로 앞에 Asyntai 삽입 코드를 붙여넣으세요- 파일을 저장하세요
- Drupal 캐시를 지우세요: Configuration → Performance → Clear all caches
중요: 테마 파일의 변경 사항은 테마 업데이트 시 덮어쓸 수 있습니다. 보다 영구적인 솔루션을 위해 자식 테마 또는 Header and Footer Scripts 모듈 사용을 고려하세요.
대안: 라이브러리 사용 (개발자용)
Drupal의 에셋 라이브러리 시스템 사용을 선호하는 개발자의 경우:
- 테마의 *.libraries.yml 파일을 생성하거나 편집하세요
- 새 라이브러리 항목을 추가하세요:
asyntai-chatbot:
js:
https://asyntai.com/static/js/chat-widget.js: { type: external, attributes: { async: true, data-asyntai-id: YOUR_WIDGET_ID } } - 테마의 *.info.yml 파일에 라이브러리를 연결하세요:
libraries:
- your_theme/asyntai-chatbot - Drupal 캐시를 지우세요
3단계: 설치 확인
변경 사항을 저장하고 캐시를 지운 후 새 브라우저 탭이나 시크릿 창에서 웹사이트를 방문하세요. 오른쪽 하단에 채팅 위젯 버튼이 보여야 합니다. 클릭하여 올바르게 열리고 작동하는지 확인하세요.
위젯이 보이지 않나요? Configuration → Performance → Clear all caches로 이동하여 Drupal 캐시를 반드시 지우세요. 브라우저 캐시를 지우거나 시크릿 창에서 확인해 보세요.
Weebly