피드백
SDK 피드백, 임베드 위젯, 상태·태그, 오류 연결과 NPS·CSAT 설문을 설정합니다.
extra관리 API 키의 admin:read 또는 feedback:read가 필요합니다.
curl -sS https://crm.theseeker.io/api/v1/feedback \
-H "Authorization: Bearer $THESEEKER_API_KEY"응답은 프로젝트와 조직 권한 범위에 따라 반환됩니다. 프로젝트 키는 자신이 연결된 프로젝트 밖의 데이터를 조회할 수 없습니다.
SDK는 기본적으로 실패 시 throw합니다. throwOnError: false를 선택하면 오류를 로그로 남기고 호출 흐름을 계속할 수 있습니다.
secret은 로그에 포함되지 않으며, 4xx 응답은 자동으로 무한 재시도하지 않습니다.
피드백 본문에는 비밀번호, access token, 결제 정보 같은 secret을 넣지 마세요. 필요한 경우 서버에서 입력을 정제한 뒤 전송하세요.
설정과 설치 방법은 위젯 설치 가이드를 참고하고, 코딩 에이전트에 맡기려면 AI 에이전트로 설치를 확인하세요.
프로젝트 설정에서 위젯을 활성화하고 허용 도메인을 등록한 다음, 표시 방식에 맞는 스니펫을 페이지에 추가합니다. data-key에는 위젯의 공개 키를 넣습니다.
React Native·Expo 앱에서도 허용 앱에 앱 ID를 등록한 뒤 앱 위젯 SDK를 설치할 수 있습니다.
<script src="https://crm.theseeker.io/js/feedback.js" data-key="fbw_..." defer></script>launcher는 화면 구석에 버튼을 띄웁니다. 위 스크립트를 사용합니다.
inline은 지정한 위치에 양식을 표시합니다. div와 스크립트를 순서대로 추가합니다.
<div data-theseeker-feedback-inline></div>
<script src="https://crm.theseeker.io/js/feedback.js" data-key="fbw_..." defer></script>다른 컨테이너를 선택하려면 스크립트에 data-target="#선택자"를 지정합니다.
manual은 떠 있는 버튼 없이 직접 만든 버튼으로 창을 엽니다.
<script src="https://crm.theseeker.io/js/feedback.js" data-key="fbw_..." defer></script>
<button type="button" data-theseeker-feedback-open>피드백 보내기</button>수동으로 만든 버튼 외에도 TheSeekerFeedback.open()을 호출해 창을 열 수 있습니다. TheSeekerFeedback.close()와 .setUser(id)로 위젯을 닫거나 사용자 ID를 설정할 수 있습니다. data-user-id는 선택 사항이며 TheSeekerFeedback.setUser()로 실행 중 바꿀 수도 있습니다. 위젯 설정의 허용 도메인과 일치하는 Origin에서만 config 조회와 제출이 허용됩니다. 설정에는 표시 방식, launcher 위치와 버튼 문구, 이미지 첨부 허용 여부 외에도 테마, 강조 색, 색상 세부, 모서리, 글꼴, 문구, 연락처 방식이 포함됩니다. 강조 색 프리셋은 라이트·다크별로 선택할 수 있고 직접 색상도 각각 지정할 수 있습니다.
사용자는 파일 선택, 드래그 앤 드롭 또는 붙여넣기로 이미지를 첨부할 수 있으며 최대 4장까지 보낼 수 있습니다. 큰 이미지는 자동으로 줄여 보냅니다. 위젯의 스크린샷 캡처·업로드는 종료되었습니다. multipart screenshot 파트나 JSON screenshot 필드를 보내면 400 SCREENSHOT_DISABLED를 반환합니다. 기존 스크린샷은 갤러리에 유지됩니다.
data-feedback-mask는 analytics 스크립트의 에러 트래킹 breadcrumb에서 해당 요소 내부의 클릭 텍스트를 제외하는 속성으로 계속 사용할 수 있습니다. 입력 필드의 값은 수집하지 않습니다. 자세한 동작은 에러 트래킹을 참고하세요.
CRM의 피드백 상세 패널에서 "첨부 이미지"를 확인할 수 있습니다. 이미지를 클릭하면 크게 볼 수 있으며 이전·다음 이미지로 이동할 수 있습니다.
제출 제한은 본문 1~5,000자, 연락 이메일 최대 254자, 자유 텍스트 연락처 최대 120자, 사용자 ID 최대 128자입니다. 페이지 URL은 최대 2,000자입니다. multipart 요청은 최대 9 MiB이며 이미지 하나는 최대 2 MiB입니다. 기존 JSON 요청은 최대 2 MiB입니다. IP와 위젯 키 조합당 10분에 10회, 키당 10분에 100회로 제한됩니다. SDK와 /v1/feedback은 이미지를 받지 않습니다.
대시보드에서 피드백 상태를 new, in_progress, resolved, closed로 관리하고 태그를 붙일 수 있습니다. 상세에는 세션과 연결된 오류 이슈가 표시될 수 있습니다. 위젯 데이터는 피드백으로, SDK 전송은 SDK 소스로 저장되며 항목에서 종류와 페이지 URL, 사용자 환경 정보를 확인합니다.
프로젝트당 활성 설문은 하나이며 NPS 또는 CSAT 유형을 선택합니다. 질문은 최대 200자, 후속 질문은 선택 사항이며 최대 200자입니다. 표시 지연은 0600초, 경로 패턴은 * wildcard, 표본 비율은 0100%, 재표시 대기 기간은 1~365일입니다. 방문자 브라우저의 localStorage에 응답 또는 닫은 시점을 기록해 cooldown 동안 다시 표시하지 않습니다. localStorage를 쓸 수 없으면 설문을 표시하지 않습니다.
NPS 점수는 round(100 × (추천자 수 - 비추천자 수) / 응답 수)입니다. 추천자는 910점, 중립은 78점, 비추천자는 06점입니다. CSAT 점수는 45점 응답 비율을 백분율로 반올림합니다. 설문 응답은 Telegram 알림을 생성하지 않습니다.
위젯 제출 endpoint와 REST 조회 필드는 Feedback API를 참고하세요.
이 페이지가 도움이 되었나요?