문제 해결
증상별로 위에서 아래로 확인하면 대부분 원인이 드러납니다. 해결되지 않으면 확인한 내용을 함께 문의로 남겨 주세요.
실행 버튼이 보이지 않습니다
- 사이트 상세 개요 탭에서 운영 상태가 “운영 중”인지 확인합니다.
- 페이지 소스에 설치 스크립트가 실제로 들어 있는지 확인합니다(캐시된 HTML일 수 있습니다).
- data-site-key 값이 사이트 상세의 설치 코드와 같은지 대조합니다.
- 브라우저 콘솔에 스크립트 로드 실패가 있는지 확인합니다.
403 Origin is not allowed 응답
- 브라우저 주소창의 Origin(프로토콜+호스트+포트)을 그대로 허용 Origin에 추가합니다.
- https 와 http, www 유무, 포트 번호는 모두 서로 다른 Origin입니다.
- 리버스 프록시나 CDN이 Origin 헤더를 바꾸고 있지 않은지 확인합니다.
404 Widget configuration not found 응답
- 공개키가 잘렸거나 다른 사이트의 값이 아닌지 확인합니다.
- 사이트가 설정 대기·중지 상태이면 설정을 제공하지 않습니다.
- 사이트를 삭제했다면 그 공개키는 더 이상 사용할 수 없습니다. 새로 등록해 코드를 교체합니다.
설정을 저장했는데 화면에 바로 반영되지 않습니다
- 설정 응답은 짧게 캐시됩니다. 1분 뒤 강력 새로고침으로 다시 확인합니다.
- 사이트 상세의 리비전 번호가 올라갔는지 확인합니다. 번호가 그대로면 저장이 실패한 것입니다.
- 여러 사람이 같은 사이트를 동시에 수정하지 않았는지 확인합니다. 마지막 저장이 현재 설정입니다.
설치 상태가 계속 “설치 확인 대기”입니다
- 운영을 시작한 뒤 실제 사이트를 한 번 열어야 기록됩니다.
- 허용 Origin이 실제 접속 주소와 다르면 설정 요청이 거부되어 기록되지 않습니다.
- 설치 확인 기록은 1시간 간격으로 갱신되므로, 방금 열었다면 잠시 뒤 다시 확인합니다.
고객 사이트 화면과 충돌하는 것 같습니다
- 설치 스크립트가 두 번 들어가 있지 않은지 확인합니다.
- 브라우저 콘솔 오류를 그대로 캡처합니다.
- 재현되는 페이지 URL과 함께 1:1 문의를 남겨 주세요.