DropComments

내 앱 안에서 받는 피드백

DropComments SDK

스크립트 태그 하나, 서버의 엔드포인트 하나, 직접 만든 피드백 버튼으로 개발 중인 앱 안에서 피드백을 받으세요. 팀은 앱의 해당 위치에 댓글, 상자, 그림을 남기고, 앱을 쓰는 사람들은 간단한 양식으로 피드백을 보냅니다. 모든 피드백은 이곳의 프로젝트에 모이며, 여러분과 AI 에이전트가 답글을 달 수 있습니다.

SDK 설치하기

무료로 시작하세요. 앱의 키는 서버에 보관됩니다.

앱 피드백을 남길 때마다 스크린샷부터 찍을 필요는 없어요

앱을 테스트하던 사람이 문제를 발견하면 스크린샷을 찍고, 자르고, 채팅에 붙여 넣은 뒤 “두 번째 화면 위쪽에 있는 거요”라고 설명합니다. 그러면 그 화면을 찾아가 무엇을 가리키는지 짐작해야 하죠.

앱에 스크립트를 넣으면 그 자리에서 바로 가리킬 수 있습니다. 댓글에는 당시 화면 이미지와 표시한 위치, 보낸 사람이 함께 담겨 여러분이나 코딩 에이전트가 바로 수정에 나설 수 있고, 답글은 앱 안에 표시됩니다.

사용 방법

  1. 1

    앱 추가

    계정의 앱 메뉴에서 이름, 실행 주소, 피드백을 받을 프로젝트를 설정하세요. 예를 들어 팀용과 고객용 프로젝트를 하나씩 둘 수 있습니다. 앱을 추가하면 키가 발급됩니다.

  2. 2

    스크립트 추가

    앱 서버가 키를 보관하고, 로그인한 사람의 팀 소속 여부를 담은 단기 토큰을 페이지에 전달합니다. 페이지는 스크립트 태그 하나를 불러오고, 직접 만든 피드백 버튼으로 피드백 도구를 엽니다. DropComments에 표시된 내용을 앱을 만드는 에이전트에게 붙여 넣으면 필요한 요소를 추가해 줍니다.

  3. 3

    피드백 받기

    팀은 피드백 버튼을 누르고 해당 위치에 핀을 꽂아 글을 남깁니다. 앱에서 모든 팀원의 핀과 답글을 실시간으로 볼 수 있습니다. 그 외의 사람에게는 간단한 양식이 열립니다. 각 피드백은 해당 프로젝트에서 Drop의 화면으로 저장됩니다.

SDK 설치하기

서버와 로그인 사용자가 있는 웹 앱을 위한 기능입니다. 설치할 패키지는 없습니다. 서버에 보관할 키, 페이지에 토큰을 전달할 엔드포인트, 스크립트 태그, 피드백 도구를 여는 직접 만든 버튼만 있으면 됩니다.

  1. DropComments의 앱 메뉴에서 앱을 추가하세요. 이름, 실행 주소(https, 또는 개발 중에는 localhost와 .test의 http), 피드백을 받을 프로젝트를 설정합니다. 앱의 키와 각 프로젝트의 ID가 발급됩니다.

    앱 추가

  2. 환경 변수나 시크릿으로 서버에 키를 보관하세요:

    DROPCOMMENTS_KEY=dc_app_…

    페이지나 브라우저에 전달되는 코드, 커밋에는 절대 넣지 마세요. DropComments는 브라우저에서 보내는 키를 거부합니다.

  3. 토큰 엔드포인트를 추가하세요. 로그인한 사람을 위한 토큰을 DropComments에 요청하고, 받은 JSON을 그대로 반환합니다. 로그인한 사람이 없으면 401로 응답하며, 아무것도 표시되지 않습니다.

    // GET /api/feedback-token
    export async function GET(request) {
      const user = await getSignedInUser(request); // your own sign-in
      if (!user) return new Response(null, {status: 401});
    
      const res = await fetch("https://dropcomments.com/api/app/token", {
        method: "POST",
        headers: {
          authorization: `Bearer ${process.env.DROPCOMMENTS_KEY}`,
          "content-type": "application/json",
        },
        body: JSON.stringify({
          project: "YOUR_PROJECT_ID",
          user: {id: user.id, name: user.name},
          team: user.isStaff, // true: pin comments on the app. false: the short form
        }),
      });
      return new Response(res.body, {status: res.status, headers: {"content-type": "application/json"}});
    }

    Next.js 라우트 핸들러로 작성한 예시입니다. Worker, Deno, Bun에서도 방식은 같습니다. Express에서는 동일한 상태 코드와 JSON을 반환하세요.

  4. 모든 페이지에서 </body> 앞에 스크립트를 불러오세요:

    <script src="https://dropcomments.com/live.js" data-token-url="/api/feedback-token"></script>

    스크립트 자체는 버튼을 만들지 않으므로 아직 아무것도 표시되지 않습니다.

  5. 피드백 버튼을 직접 추가하세요. DropComments.ready가 토큰 수신을 알릴 때까지 숨겨 두고, 팀에게는 패널을, 그 외의 사람에게는 간단한 양식을 열어 줍니다:

    <button id="feedback" hidden>Feedback</button>
    
    const button = document.getElementById("feedback");
    if (await DropComments.ready) {
      button.hidden = false;
      button.addEventListener("click", () => DropComments.open());
    }

    헤더, 메뉴, 설정 화면 등 앱에 어울리는 곳에 배치하세요. 패널과 양식, 핀은 스크립트가 제공합니다.

  6. 페이지에서 Content-Security-Policy를 전송한다면 DropComments를 허용하세요:

    script-src https://dropcomments.com;
    connect-src https://dropcomments.com wss://dropcomments.com;

