Umbraco에 Asyntai AI 챗봇을 추가하는 방법
Umbraco CMS 웹사이트를 위한 단계별 가이드
플랫폼:
1단계: 임베드 코드 가져오기
먼저 Asyntai 대시보드로 이동하여 "임베드 코드" 섹션까지 아래로 스크롤하십시오. 다음과 같은 형태의 고유 임베드 코드를 복사하십시오:
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
참고: 위의 코드는 예시일 뿐입니다. 개인 위젯 ID가 포함된 고유한 임베드 코드를 대시보드에서 복사해야 합니다.
2단계: Master 템플릿 편집 (권장)
모든 페이지에 챗봇을 추가하는 가장 쉬운 방법은 Master 템플릿을 편집하는 것입니다:
- Umbraco Backoffice에 로그인하세요
- 왼쪽 사이드바에서 Settings로 이동하세요
- Templates를 확장하세요
- Master 템플릿(또는 사이트가 사용하는 기본 레이아웃 템플릿)을 클릭하세요
- 닫는
</body>태그를 찾으세요 </body>태그 바로 앞에 Asyntai 삽입 코드를 붙여넣으세요- "Save"를 클릭하세요
팁: 닫는 </body> 태그 앞에 스크립트를 추가하면 페이지 콘텐츠 이후에 로드되며, 이는 채팅 위젯에 권장되고 페이지 로딩 속도를 저하시키지 않습니다.
대안: Site Settings Document Type 사용
더 유연하게 관리하기 위해 푸터 스크립트를 관리하는 커스텀 필드를 추가할 수 있습니다:
- Settings → Document Types로 이동하세요
- Site Settings document type을 편집하세요 (없으면 새로 만드세요)
- Textarea 데이터 타입으로 "Footer Scripts"라는 새 속성을 추가하세요
- Document Type을 저장하세요
- Content로 이동하여 Site Settings 노드를 편집하세요
- Footer Scripts 필드에 Asyntai 삽입 코드를 붙여넣으세요
- Master 템플릿에서
</body>앞에 다음 코드를 추가하세요:@Html.Raw(Model.Value("footerScripts")) - 콘텐츠와 템플릿 모두 저장하세요
참고: @Html.Raw()를 사용하면 HTML 인코딩 없이 스크립트 태그를 올바르게 렌더링할 수 있어 중요합니다.
대안: Scripts 폴더 사용
Umbraco Backoffice에서 JavaScript 파일을 만들 수도 있습니다:
- Settings → Scripts로 이동하세요
- Scripts를 마우스 오른쪽 버튼으로 클릭하고 "Create"를 선택하세요
- asyntai-chatbot.js라는 새 파일을 만드세요
- 다음 코드를 추가하세요:
(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);
})(); YOUR_WIDGET_ID를 실제 위젯 ID로 교체하세요- 파일을 저장하세요
- Master 템플릿의
</body>앞에 이 스크립트를 포함하세요:<script src="/scripts/asyntai-chatbot.js"></script>
대안: RenderSection을 사용한 페이지별 설정
특정 페이지에만 챗봇을 원하는 경우:
- Master 템플릿에서
</body>앞에 추가하세요:@RenderSection("footerScripts", required: false) - 챗봇을 추가하려는 특정 페이지 템플릿에 다음을 추가하세요:
@section footerScripts {
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
}
3단계: 설치 확인
변경 사항을 저장한 후, 새 브라우저 탭이나 시크릿 창에서 웹사이트를 방문하세요. 오른쪽 하단에 채팅 위젯 버튼이 표시되어야 합니다. 클릭하여 올바르게 열리고 작동하는지 확인하세요.
위젯이 보이지 않나요? 변경 후 템플릿을 저장했는지 확인하세요. 브라우저 캐시를 지우거나 시크릿 창에서 확인해 보세요. Umbraco Cloud를 사용하는 경우 변경 사항이 자동으로 배포됩니다. 자체 호스팅 Umbraco의 경우 애플리케이션을 다시 시작하거나 캐시를 지워야 할 수 있습니다.
Weebly