DropComments

Tilbakemeldinger i appen din

DropComments SDK

Ta imot tilbakemeldinger inne i appen du bygger, med én skripttagg, ett endepunkt på serveren din og din egen knapp for tilbakemeldinger. Teamet ditt fester en kommentar, en boks eller en tegning direkte på appen, og brukerne gir tilbakemeldinger i et kort skjema. Alt havner i prosjektene dine her, der du og KI-agenten din svarer.

Installer SDK-et

Gratis å komme i gang. Appens nøkkel blir på serveren din.

Tilbakemeldinger om en app bør ikke begynne med et skjermbilde

Når noen som tester appen din finner noe, tar de et skjermbilde, beskjærer det, limer det inn i en chat og skriver «den tingen øverst, på den andre skjermen». Du finner frem til skjermen og gjetter hvilken ting de mener.

Med skriptet i appen peker de på det der det er. Kommentaren kommer med et bilde av skjermen slik den var, med stedet markert og hvem som sendte den, klar til at du eller en kodeagent kan fikse det. Svaret vises i appen.

Slik fungerer det

  1. 1

    Legg til appen din

    Under Apper i kontoen din legger du inn navnet, adressene appen kjører på, og prosjektene tilbakemeldingene skal havne i, for eksempel ett for teamet og ett for kundene. Appen får en nøkkel.

  2. 2

    Legg til skriptet

    Appens server oppbevarer nøkkelen og gir siden et kortvarig token for den som er logget inn, med informasjon om personen er med i teamet. Siden laster én skripttagg, og din egen tilbakemeldingsknapp åpner panelet eller skjemaet. Lim inn det DropComments viser deg til agenten som bygger appen, så legger den til det som trengs.

  3. 3

    Tilbakemeldingene kommer inn

    Teamet trykker på Tilbakemelding, fester den på riktig sted og skriver. De ser alles markører i appen og alle svar i sanntid. Alle andre får et kort skjema. Hver tilbakemelding havner som en skjerm i en Drop i det tilhørende prosjektet.

Installer SDK-et

For en nettapp med en server og brukere som logger inn. Ingen pakke må installeres: en nøkkel på serveren din, et endepunkt som gir siden et token, en skripttagg og din egen knapp som åpner panelet eller skjemaet.

  1. Legg til appen din i DropComments under Apper: navnet, adressene den kjører på (https, eller http på localhost og .test under utvikling), og prosjektene tilbakemeldingene skal havne i. Du får appens nøkkel og ID-en til hvert prosjekt.

    Legg til appen din

  2. Oppbevar nøkkelen på serveren din, i miljøvariabler eller som en hemmelighet:

    DROPCOMMENTS_KEY=dc_app_…

    Aldri på en side, i kode som når nettleseren, eller i en commit. DropComments avviser nøkkelen hvis den sendes fra en nettleser.

  3. Legg til et token-endepunkt. Det ber DropComments om et token for den som er logget inn, og returnerer JSON-svaret uendret. Hvis ingen er logget inn, svarer det med 401, og ingenting vises.

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

    Skrevet som en rutehåndterer i Next.js; det fungerer på samme måte i en Worker, Deno eller Bun. I Express sender du tilbake samme status og JSON.

  4. Last skriptet på hver side, før </body>:

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

    Det viser ingen egen knapp, så foreløpig vises ingenting.

  5. Legg til din egen tilbakemeldingsknapp, skjult til DropComments.ready melder at et token er mottatt. Knappen åpner panelet for teamet ditt og det korte skjemaet for alle andre:

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

    Plasser den der den passer i appen: i toppfeltet, i en meny eller på en innstillingsside. Panelet, skjemaet og markørene kommer fra skriptet.

  6. Hvis sidene dine sender en Content-Security-Policy, må du tillate DropComments:

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

Eller la kodeagenten din gjøre det. Når du legger til appen, vises en oppgavebeskrivelse med nøkkelen og prosjekt-ID-ene ferdig utfylt. Lim den inn til agenten som bygger appen, så legger den til endepunktet, skriptet og knappen.

Referanse

Tokenet

Serveren din kaller POST https://dropcomments.com/api/app/token med appens nøkkel som bearer-token. project er påkrevd og angis med ID. user er den som er logget inn. Utelater du navnet, ber panelet om det. team avgjør hvilke verktøy personen får. Et token varer i én time, og skriptet ber endepunktet ditt om et nytt før det utløper.

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

Skriptinnstillinger

