upfall
본문으로 바로가기
문서 목록

위젯 미표시

설치를 마쳤는데 사이트에 위젯이 보이지 않을 때의 점검·개선 방법

설치 코드를 붙였거나 앱을 설치했는데 사이트 화면 구석에 위젯이 나타나지 않았습니다. 위젯이 없으면 방문자는 말을 걸 수 없고, 설치가 끝났다고 믿는 동안 상담 기회가 그대로 지나갑니다. 대부분은 접속한 주소, 코드 위치, 앱 연결 상태 중 하나가 어긋난 경우입니다.

조치 방법

  1. 직접 설치한 위젯에서는 위젯 키를 발급한 도메인과 접속한 주소가 같은지 확인하세요. shop.example.com과 example.com, localhost는 서로 다른 도메인이라 다른 도메인에는 그 도메인으로 키를 새로 발급해 붙입니다.
  2. 설치 코드가 </body> 바로 위에 있는지 확인하세요. <head> 안에 넣으면 동작하지 않습니다.
  3. 키를 재발급한 적이 있다면 사이트의 설치 코드를 새 키로 교체해 배포하세요. 재발급 즉시 이전 키는 동작하지 않고, 현재 키는 콘솔 "에이전트 연결"의 "위젯 키 직접 관리"에서 "비활성" 배지 없이 보여야 합니다. 키와 도메인의 관계는 위젯 키와 도메인에 있습니다.
  4. 화면 우하단에 "인터넷 연결이 끊어졌습니다." 배너가 있거나 광고 차단 확장을 쓰고 있다면 연결을 복구하고 확장을 끈 상태에서 다시 확인하세요.
  5. 카페24 앱에서는 카페24 관리자 > 앱 > 내가 설치한 앱 > [앱 관리]로 몰 대시보드를 열어 화면 아래 연결 상태 시트의 "위젯"이 "설치됨"인지 확인하고, "미설치"면 "자세히 보기"를 눌러 "위젯 다시 설치"를 누르세요. 위젯은 상품 상세·상품 목록 화면에 표시되고 반영에 1분 정도 걸릴 수 있습니다. "다른 채널의 voidX 위젯 스크립트가 함께 설치돼 있어요" 경고가 보이면 사용하지 않는 쪽 스크립트를 삭제하고, "앱 상태"가 "만료됨"이면 맨 위 "플랜·충전팩"에서 결제를 진행합니다.
  6. 쇼피파이 앱에서는 테마 에디터의 App embeds에서 AI Chat Widget을 켜고 오른쪽 위 저장 버튼까지 누르세요. 토글만 켜면 반영되지 않습니다.
  7. 그래도 해결되지 않으면 문의하기로 사이트 주소·발생 시각·브라우저·화면 캡처를 함께 보내주세요.

다음 단계

답변 부정확가격·정책·상품 정보가 사이트 내용과 다를 때의 점검·개선 방법