코딩 에이전트에게 맡겨도 됩니다. 앱을 추가하면 키와 프로젝트 ID가 이미 포함된 안내문이 표시됩니다. 앱을 만드는 에이전트에게 붙여 넣으면 엔드포인트, 스크립트, 버튼을 추가해 줍니다.

레퍼런스

토큰

서버는 앱의 키를 Bearer 토큰으로 사용해 POST https://dropcomments.com/api/app/token을 호출합니다. project는 필수이며 ID로 지정합니다. user는 로그인한 사람입니다. 이름을 생략하면 패널에서 이름을 묻습니다. team은 사용할 수 있는 도구를 결정합니다. 토큰은 한 시간 동안 유효하며, 만료되기 전에 스크립트가 엔드포인트에 새 토큰을 요청합니다.

{
  "project": "YOUR_PROJECT_ID",
  "user": {"id": "u_123", "name": "Sam Lee"},
  "team": true
}
// → {"token": "dct.…", "expiresAt": …, "team": true, "project": {…}}

스크립트 옵션

data-token-url은 페이지의 쿠키를 포함해 요청할 엔드포인트입니다. 토큰의 JSON이나 일반 텍스트 형식의 토큰으로 응답할 수 있습니다. data-ui="none"은 자체 양식을 쓸 수 있도록 아무것도 표시하지 않습니다. 양식에서 수집한 내용은 DropComments.send()로 보내세요. 컴퓨터에서 팀원이 댓글을 남기면 이미지와 함께 페이지 사본도 전달됩니다. Drop에서 페이지 버튼을 누르면 스크롤하고 텍스트를 선택할 수 있는 사본이 표시되며, 에이전트도 그 내용을 읽을 수 있습니다. data-capture="picture"는 이미지만 보냅니다. 휴대폰과 태블릿에서는 항상 이미지만 보냅니다.

<script src="https://dropcomments.com/live.js"
  data-token-url="/api/feedback-token"
  data-capture="picture"></script>

JavaScript

스크립트가 로드되면 모든 기능을 window.DropComments에서 사용할 수 있습니다. ready가 토큰 수신 여부를 알려 주므로, 토큰을 받은 뒤에만 버튼을 표시하세요.

await DropComments.ready; // true once a token came
DropComments.open();  // the team’s panel, or everyone else’s form
DropComments.close();
await DropComments.send({text: "The total is wrong", picture: true});
await DropComments.link(); // the team’s feedback in DropComments, or null

앱에 맞는 디자인

피드백 버튼은 원하는 대로 꾸밀 수 있습니다. :root에 이 변수들을 설정하면 패널, 양식, 핀에도 적용됩니다. 나머지 변수는 --dc-muted, --dc-line, --dc-soft, --dc-on-accent, --dc-accent-text, --dc-pin, --dc-on-pin, --dc-button-radius입니다.

:root {
  --dc-font: "Inter", sans-serif;
  --dc-surface: #ffffff;
  --dc-text: #111827;
  --dc-accent: #4f46e5;
  --dc-radius: 12px;
}

비공개 정보 보호

