지원

문제 해결 · FAQ

자주 겪는 문제와 해결 방법입니다. 해결되지 않으면 문의 페이지의 양식이나 sean@okitour.com 으로 연락 주세요.

#위젯이 보이지 않아요

설치 코드의 프로젝트 ID 가 맞는지 확인하세요.
프로젝트의 허용 도메인에 사이트 도메인(www 포함 여부까지)이 들어 있는지 확인하세요.
CSP(Content-Security-Policy)를 쓰면 script-src·frame-src 에 https://app.cliptalk.net 을 추가하세요.
브라우저 개발자 도구의 Console/Network 탭에서 오류를 확인하세요.

Content-Security-Policy:
  script-src 'self' https://app.cliptalk.net;
  frame-src https://app.cliptalk.net;
  connect-src 'self' https://app.cliptalk.net wss://app.cliptalk.net;

#AI 상담봇이 답하지 않아요

AI 상담봇 사용이 켜져 있고 저장했는지 확인하세요 (적용까지 최대 20초).
Free 플랜은 AI 상담 30건 체험이 끝나면 상담원에게 바로 연결됩니다. 구독 탭에서 사용량을 확인하세요.
상담원이 이미 참여한 상담에서는 AI 가 답하지 않습니다.

#AI 가 내 API 를 쓰지 않아요

커넥터가 내 API 로 연결되어 있는지(스튜디오 상단 "AI 상담봇에 연결됨") 확인하세요.
작업이 사용 상태인지, 설명이 고객 질문과 연결되도록 구체적인지 확인하세요.
고객 정보가 필요한 작업은 본인확인이 먼저 성공해야 합니다. 본인확인 안내 문구를 넣어 고객이 필요한 정보를 먼저 주도록 유도하세요.
API 사용 규칙에 "배송 문의에는 get_order 를 사용" 처럼 명시하면 더 확실합니다.

#API 테스트가 실패해요

증상	확인할 것
`401 / 403`	보안키 값, 인증 방식(Bearer 인지 헤더인지), 헤더 이름, 키 권한, IP 허용 목록
`404`	Base URL + 경로가 실제 주소와 같은지, /v1 같은 버전 경로 중복 여부
`bad_json`	로그인 페이지나 HTML 오류 페이지가 오는 경우 — 경로·인증 확인
`timeout`	API 서버 응답 속도, 방화벽
`blocked_address`	사내망 주소는 사용할 수 없습니다. 공개 주소로 열거나 게이트웨이를 두세요
`secret_origin_mismatch`	Base URL 도메인을 바꾼 뒤 보안키를 다시 입력

#클립톡 직원이 우리 키를 볼 수 있나요?

키는 암호화되어 저장되고, 대시보드·관리자 화면·API 응답 어디에도 표시되지 않습니다. 복호화는 실제 API 호출 순간에만 서버 메모리에서 이루어집니다. 그래도 만약을 위해 챗봇 전용·최소 권한 키 사용을 권장합니다.

#API 응답 데이터는 어디에 저장되나요?

API 응답은 AI 가 답변을 만드는 동안에만 사용되며 별도로 저장하지 않습니다. 고객에게 보낸 답변 메시지와 처리 작업의 결과 요약(AI 처리 기록)만 상담 기록에 남습니다.