DropComments

Feedback i din app

DropComments SDK

Ta emot feedback i appen du bygger med en skripttagg, en endpoint på din server och en egen feedbackknapp. Ditt team fäster en kommentar, en ruta eller en teckning direkt i appen, och de som använder den ger feedback via ett kort formulär. Allt hamnar i dina projekt här, där du och din AI-agent svarar.

Installera SDK:t

Gratis att komma igång. Appens nyckel stannar på din server.

Feedback om en app borde inte börja med en skärmbild

När någon som testar din app hittar något tar de en skärmbild, beskär den, klistrar in den i en chatt och skriver ”det där högst upp, på den andra skärmen”. Du letar upp skärmen och gissar vad de menar.

Med skriptet i appen pekar de direkt på det. Kommentaren kommer med en bild av skärmen som den såg ut, platsen markerad och uppgift om vem som skickade den. Då kan du eller en kodagent ta itu med det, och svaret visas i appen.

Så fungerar det

  1. 1

    Lägg till din app

    Under Appar i ditt konto anger du appens namn, adresserna den körs på och projekten där dess feedback ska hamna, till exempel ett för teamet och ett för kunderna. Appen får en nyckel.

  2. 2

    Lägg till skriptet

    Appens server behåller nyckeln och ger sidan en kortlivad token för den som är inloggad, med uppgift om personen tillhör ditt team. Sidan läser in en skripttagg, och din egen feedbackknapp öppnar verktyget. Klistra in det DropComments visar dig till agenten som bygger din app, så lägger den till allt.

  3. 3

    Feedback kommer in

    Ditt team trycker på Feedback, fäster en markör på rätt plats och skriver. De ser allas markörer i appen och varje svar i realtid. Alla andra får ett kort formulär. Varje inskickad feedback blir en skärm i en Drop i sitt projekt.

Installera SDK:t

För en webbapp med en server och användare som loggar in. Inget paket behöver installeras: en nyckel på din server, en endpoint som ger sidan en token, en skripttagg och en egen knapp som öppnar verktyget.

  1. Lägg till din app i DropComments under Appar: dess namn, adresserna den körs på (https, eller http på localhost och .test under utvecklingen) och projekten där dess feedback ska hamna. Du får appens nyckel och varje projekts id.

    Lägg till din app

  2. Förvara nyckeln på din server, i dess miljövariabler eller hemligheter:

    DROPCOMMENTS_KEY=dc_app_…

    Aldrig på en sida, i kod som når webbläsaren eller i en commit. DropComments avvisar den om den skickas från en webbläsare.

  3. Lägg till en token-endpoint. Den begär en token från DropComments för den som är inloggad och returnerar dess JSON oförändrad. Om ingen är inloggad ska den svara med 401, så visas ingenting.

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

    Skriven som en route handler i Next.js; det fungerar likadant i en Worker, Deno eller Bun. I Express skickar du tillbaka samma status och JSON.

  4. Läs in skriptet på varje sida, före </body>:

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

    Det visar ingen egen knapp, så inget syns ännu.

  5. Lägg till en egen feedbackknapp, dold tills DropComments.ready anger att en token har kommit. Den öppnar panelen för ditt team och det korta formuläret för alla andra:

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

    Placera den där den passar i din app: i sidhuvudet, i en meny eller på en inställningssida. Skriptet står för panelen, formuläret och markörerna.

  6. Om dina sidor skickar en Content-Security-Policy, tillåt DropComments:

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

Eller låt din kodagent göra det. När du lägger till din app visas instruktioner med din nyckel och dina projekt-id redan ifyllda. Klistra in dem till agenten som bygger din app, så lägger den till endpointen, skriptet och knappen.

Referens

Token

Din server anropar POST https://dropcomments.com/api/app/token med appens nyckel som bearer-token. project är obligatoriskt och anges med id. user är den som är inloggad; utelämnar du namnet ber panelen om ett. team avgör vilka verktyg personen får. En token gäller i en timme, och skriptet begär en ny från din endpoint innan den löper ut.

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

Skriptinställningar