댓글에는 화면 이미지가 첨부되므로 입력한 텍스트를 포함해 화면에 보이는 내용이 담깁니다(비밀번호는 점으로 표시됩니다). 앱 밖으로 절대 내보내면 안 되는 부분을 표시하면 이미지에서는 회색 상자로 가려지고 페이지 사본에서는 제외됩니다. 사본에는 스크립트가 없으며 입력 필드는 비워 둡니다.

<div data-dc-hide>
  Card ending 4242
</div>

제공 기능

개발 버전을 테스트하는 팀

컴퓨터나 휴대폰에서 실행 중인 앱에 핀을 꽂거나 상자와 그림을 그리세요. 각 댓글에는 해당 위치가 표시된 화면 이미지가 담기며, 컴퓨터에서는 페이지 사본도 함께 담깁니다. “여기가 안 돼요” 한마디면 충분합니다.

앱을 쓰는 사람들

‘위치 가리키기’와 화면 이미지가 포함된 간단한 양식을 제공합니다. 다른 사람의 피드백은 볼 수 없으며, 이미지 첨부 항목을 선택한 상태로 두었을 때만 이미지가 전송됩니다.

베타 테스터와 고객

함께 테스트하는 사람들이 로그인하게 하고, 누구를 팀으로 분류할지 정하세요. 스테이징 사이트를 검토하는 고객이 사이트 위에 바로 의견을 남길 수 있습니다.

에이전트가 수정

DropComments에 연결된 코딩 에이전트가 각 댓글과 댓글을 남긴 페이지를 읽고, 수정한 뒤 답글을 답니다. 답글은 앱 안에 표시됩니다.

앱과 어울리는 디자인

몇 가지 CSS 변수로 사용자용 양식에 앱의 색상, 글꼴, 모서리 모양을 적용하세요. 자체 양식을 쓰고 한 번의 호출로 전송해도 됩니다.

키는 서버에 안전하게

키는 서버에 보관하며 페이지에는 절대 넣지 않습니다. 피드백은 앱의 주소에서만 받으며, 사람별로 한도가 적용되고 각 프로젝트는 ID로 지정합니다.

피드백을 인박스로

각 피드백이 해당 프로젝트의 인박스에 티켓으로 들어와, 누군가 바로 맡을 수 있습니다.

자주 묻는 질문

어떤 앱에서나 사용할 수 있나요?

서버와 로그인 사용자가 있는 웹 앱이라면 사용할 수 있습니다. 서버가 각 사용자가 누구인지 DropComments에 알려 줍니다. 게임을 비롯해 캔버스에 그려지는 앱에서도 작동하며, 캔버스 화면은 이미지로 전달됩니다.

팀원이 댓글을 남기면 무엇이 전송되나요?

화면의 당시 모습이 이미지로 저장되며, data-dc-hide로 표시한 부분은 회색으로 가려집니다. 컴퓨터에서는 페이지 사본도 함께 저장됩니다(data-capture="picture"로 설정한 경우 제외). 사본에는 스타일과 이미지가 포함되고 스크립트는 제외됩니다. 입력란은 비워 두고 data-dc-hide로 표시한 부분은 빼며, 해당 지점의 이미지도 함께 저장합니다. Drop에는 이미지가 표시되고, 데스크톱에서는 페이지로 전환할 수 있습니다. 이미지는 스크립트가 페이지 레이아웃을 바탕으로 그리므로 원본과 비슷하지만 완전히 같지는 않습니다. 변형, 필터, ::before 또는 ::after 콘텐츠는 효과 없이 표시됩니다. 각 화면에는 캡처한 페이지의 주소(#fragment 제외), 제목, 창 크기와 브라우저 정보도 저장됩니다.

고객 피드백과 팀 피드백을 따로 관리할 수 있나요?

네. 앱에서 여러 프로젝트로 피드백을 보낼 수 있고, 서버가 사람마다 어느 프로젝트로 보낼지 지정합니다. 팀 피드백은 한 프로젝트에, 나머지 피드백은 다른 프로젝트에 모을 수 있습니다.

비용은 얼마인가요?

모든 요금제에서 사용할 수 있습니다. 무료 요금제에서는 피드백을 모으는 각 Drop이 하루 동안 댓글을 받고, 그 뒤에는 새 Drop이 시작됩니다. Pro에서는 계속 댓글을 받을 수 있습니다.

더 알아보기

다음 파일로 직접 써보세요

링크를 만드는 데 약 10초면 충분해요.

파일 놓기