피드백 - theseeker CRM 문서

피드백

SDK 피드백, 임베드 위젯, 상태·태그, 오류 연결과 NPS·CSAT 설문을 설정합니다.

피드백 보내기

Status SDK의 sendFeedback을 사용하면 이벤트 endpoint와 연결된 프로젝트로 피드백을 보낼 수 있습니다.

typescript

await status.sendFeedback({
  uid: "user-123",
  content: "검색 결과가 느립니다.",
  fields: { plan: "pro" },
  extra: { screen: "search" },
});

uid는 애플리케이션이 사용하는 사용자 식별자이고 content는 사용자 의견입니다. 추가 분류 정보는 fields, 부가 문맥은 extra에 넣습니다.

REST 조회

관리 API 키의 admin:read 또는 feedback:read가 필요합니다.

bash

curl -sS https://crm.theseeker.io/api/v1/feedback \
  -H "Authorization: Bearer $THESEEKER_API_KEY"

응답은 프로젝트와 조직 권한 범위에 따라 반환됩니다. 프로젝트 키는 자신이 연결된 프로젝트 밖의 데이터를 조회할 수 없습니다.

실패 처리

SDK는 기본적으로 실패 시 throw합니다. throwOnError: false를 선택하면 오류를 로그로 남기고 호출 흐름을 계속할 수 있습니다. secret은 로그에 포함되지 않으며, 4xx 응답은 자동으로 무한 재시도하지 않습니다.

개인정보

피드백 본문에는 비밀번호, access token, 결제 정보 같은 secret을 넣지 마세요. 필요한 경우 서버에서 입력을 정제한 뒤 전송하세요.

임베드 위젯

프로젝트 설정에서 위젯을 활성화하고 허용 도메인을 등록한 다음 아래 스크립트를 페이지에 추가합니다. data-key에는 위젯의 공개 키를 넣습니다. data-user-id는 선택 사항이며 TheSeekerFeedback.setUser()로 실행 중 바꿀 수도 있습니다.

html

<script defer src="https://crm.theseeker.io/js/feedback.js"
  data-key="fbw_..." data-user-id="user-123"></script>

페이지에서 TheSeekerFeedback.open(), .close(), .setUser(id)를 호출해 위젯을 제어할 수 있습니다. 위젯 설정의 허용 도메인과 일치하는 Origin에서만 config 조회와 제출이 허용됩니다. 설정은 bottom-right 또는 bottom-left 위치, 버튼 문구, accent 색상과 스크린샷 사용 여부를 가집니다.

스크린샷 첨부는 선택 사항이며 뷰포트 캡처를 JPEG로 압축해 한 장만 첨부합니다. 비밀번호 입력은 비우고 [data-feedback-mask]가 붙은 요소는 ••••로 가립니다. 입력이나 표시 정보가 캡처되면 안 되는 DOM에 이 속성을 지정하세요.

제출 제한은 본문 1~5,000자, 연락 이메일 최대 254자, 사용자 ID 최대 128자입니다. 페이지 URL은 최대 2,000자입니다. 요청은 최대 2 MiB, 스크린샷은 JPEG 최대 1,572,864바이트입니다. IP와 위젯 키 조합당 10분에 10회, 키당 10분에 100회로 제한됩니다.

피드백 상태와 연결

대시보드에서 피드백 상태를 new, in_progress, resolved, closed로 관리하고 태그를 붙일 수 있습니다. 상세에는 세션과 연결된 오류 이슈가 표시될 수 있습니다. 위젯 데이터는 피드백으로, SDK 전송은 SDK 소스로 저장되며 항목에서 종류와 페이지 URL, 사용자 환경 정보를 확인합니다.

NPS와 CSAT 설문

프로젝트당 활성 설문은 하나이며 NPS 또는 CSAT 유형을 선택합니다. 질문은 최대 200자, 후속 질문은 선택 사항이며 최대 200자입니다. 표시 지연은 0~~600초, 경로 패턴은~~ ~~*~~ ~~wildcard, 표본 비율은 0~~100%, 재표시 대기 기간은 1~365일입니다. 방문자 브라우저의 localStorage에 응답 또는 닫은 시점을 기록해 cooldown 동안 다시 표시하지 않습니다. localStorage를 쓸 수 없으면 설문을 표시하지 않습니다.

NPS 점수는 round(100 × (추천자 수 - 비추천자 수) / 응답 수)입니다. 추천자는 9~~10점, 중립은 7~~8점, 비추천자는 0~~6점입니다. CSAT 점수는 4~~5점 응답 비율을 백분율로 반올림합니다. 설문 응답은 Telegram 알림을 생성하지 않습니다.

위젯 제출 endpoint와 REST 조회 필드는 Feedback API를 참고하세요.

이 페이지가 도움이 되었나요?

피드백