Make Agent Fast 문서
카페24
카페24 디자인 편집기에서 쇼핑몰 레이아웃 HTML을 수정해 설치합니다.
이 페이지 한눈에
카페24 디자인 편집기에서 쇼핑몰 레이아웃 HTML을 수정해 설치합니다.
임베드 설치 경로사이트 로더가 호스팅 에이전트 런타임과 통신합니다
카페24(Cafe24)는 쇼핑몰 디자인을 HTML로 편집하는 국내 커머스 플랫폼입니다. 실행 버튼은 실제 서비스 중인 디자인의 공통 레이아웃에 설치합니다. 현재 카페24 앱스토어에 등록된 Make Agent Fast 앱은 없습니다. 아래 메뉴 이름은 2026-09 기준이며, 이름이 바뀌었다면 정확한 경로 대신 기능으로 해당 설정을 찾으세요.
로더 추가하기#
- Make Agent Fast 대시보드에서 사이트를 게시하고 임베드 활성화를 켠 뒤, 쇼핑몰의 모든 오리진을 허용 목록에 추가합니다.
cafe24.com쇼핑몰 주소와 연결한 도메인, 모바일 주소가 다르면 그 주소까지 필요합니다. - 디자인 관리에서 현재 서비스 중인 디자인의 HTML 편집을 엽니다. 쇼핑몰 소스를 직접 수정하므로 먼저 디자인을 복사하거나 백업하세요.
- 모든 페이지가 포함하는 공통 레이아웃 파일에서 닫는
</body>태그 바로 앞에 생성된 스니펫을 붙여 넣습니다. - 저장한 뒤 디자인을 쇼핑몰에 적용하고, PC와 모바일 디자인을 따로 운영한다면 모바일 디자인에도 같은 작업을 반복합니다.
<script src="https://makeagent.fast/embed.js?v=20260728-widget-v2"
data-agent="YOUR_SITE_SLUG"
async></script>레이아웃 파일을 찾을 수 없다면 테마의 푸터 블록에 스니펫을 붙여 넣으세요. 모든 페이지에 한 번씩만 표시되는 모듈이면 어디든 괜찮습니다.
확인하기#
- PC 주소와 모바일 주소 모두에서 쇼핑몰을 시크릿 창으로 엽니다.
- 주소 표시줄의 오리진이 허용 목록에 넣은 값과 같은지 확인합니다. 도메인이
www로 리디렉션되면 그 오리진을 확인합니다. - 네트워크 패널에서
embed.js가200을 반환하고data-maf-embed="YOUR_SITE_SLUG"요소가 하나만 있는지 확인합니다. - 실제 질문을 보내고 대화에 기록되는지 확인합니다.
문제 해결#
| 증상 | 원인 | 해결 |
|---|---|---|
| PC에서는 되는데 모바일에서 안 됨 | 모바일 디자인에 별도 레이아웃 파일이 있음 | 모바일 디자인에도 스니펫 추가 |
| 디자인을 바꾼 뒤 실행 버튼이 사라짐 | 스니펫이 없는 디자인을 적용함 | 현재 서비스 중인 디자인의 레이아웃에 다시 추가 |
| 장바구니나 하단 고정 바를 가림 | 고정 요소 두 개가 같은 모서리를 사용 | data-position으로 실행 버튼 위치 변경 |
API 키, 주문 번호, 고객 정보를 data-* 속성에 넣지 마세요. 허용 목록과 콘텐츠 보안 정책 설정은 보안 및 CSP에서 확인하세요.