DropComments

Feedback sa loob ng app mo

DropComments SDK

Tumanggap ng feedback sa loob ng app na ginagawa mo gamit ang isang script tag, isang endpoint sa server mo at sarili mong button na Feedback. Makakapag-pin ang team mo ng komento, kahon o guhit sa app mismo, at makakapagpadala naman ng feedback ang mga gumagamit nito sa maikling form. Mapupunta ang lahat sa mga project mo rito, kung saan kayo ng AI agent mo makakasagot.

I-install ang SDK

Libreng magsimula. Mananatili sa server mo ang key ng app mo.

Hindi dapat kailangang magsimula sa screenshot ang feedback tungkol sa app

Kapag may napansin ang isang taong sumusubok ng app mo, kukuha siya ng screenshot, ika-crop ito, ipapaste sa chat at isusulat ang “iyong nasa itaas, sa pangalawang screen”. Hahanapin mo pa ang screen na iyon, at huhulaan kung alin ang tinutukoy.

Kapag nasa app ang script, ituturo na lang niya ang mismong bahagi. Darating ang komento kasama ang larawan ng screen noong oras na iyon, may marka sa tinukoy na bahagi at pangalan ng nagpadala, para maayos mo o ng coding agent. Lalabas naman sa app ang sagot.

Paano ito gumagana

  1. 1

    Idagdag ang app mo

    Sa account mo, sa ilalim ng Apps: ilagay ang pangalan nito, ang mga address kung saan ito tumatakbo, at ang mga project na pupuntahan ng feedback nito, halimbawa, isa para sa team mo at isa para sa mga customer mo. Bibigyan ito ng key.

  2. 2

    Idagdag ang script

    Itatago ng server nito ang key at bibigyan ang page ng token na may maikling bisa para sa sinumang naka-sign in, na nagsasaad kung kasama siya sa team mo. Maglo-load ang page ng isang script tag, at bubuksan ito ng sarili mong button na Feedback. I-paste sa agent na gumagawa ng app mo ang ipinapakita ng DropComments, at idaragdag niya ang mga ito.

  3. 3

    Papasok ang feedback

    Pipindutin ng team mo ang Feedback, magpi-pin sa mismong bahagi at magsusulat; makikita nila sa app ang mga pin ng lahat at bawat sagot, habang dumarating ang mga ito. Maikling form naman ang makikita ng iba. Bawat feedback ay mapupunta sa project nito bilang screen ng isang Drop.

I-install ang SDK

Para sa web app na may server at mga taong nag-sign in. Walang package na kailangang i-install: isang key sa server mo, isang endpoint na nagbibigay ng token sa page, isang script tag, at sarili mong button na magbubukas nito.

  1. Idagdag ang app mo sa DropComments, sa ilalim ng Apps: ang pangalan nito, ang mga address kung saan ito tumatakbo (https, o http sa localhost at .test habang ginagawa), at ang mga project na pupuntahan ng feedback nito. Makukuha mo ang key nito at ang id ng bawat project.

    Idagdag ang app mo

  2. Itago ang key sa server mo, sa environment o secrets nito:

    DROPCOMMENTS_KEY=dc_app_…

    Huwag kailanman sa page, sa code na nakakarating sa browser, o sa commit. Tinatanggihan ito ng DropComments kapag galing sa browser.

  3. Magdagdag ng token endpoint. Para sa sinumang naka-sign in, hihingi ito ng token sa DropComments at ibabalik ang JSON nito nang walang pagbabago. Kapag walang naka-sign in, ibalik ang 401 at walang lalabas.

    // 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"}});
    }

    Nakasulat bilang Next.js route handler; ganoon din sa Worker, Deno o Bun. Sa Express, ibalik ang parehong status at JSON.

  4. I-load ang script sa bawat page, bago ang </body>:

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

    Wala itong sariling button, kaya wala pang lalabas.

  5. Idagdag ang sarili mong button na Feedback, na nakatago hanggang sabihin ng DropComments.ready na may dumating na token. Bubuksan nito ang panel para sa team mo at ang maikling form para sa iba:

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

    Ilagay ito kung saan babagay sa app mo: sa header, menu o screen ng mga setting. Galing sa script ang panel, form at mga pin.

  6. Kung nagpapadala ang mga page mo ng Content-Security-Policy, payagan ang DropComments:

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

O ipagawa ito sa coding agent mo. Kapag idinagdag mo ang app mo, may lalabas na maikling gabay na may key at mga project id mo na; i-paste ito sa agent na gumagawa ng app mo at idaragdag niya ang endpoint, script at button.

Sanggunian

Ang token

Tatawag ang server mo sa POST https://dropcomments.com/api/app/token gamit ang key ng app bilang bearer token. Kailangan ang project, gamit ang id nito. Ang user ay ang sinumang naka-sign in; kapag hindi isinama ang pangalan, hihingi nito ang panel. Ang team ang magtatakda kung aling mga tool ang magagamit nila. Isang oras ang bisa ng token, at hihingi ang script ng bago sa endpoint mo bago ito mawalan ng bisa.

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

Mga opsyon sa script

