DropComments

Feedback în aplicația ta

DropComments SDK

Primește feedback în aplicația pe care o construiești cu o singură etichetă script, un endpoint pe serverul tău și propriul buton de feedback. Echipa fixează un comentariu, un chenar sau un desen direct pe aplicație, iar cei care o folosesc trimit feedback printr-un formular scurt. Totul ajunge în proiectele tale de aici, unde tu și agentul tău AI puteți răspunde.

Instalează SDK-ul

Poți începe gratuit. Cheia aplicației tale rămâne pe serverul tău.

Feedbackul despre o aplicație n-ar trebui să înceapă cu o captură de ecran

Când cineva care îți testează aplicația găsește o problemă, face o captură de ecran, o decupează, o lipește într-un chat și scrie „chestia de sus, de pe al doilea ecran”. Tu cauți ecranul și încerci să ghicești despre ce e vorba.

Cu scriptul în aplicație, persoana indică problema chiar acolo unde se află. Comentariul vine cu o imagine a ecranului așa cum era atunci, cu locul marcat și cu numele expeditorului, gata de rezolvat de tine sau de un agent de programare, iar răspunsul apare în aplicație.

Cum funcționează

  1. 1

    Adaugă aplicația

    În contul tău, la Aplicații: numele ei, adresele la care rulează și proiectele în care ajunge feedbackul, de exemplu unul pentru echipă și unul pentru clienți. Aplicația primește o cheie.

  2. 2

    Adaugă scriptul

    Serverul aplicației păstrează cheia și îi dă paginii un token de scurtă durată pentru persoana autentificată, precizând dacă face parte din echipa ta. Pagina încarcă o singură etichetă script, iar propriul buton de feedback deschide interfața. Copiază ce îți arată DropComments și trimite-i agentului care îți construiește aplicația; el adaugă tot ce trebuie.

  3. 3

    Începi să primești feedback

    Membrii echipei apasă pe Feedback, marchează locul și scriu; văd marcajele tuturor pe aplicație și fiecare răspuns, în timp real. Toți ceilalți primesc un formular scurt. Fiecare feedback ajunge ca ecran al unui Drop în proiectul său.

Instalează SDK-ul

Pentru o aplicație web cu server și utilizatori care se autentifică. Nu ai niciun pachet de instalat: o cheie pe serverul tău, un endpoint care îi dă paginii un token, o etichetă script și propriul buton care deschide interfața.

  1. Adaugă aplicația în DropComments, la Aplicații: numele ei, adresele la care rulează (https sau http pe localhost și .test în timpul dezvoltării) și proiectele în care ajunge feedbackul. Primești cheia aplicației și ID-ul fiecărui proiect.

    Adaugă aplicația

  2. Păstrează cheia pe serverul tău, în variabilele de mediu sau în secretele acestuia:

    DROPCOMMENTS_KEY=dc_app_…

    Niciodată într-o pagină, în cod care ajunge în browser sau într-un commit. DropComments o refuză dacă este trimisă dintr-un browser.

  3. Adaugă un endpoint pentru tokenuri. Pentru persoana autentificată, acesta cere un token de la DropComments și returnează răspunsul JSON ca atare. Dacă nu este nimeni autentificat, răspunde cu 401 și nu se afișează nimic.

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

    Scris ca handler de rută Next.js; funcționează la fel într-un Worker, Deno sau Bun. În Express, returnează același cod de stare și același JSON.

  4. Încarcă scriptul în fiecare pagină, înainte de </body>:

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

    Nu afișează un buton propriu, așa că deocamdată nu apare nimic.

  5. Adaugă propriul buton de feedback, ascuns până când DropComments.ready indică primirea unui token, care deschide panoul pentru echipă și formularul scurt pentru toți ceilalți:

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

    Pune-l unde se potrivește în aplicația ta: într-un antet, într-un meniu sau pe un ecran de setări. Scriptul furnizează panoul, formularul și marcajele.

  6. Dacă paginile tale trimit un antet Content-Security-Policy, permite DropComments:

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

Sau lasă agentul tău de programare să se ocupe. Când adaugi aplicația, apare un set de instrucțiuni cu cheia și ID-urile proiectelor deja completate; copiază-l și trimite-l agentului care îți construiește aplicația, iar el adaugă endpointul, scriptul și butonul.

Documentație de referință

Tokenul

Serverul tău apelează POST https://dropcomments.com/api/app/token folosind cheia aplicației ca token bearer. project este obligatoriu și se specifică prin ID. user este persoana autentificată; dacă omiți numele, panoul îl va cere. team stabilește ce instrumente primește. Un token este valabil o oră, iar scriptul cere unul nou de la endpointul tău înainte să expire.

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

Opțiunile scriptului

