시작하기

Quipier는 어떤 웹사이트에든 붙이는 임베드 댓글 위젯입니다. 끝 사용자는 회원가입·로그인 없이 패스포트(익명 신원) 로 댓글을 답니다.

5분 빠른 시작

1. 대시보드에서 프로젝트를 만들고 project id와 publishable key(qp_...)를 확인합니다.
2. 페이지에 스크립트 한 줄과 컨테이너를 넣습니다.

<script src="https://cdn.jsdelivr.net/npm/@quipier/sdk@0.1/dist/quipier.js"></script>
<div id="quipier-comments"></div>
<script>
  Quipier.init({
    container: "#quipier-comments",
    apiKey: "qp_YOUR_PUBLISHABLE_KEY",
    projectId: "YOUR_PROJECT_ID",
    pageId: location.pathname,
  });
</script>

3. 끝입니다. 같은 projectId라도 pageId가 다르면 페이지별로 댓글 흐름이 분리됩니다.

핵심 개념

• 프로젝트 — 댓글이 묶이는 단위. publishable key로 위젯을 인증합니다.
• page_id — 한 프로젝트 안에서 댓글 스레드를 나누는 키(보통 location.pathname).
• 패스포트 — 끝 사용자의 익명 신원. 로그인 대신 패스포트로 작성합니다.
• 도메인 인증 — localhost·문서 플레이그라운드는 자동 허용, 운영 도메인은 대시보드에서 등록합니다.

모듈

한 프로젝트에서 모듈을 켜서 함께 씁니다(같은 패스포트 신원 공유):

• Comments — 외부 글(page)별 댓글·답글·좋아요 위젯
• Feed — 유저가 글을 쓰는 프로젝트 전역 타임라인(트위터형)
• Chat — 1:1 DM + 오픈채팅방, 실시간(headless 훅으로 UI 직접 구성)

다음 단계

• 패스포트 — 익명 신원이 동작하는 방식
• 도메인 인증 — publishable key 보호와 운영 도메인 등록
• API 레퍼런스 — REST·WebSocket 엔드포인트 전체