Ang data-token-url ang endpoint mo, na kinukuha gamit ang cookies ng page; puwede nitong ibalik ang JSON ng token o ang token bilang plain text. Walang anumang ipinapakita ang data-ui="none", para sa sarili mong form: ipadala ang nakolekta nito gamit ang DropComments.send(). Kapag mula sa computer, may kasamang kopya ng page bukod sa larawan ang mga komento ng team: sa Drop, ipinapakita ito ng button ng page, na puwedeng i-scroll at may text na puwedeng piliin, at nababasa ng agent ang mga salita nito. Larawan lang ang ipinapadala ng data-capture="picture". Larawan lang palagi ang ipinapadala ng mga phone at tablet.

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

JavaScript

Nasa window.DropComments ang lahat kapag na-load na ang script. Sinasabi ng ready kung may dumating na token, kaya saka mo lang ipapakita ang button mo.

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

Ang hitsura ng app mo

Ikaw ang bahalang magdisenyo ng button mong Feedback. Itakda ang mga ito sa :root at gagamitin din ng panel, form at mga pin. Ang iba pa: --dc-muted, --dc-line, --dc-soft, --dc-on-accent, --dc-accent-text, --dc-pin, --dc-on-pin at --dc-button-radius.

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

Pagpapanatiling pribado ng impormasyon

May kasamang larawan ng screen ang komento, kaya makikita rito ang anumang nasa screen, pati ang na-type na text (mga tuldok ang mga password). Markahan ang anumang hindi dapat lumabas sa app mo at magiging abong kahon ito sa larawan, at hindi isasama sa kopya ng page. Walang script ang kopya at blangko ang mga field na may na-type.

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

Ano ang makukuha mo

Ang team mo, sumusubok ng build

Mag-pin, magkahon o gumuhit sa app habang tumatakbo ito, sa computer o phone. Bawat komento ay may kasamang larawan ng screen na may marka sa tinukoy na bahagi, at kapag mula sa computer, may kopya rin ng page, kaya sapat na ang “may sira rito”.

Ang mga gumagamit nito

Isang maikling form na may Ituro ito at larawan ng screen. Hindi nila makikita ang feedback ng iba, at maipapadala lang ang larawan nila kung hahayaan nilang naka-check ito.

Mga beta tester at kliyente

Pa-sign in ang mga taong kasama mong sumusubok nito at piliin kung sino ang kabilang sa team. Makakapag-iwan ng mga tala mismo sa staging site ang kliyenteng nagsusuri nito.

Inaayos ng agent

Binabasa ng coding agent na nakakonekta sa DropComments ang bawat komento at ang page kung saan ito ginawa, ginagawa ang pagbabago, at sumasagot. Lalabas sa app ang sagot.

Bagay sa hitsura ng app mo

Gagamitin ng form para sa mga gumagamit ang mga kulay, font at hugis ng mga sulok mo mula sa ilang CSS variable, o gamitin ang sarili mong form at ipadala ito sa isang tawag lang.

Sa iyo lang ang key mo

Nasa server mo ang key, hindi kailanman sa page. Tumatanggap lang ng feedback mula sa mga address ng app mo, may limitasyon bawat tao, at pinipili ang bawat project gamit ang id nito.

Diretso sa iyong Inbox

Bawat feedback ay dumarating bilang isang ticket sa Inbox ng proyekto nito, na handa nang akuin.

Mga tanong

Gumagana ba ito sa anumang app?

Sa anumang web app na may server at mga taong nag-sign in: sinasabi ng server sa DropComments kung sino ang bawat tao. Gumagana rin ang mga laro at iba pang app na iginuguhit sa canvas; ipinapadala ang board bilang larawan.

Ano ang ipinapadala ng komento ng team?

Larawan ng screen kung ano ang hitsura nito noon, na naka-gray ang anumang minarkahan mong data-dc-hide. Kapag mula sa computer, may kopya rin ng page sa tabi nito (maliban kung itinakda mo ang data-capture="picture"): kasama ang mga style at larawan nito pero walang mga script, blangko ang mga field na may na-type, at hindi kasama ang anumang minarkahang data-dc-hide, pati na ang larawan ng mismong bahagi. Larawan ang ipinapakita ng Drop, at sa desktop, puwedeng lumipat sa page. Binubuo ng script ang larawan mula sa layout ng page, kaya malapit ito sa orihinal pero hindi eksakto: payak ang labas ng mga transform, filter at nilalaman ng ::before o ::after. Naka-save rin sa screen nito kung saan ito ginawa: ang address ng page (walang #fragment nito), pamagat nito, laki ng window at browser.

Puwede ko bang paghiwalayin ang feedback ng mga customer at ng team?

Oo. Puwedeng magpadala ang isang app sa ilang project, at ang server nito ang nagsasabi kung saan mapupunta ang feedback ng bawat tao, kaya sa isang project mapupunta ang sa team at sa isa pa ang sa lahat ng iba.

Magkano ito?

Kasama ito sa lahat ng plan. Sa libreng plan, bukas nang isang araw para sa mga komento ang bawat Drop ng feedback, at may bagong magsisimula pagkatapos; sa Pro, mananatiling bukas ang mga ito.

Magbasa pa

Subukan sa susunod mong file

Mga sampung segundo lang para makakuha ng link.

Mag-drop ng file