DropComments

あなたのアプリ内でフィードバック

DropComments SDK

スクリプトタグ1つ、サーバーのエンドポイント1つ、独自のフィードバックボタンで、開発中のアプリ内から意見を受け取れます。チームはアプリ上に直接コメントをピン留めしたり、枠や手描きの印を付けたりできます。ユーザーは簡単なフォームから送信。すべてがDropCommentsのプロジェクトに届き、あなたやAIエージェントが返信できます。

SDKをインストール

無料で始められます。アプリのキーはサーバー上で保管します。

アプリへのフィードバックを、スクリーンショットから始める必要はありません

アプリをテストしている人が何かを見つけると、スクリーンショットを撮り、切り抜き、チャットに貼って「2つ目の画面の上のほうにあるやつ」と書きます。あなたはその画面を探し、どれのことか見当を付けます。

アプリにスクリプトを入れておけば、その場所を直接指し示せます。コメントには、その時点の画面の画像、印を付けた場所、送信者が添えられるので、あなたやコーディングエージェントがすぐに修正に取りかかれます。返信はアプリ内に表示されます。

使い方

  1. 1

    アプリを登録

    アカウントの「アプリ」で、アプリ名、稼働するアドレス、フィードバックの送信先プロジェクトを登録します。たとえば、チーム用と顧客用に1つずつ選べます。登録するとキーが発行されます。

  2. 2

    スクリプトを追加

    アプリのサーバーがキーを保管し、ログイン中の人がチームの一員かどうかを示す有効期間の短いトークンをページに渡します。ページはスクリプトタグを1つ読み込み、独自のフィードバックボタンから開きます。DropCommentsに表示される内容を、アプリを開発しているエージェントに貼り付ければ、必要なものを追加してくれます。

  3. 3

    フィードバックが届く

    チームはフィードバックボタンを押し、その場所にピンを留めてコメントを書きます。アプリ上で全員のピンとすべての返信をリアルタイムで確認できます。それ以外の人には簡単なフォームが表示されます。それぞれのフィードバックは、送信先プロジェクトのDrop内の画面として届きます。

SDKをインストール

サーバーがあり、ユーザーがログインするWebアプリ向けです。パッケージのインストールは不要。サーバーで保管するキー、ページにトークンを渡すエンドポイント、スクリプトタグ、それを開く独自のボタンで導入できます。

  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で使えるツールが決まります。トークンの有効期間は1時間で、期限が切れる前にスクリプトがエンドポイントへ新しいトークンをリクエストします。

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

スクリプトのオプション

data-token-urlは作成したエンドポイントで、ページのCookie付きでリクエストされます。トークンの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変数でアプリの色、フォント、角の丸みに合わせられます。独自のフォームを使い、1回の呼び出しで送信することもできます。

キーは手元で保管

キーはサーバーで保管し、ページには一切含めません。フィードバックはアプリのアドレスからのみ受け付け、1人ごとに送信制限を設け、送信先の各プロジェクトはIDで指定します。

受信トレイに届く

フィードバックは一つひとつ、そのプロジェクトの受信トレイにチケットとして届き、担当を引き受けられる状態になります。

よくある質問

どんなアプリでも使えますか?

サーバーがあり、ユーザーがログインするWebアプリなら使えます。サーバーが各ユーザーの情報をDropCommentsに伝えます。ゲームなど、canvas上に描画するアプリでも使えます。盤面は画像として送られます。

チームのコメントでは何が送信されますか?

その時点の画面の画像です。data-dc-hide を指定した部分はグレーで隠されます。パソコンからの場合は、ページのコピーも添えられます(data-capture="picture" を設定した場合を除きます)。コピーにはスタイルと画像が含まれ、スクリプトは含まれません。入力欄は空になり、data-dc-hide を指定した部分は除外されます。該当箇所の画像も付いています。Drop には画像が表示され、パソコンではページ表示に切り替えられます。画像はスクリプトがページのレイアウトから描画するため、元の画面に近いものの、完全には一致しません。変形、フィルター、::before や ::after のコンテンツは装飾なしで描画されます。また、各画面には作成時の情報として、ページのアドレス(#fragment を除く)、タイトル、ウィンドウサイズ、ブラウザーが保存されます。

お客様とチームのフィードバックを分けられますか?

はい。アプリから複数のプロジェクトに送信でき、誰のフィードバックをどこに送るかはアプリのサーバーで指定します。チームのものを1つのプロジェクトに、それ以外を別のプロジェクトにまとめられます。

料金はいくらですか?

すべてのプランで利用できます。無料プランでは、フィードバックの各 Drop は1日間コメントを受け付け、その後は新しい Drop が始まります。Pro では引き続きコメントを受け付けられます。

さらに詳しく

次のファイルで試してみませんか

約10秒でリンクを作れます。

ファイルをドロップ