data-token-url är din endpoint, som anropas med sidans kakor. Den kan svara med tokens JSON eller med token som ren text. data-ui="none" visar ingenting alls och är till för ditt eget formulär: skicka det som samlas in med DropComments.send(). Från en dator skickas en kopia av sidan tillsammans med bilden när teamet kommenterar. Sidknappen i en Drop visar kopian, som går att skrolla och har markerbar text, och en agent kan läsa texten. data-capture="picture" skickar bara bilden. På telefoner och surfplattor skickas alltid bara bilden.

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

JavaScript

Allt finns på window.DropComments när skriptet har lästs in. ready anger om en token har kommit, så att du visar knappen först då.

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

Din apps utseende

Du bestämmer själv hur din feedbackknapp ska se ut. Ange dessa på :root så använder även panelen, formuläret och markörerna dem. De övriga: --dc-muted, --dc-line, --dc-soft, --dc-on-accent, --dc-accent-text, --dc-pin, --dc-on-pin och --dc-button-radius.

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

Håll uppgifter privata

En kommentar innehåller en bild av skärmen, så det som finns på skärmen syns, även inskriven text (lösenord visas som punkter). Markera allt som aldrig får lämna din app, så visas det som en grå ruta i bilden och utelämnas ur sidkopian. Kopian innehåller inga skript och lämnar ifyllda fält tomma.

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

Det här får du

Ditt team testar en version

Fäst en markör, rita en ruta eller rita fritt direkt i appen medan den körs, på en dator eller telefon. Varje kommentar innehåller en bild av skärmen med platsen markerad, och från en dator även en kopia av sidan, så ”det fungerar inte här” räcker.

De som använder appen

Ett kort formulär med Peka på det och en bild av skärmen. De ser aldrig någon annans feedback, och bilden skickas bara om de låter rutan vara ikryssad.

Betatestare och kunder

Låt dem du testar appen med logga in och bestäm vilka som räknas till teamet. En kund som granskar en testversion av webbplatsen lämnar kommentarer direkt på den.

Åtgärdat av en agent

En kodagent som är ansluten till DropComments läser varje kommentar och sidan där den skrevs, gör ändringen och svarar. Svaret visas i appen.

Med din apps utseende

Formuläret för användarna får dina färger, ditt typsnitt och din hörnform via några CSS-variabler. Eller använd ett eget formulär och skicka innehållet med ett enda anrop.

Din nyckel förblir din

Nyckeln finns på din server, aldrig på en sida. Feedback tas bara emot från din apps adresser, begränsas per person och kopplas till ett projekt som väljs med dess id.

Direkt till din inkorg

All feedback kommer in som ärenden i projektets inkorg, redo för någon att ta hand om.

Frågor

Fungerar det med alla appar?

Alla webbappar med en server och användare som loggar in: servern talar om för DropComments vem varje person är. Spel och andra appar som ritas på en canvas fungerar också; spelytan skickas som en bild.

Vad skickas med när någon i teamet kommenterar?

En bild av skärmen som den såg ut, där allt du markerat med data-dc-hide är gråmarkerat. Från en dator följer också en kopia av sidan med (om du inte anger data-capture="picture"): med stilar och bilder inkluderade men utan skript, med inmatningsfält tömda och allt som markerats med data-dc-hide borttaget, plus en bild av platsen. Drop visar bilden, och på en dator går det att växla till sidan. Bilden ritas av skriptet utifrån sidans layout, så den är snarlik men inte exakt: transformeringar, filter och innehåll i ::before eller ::after återges utan specialeffekter. Skärmen sparar också var den skapades: sidans adress (utan dess #fragment), dess titel, fönstrets storlek och webbläsaren.

Kan jag hålla kundernas och teamets feedback åtskilda?

Ja. En app kan skicka till flera projekt, och dess server anger vilket som gäller för varje person, så att teamets feedback hamnar i ett projekt och alla andras i ett annat.

Vad kostar det?

Det ingår i alla abonnemang. I gratisabonnemanget är varje Drop med feedback öppen i ett dygn, och sedan påbörjas en ny. Med Pro hålls de öppna.

Läs vidare

Prova med din nästa fil

Det tar ungefär tio sekunder att få en länk.

Släpp en fil