Sori
로그인시작하기

Sori 사용 가이드

3분 만에 웹사이트에 피드백 위젯을 추가하세요

빠른 시작

1

계정 생성 및 프로젝트 만들기

회원가입 후 조직과 프로젝트를 생성하세요. 프로젝트 생성 시 Project ID가 발급됩니다.

2

위젯 코드 추가

웹사이트의 </body> 태그 앞에 아래 코드를 추가하세요.

HTML
<script src="https://sori.io/api/v1/widget" data-project-id="YOUR_PROJECT_ID"></script>
3

피드백 수집 시작

웹사이트 우측 하단에 피드백 버튼이 나타납니다. 수집된 피드백은 어드민 대시보드에서 확인하세요.

위젯 커스터마이징

HTML
<script
  src="https://sori.io/api/v1/widget"
  data-project-id="YOUR_PROJECT_ID"
  data-position="bottom-right"
  data-color="#4f46e5"
  data-text="Feedback"
></script>

설정 옵션 (data-* 속성)

data-project-id
필수 - 어드민에서 발급받은 프로젝트 ID
data-position
위젯 위치: bottom-right, bottom-left, top-right, top-left
data-color
테마 색상 (HEX 코드, 예: #4f46e5)
data-text
버튼에 표시될 텍스트 (기본값: Feedback)
data-api-url
API 서버 URL (자동 감지됨)

JavaScript API

위젯 제어

JavaScript로 위젯을 프로그래밍 방식으로 제어할 수 있습니다.

// 위젯 열기
window.SoriWidget.open();

// 위젯 닫기
window.SoriWidget.close();

REST API 직접 호출

위젯 없이 API를 직접 호출하여 피드백을 수집할 수도 있습니다.

JavaScript
// JavaScript
fetch('https://sori.io/api/v1/feedback', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    projectId: 'YOUR_PROJECT_ID',
    type: 'BUG',  // BUG, INQUIRY, FEATURE
    message: '버그 내용...',
    email: 'user@example.com'
  })
});

요청 파라미터

projectId
string
필수
프로젝트 ID
type
string
필수
BUG, INQUIRY, FEATURE
message
string
필수
피드백 내용
email
string
선택
사용자 이메일
metadata
object
선택
추가 메타데이터

도메인 설정

보안을 위해 프로젝트별로 허용된 도메인에서만 피드백을 수집할 수 있습니다. 어드민 대시보드의 프로젝트 설정에서 허용 도메인을 추가하세요.

도메인 설정 예시

  • https://myapp.com - 정확히 일치
  • https://*.myapp.com - 서브도메인 허용
  • * - 모든 도메인 허용 (비권장)

도메인을 설정하지 않으면 모든 도메인에서 피드백을 수집할 수 있습니다.

지금 바로 시작하세요

무료로 시작하고, 필요할 때 업그레이드하세요.

무료로 시작하기