data-token-url este endpointul tău, apelat cu cookie-urile paginii; poate returna răspunsul JSON al tokenului sau tokenul ca text simplu. data-ui="none" nu afișează nimic, ca să poți folosi propriul formular: trimite ce colectează prin DropComments.send(). De pe computer, comentariile echipei includ și o copie a paginii, pe lângă imagine: în Drop, butonul paginii o afișează, cu derulare și text selectabil, iar un agent îi citește conținutul. data-capture="picture" trimite doar imaginea. Telefoanele și tabletele trimit întotdeauna doar imaginea.

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

JavaScript

Totul este disponibil pe window.DropComments după încărcarea scriptului. ready indică dacă a fost primit un token, ca să afișezi butonul doar atunci.

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

Aspectul aplicației tale

Tu alegi stilul butonului de feedback. Setează aceste variabile pe :root, iar panoul, formularul și marcajele le vor prelua și ele. Celelalte: --dc-muted, --dc-line, --dc-soft, --dc-on-accent, --dc-accent-text, --dc-pin, --dc-on-pin și --dc-button-radius.

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

Protejarea datelor private

Un comentariu include o imagine a ecranului, deci arată ce se află pe el, inclusiv textul introdus (parolele apar ca puncte). Marchează orice element care nu trebuie să părăsească niciodată aplicația: va apărea ca un dreptunghi gri în imagine și va fi exclus din copia paginii. Copia nu conține scripturi și lasă câmpurile de introducere necompletate.

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

Ce primești

Echipa ta, testând o versiune

Fixează un comentariu, trasează un chenar sau desenează pe aplicație în timp ce rulează, de pe computer sau telefon. Fiecare comentariu include o imagine a ecranului cu locul marcat, iar de pe computer și o copie a paginii, așa că e suficient să spui „aici nu merge”.

Cei care o folosesc

Un formular scurt cu opțiunea „Indică locul” și o imagine a ecranului. Nu văd niciodată feedbackul altora, iar imaginea lor este trimisă doar dacă lasă opțiunea bifată.

Testeri beta și clienți

Oferă-le acces prin autentificare celor cu care testezi aplicația și decide cine face parte din echipă. Un client care verifică un site de test lasă observații direct pe el.

Rezolvat de un agent

Un agent de programare conectat la DropComments citește fiecare comentariu și pagina pe care a fost lăsat, face modificarea și răspunde. Răspunsul apare în aplicație.

Cu aspectul aplicației tale

Formularul pentru utilizatori preia culorile, fontul și rotunjirea colțurilor din câteva variabile CSS, sau poți folosi propriul formular și trimite datele printr-un singur apel.

Cheia ta rămâne la tine

Cheia rămâne pe serverul tău, niciodată într-o pagină. Feedbackul este acceptat doar de la adresele aplicației tale, cu limite pentru fiecare persoană, iar fiecare proiect este ales prin ID.

Direct în Căsuța de intrare

Fiecare observație ajunge ca tichet în Căsuța de intrare a proiectului său, gata să fie preluată de cineva.

Întrebări

Funcționează cu orice aplicație?

Cu orice aplicație web care are un server și utilizatori care se autentifică: serverul îi spune lui DropComments cine este fiecare persoană. Funcționează și cu jocuri și alte aplicații desenate pe un canvas; suprafața desenată este transmisă ca imagine.

Ce trimite un comentariu al echipei?

O imagine a ecranului așa cum era, cu tot ce marchezi cu data-dc-hide acoperit cu gri. De pe un computer, se salvează alături și o copie a paginii (dacă nu setezi data-capture="picture"): cu stilurile și imaginile incluse, fără scripturi, cu câmpurile completate lăsate goale și fără elementele marcate cu data-dc-hide, plus o imagine a locului respectiv. Drop-ul afișează imaginea, iar pe computer poți comuta la pagină. Imaginea este desenată de script pe baza aranjării elementelor în pagină, deci este apropiată de original, dar nu identică: transformările, filtrele și conținutul ::before sau ::after apar fără efectele respective. Ecranul păstrează și contextul în care a fost creat: adresa paginii (fără #fragment), titlul ei, dimensiunea ferestrei și browserul.

Pot separa feedbackul clienților de cel al echipei?

Da. O aplicație poate trimite feedback în mai multe proiecte, iar serverul ei stabilește proiectul pentru fiecare persoană, astfel încât feedbackul echipei ajunge într-unul, iar al tuturor celorlalți în altul.

Cât costă?

Funcția este inclusă în toate planurile. În planul gratuit, fiecare Drop cu feedback rămâne deschis o zi, după care începe unul nou; Pro le păstrează deschise.

Citește mai departe

Încearcă-l cu următorul tău fișier

Durează cam zece secunde să obții un link.

Încarcă un fișier