data-token-url er endepunktet ditt, som kalles med sidens informasjonskapsler. Det kan svare med tokenets JSON eller tokenet som ren tekst. data-ui="none" viser ingenting og lar deg bruke ditt eget skjema: send det skjemaet samler inn med DropComments.send(). Fra en datamaskin følger en kopi av siden med teamets kommentarer, i tillegg til bildet. I Drop viser sideknappen kopien, som kan rulles og har tekst som kan markeres, og en agent kan lese teksten. data-capture="picture" sender bare bildet. Telefoner og nettbrett sender alltid bare bildet.

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

JavaScript

Alt er tilgjengelig på window.DropComments når skriptet er lastet inn. ready angir om et token er mottatt, slik at du først viser knappen din da.

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

Appens utseende

Du bestemmer selv hvordan tilbakemeldingsknappen skal se ut. Angi disse på :root, så bruker panelet, skjemaet og markørene dem også. Resten: --dc-muted, --dc-line, --dc-soft, --dc-on-accent, --dc-accent-text, --dc-pin, --dc-on-pin og --dc-button-radius.

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

Hold innhold privat

En kommentar inneholder et bilde av skjermen og viser dermed det som er på den, også innskrevet tekst (passord vises som prikker). Marker alt som aldri må forlate appen din, så vises det som en grå boks i bildet og utelates fra kopien av siden. Kopien inneholder ingen skript og lar felt med innskrevet tekst stå tomme.

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

Dette får du

Teamet ditt tester en versjon

Fest en kommentar, marker med en boks eller tegn på appen mens den kjører, på en datamaskin eller telefon. Hver kommentar inneholder et bilde av skjermen med stedet markert, og fra en datamaskin følger også en kopi av siden med. Da holder det å si «det fungerer ikke her».

De som bruker appen

Et kort skjema med «Pek på det» og et bilde av skjermen. De ser aldri andres tilbakemeldinger, og bildet sendes bare hvis de lar avkryssingen stå.

Betatestere og kunder

La dem du prøver appen med logge inn, og bestem hvem som regnes som en del av teamet. En kunde som går gjennom et nettsted i et testmiljø, legger igjen kommentarer direkte på det.

Fikset av en agent

En kodeagent koblet til DropComments leser hver kommentar og siden den ble skrevet på, gjør endringen og svarer. Svaret vises i appen.

Med appens utseende

Skjemaet for brukerne henter farger, skrifttype og hjørner fra noen få CSS-variabler. Eller bruk ditt eget skjema og send innholdet med ett kall.

Nøkkelen din forblir din

Nøkkelen ligger på serveren din, aldri på en side. Tilbakemeldinger tas bare imot fra appens adresser, med en grense per person, og hvert prosjekt velges med sin ID.

Rett i innboksen din

Hver tilbakemelding kommer inn som en oppgave i prosjektets innboks, klar for at noen tar ansvaret.

Spørsmål

Fungerer det med alle apper?

Alle nettapper med en server og brukere som logger inn: serveren forteller DropComments hvem hver person er. Spill og andre apper som tegnes på et canvas, fungerer også. Flaten kommer med som et bilde.

Hva sendes med en kommentar fra teamet?

Et bilde av skjermen slik den var, med alt du merker med data-dc-hide, grået ut. Fra en datamaskin følger det også med en kopi av siden ved siden av bildet (med mindre du angir data-capture="picture"): med sidens stiler og bilder, uten skript, med utfylte felt tømt og alt merket med data-dc-hide utelatt, pluss et bilde av stedet. En Drop viser bildet, og på en datamaskin kan du bytte til siden. Bildet tegnes av skriptet ut fra sidens layout, så det er nokså likt, men ikke helt nøyaktig: transformasjoner, filtre og innhold i ::before eller ::after gjengis uten effekter. Skjermen lagrer også konteksten den ble laget i: sidens adresse (uten #fragment), sidetittelen, vindusstørrelsen og nettleseren.

Kan jeg holde kundenes og teamets tilbakemeldinger atskilt?

Ja. En app kan sende til flere prosjekter, og serveren angir hvilket prosjekt som skal brukes for hver person. Da havner teamets tilbakemeldinger i ett prosjekt og alle andres i et annet.

Hva koster det?

Det er inkludert i alle abonnementer. Med gratisabonnementet er hver Drop med tilbakemeldinger åpen i ett døgn, og deretter starter en ny. Pro holder dem åpne.

Les videre

Prøv det med din neste fil

Det tar omtrent ti sekunder å få en lenke.

Slipp en fil