DropComments

Feedback in je app

DropComments SDK

Ontvang feedback in de app die je bouwt met één scripttag, één endpoint op je server en een eigen feedbackknop. Je team plaatst een opmerking, een kader of een tekening op de app zelf, en de mensen die de app gebruiken sturen feedback via een kort formulier. Alles komt hier in je projecten terecht, waar jij en je AI-agent antwoorden.

Installeer de SDK

Gratis beginnen. De sleutel van je app blijft op je server.

Feedback over een app zou niet met een screenshot moeten beginnen

Als iemand bij het testen van je app iets vindt, maakt die een screenshot, snijdt het bij, plakt het in een chat en schrijft: ‘dat ding bovenaan, op het tweede scherm’. Jij zoekt dat scherm op en raadt welk ding er bedoeld wordt.

Met het script in de app wijzen ze het ter plekke aan. De opmerking komt binnen met een afbeelding van het scherm zoals het was, de plek gemarkeerd en de naam van de afzender. Zo kunnen jij of een programmeeragent ermee aan de slag, en verschijnt het antwoord in de app.

Zo werkt het

  1. 1

    Voeg je app toe

    In je account, onder Apps: de naam, de adressen waarop de app draait en de projecten waarin de feedback terechtkomt, bijvoorbeeld één voor je team en één voor je klanten. De app krijgt een sleutel.

  2. 2

    Voeg het script toe

    De server van je app bewaart de sleutel en geeft de pagina een kort geldig token voor de ingelogde persoon, met daarin of die bij je team hoort. De pagina laadt één scripttag en je eigen feedbackknop opent het paneel of formulier. Plak wat DropComments je laat zien in de chat met de agent die je app bouwt, en die voegt alles toe.

  3. 3

    Feedback komt binnen

    Je team drukt op Feedback, pint een opmerking op de juiste plek en schrijft; iedereen ziet alle pins en antwoorden live in de app. Alle anderen krijgen een kort formulier. Elke inzending komt als scherm van een Drop in het bijbehorende project terecht.

Installeer de SDK

Voor een webapp met een server en mensen die inloggen. Je hoeft geen pakket te installeren: een sleutel op je server, een endpoint dat de pagina een token geeft, een scripttag en een eigen knop om het paneel of formulier te openen.

  1. Voeg je app toe in DropComments, onder Apps: de naam, de adressen waarop de app draait (https, of http op localhost en .test tijdens het bouwen) en de projecten waarin de feedback terechtkomt. Je krijgt de sleutel van de app en het id van elk project.

    Voeg je app toe

  2. Bewaar de sleutel op je server, in de omgevingsvariabelen of secrets:

    DROPCOMMENTS_KEY=dc_app_…

    Nooit in een pagina, in code die de browser bereikt of in een commit. DropComments weigert de sleutel als die vanuit een browser wordt gebruikt.

  3. Voeg een tokenendpoint toe. Dit vraagt bij DropComments een token aan voor de ingelogde persoon en geeft de JSON ongewijzigd terug. Als niemand is ingelogd, geef je 401 terug en verschijnt er niets.

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

    Geschreven als een routehandler voor Next.js; in een Worker, Deno of Bun werkt het hetzelfde. Stuur in Express dezelfde status en JSON terug.

  4. Laad het script op elke pagina, vóór </body>:

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

    Het script toont zelf geen knop, dus je ziet nog niets.

  5. Voeg je eigen feedbackknop toe, verborgen totdat DropComments.ready aangeeft dat er een token is ontvangen. De knop opent het paneel voor je team en het korte formulier voor alle anderen:

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

    Zet de knop waar die in je app past: in de kop, een menu of een instellingenscherm. Het paneel, het formulier en de pins komen uit het script.

  6. Als je pagina’s een Content-Security-Policy meesturen, sta DropComments dan toe:

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

Of laat je programmeeragent het doen. Zodra je je app toevoegt, krijg je een instructie waarin je sleutel en project-id’s al zijn ingevuld. Plak die in de chat met de agent die je app bouwt, en die voegt het endpoint, het script en de knop toe.

Naslag

Het token

Je server roept POST https://dropcomments.com/api/app/token aan met de sleutel van de app als bearer-token. project is verplicht en bevat het id. user is de ingelogde persoon; laat je de naam weg, dan vraagt het paneel erom. team bepaalt welke tools die persoon krijgt. Een token is een uur geldig. Het script vraagt je endpoint om een nieuw token voordat het verloopt.

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

Scriptopties

data-token-url is je endpoint, dat wordt aangeroepen met de cookies van de pagina; het kan de JSON van het token teruggeven of het token als platte tekst. data-ui="none" toont helemaal niets, zodat je je eigen formulier kunt gebruiken: verstuur wat het verzamelt met DropComments.send(). Op een computer sturen opmerkingen van je team naast de afbeelding ook een kopie van de pagina mee. In de Drop toont de paginaknop die kopie, waarin je kunt scrollen en tekst kunt selecteren, en een agent kan de tekst lezen. data-capture="picture" verstuurt alleen de afbeelding. Telefoons en tablets doen dat altijd.

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

JavaScript

Alles is beschikbaar via window.DropComments zodra het script is geladen. ready geeft aan of er een token is ontvangen, zodat je je knop pas dan toont.

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

De vormgeving van je app

Je bepaalt zelf hoe je feedbackknop eruitziet. Stel deze variabelen in op :root, dan nemen het paneel, het formulier en de pins ze ook over. De overige variabelen: --dc-muted, --dc-line, --dc-soft, --dc-on-accent, --dc-accent-text, --dc-pin, --dc-on-pin en --dc-button-radius.

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

Gegevens privé houden

Een opmerking bevat een afbeelding van het scherm. Alles wat erop staat is dus zichtbaar, ook ingevoerde tekst (wachtwoorden als stippen). Markeer alles wat je app nooit mag verlaten: dat verschijnt als een grijs vlak in de afbeelding en wordt weggelaten uit de kopie van de pagina. De kopie bevat geen scripts en laat ingevulde velden leeg.

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

Wat je krijgt

Je team test een versie

Plaats een pin, kader of tekening op de draaiende app, op een computer of telefoon. Elke opmerking bevat een afbeelding van het scherm met de plek gemarkeerd, en vanaf een computer ook een kopie van de pagina. Zo is ‘hier werkt het niet’ genoeg.

De mensen die je app gebruiken

Een kort formulier met ‘Wijs het aan’ en een afbeelding van het scherm. Ze zien nooit de feedback van anderen, en hun afbeelding wordt alleen meegestuurd als ze het vinkje laten staan.

Bètatesters en klanten

Laat de mensen met wie je de app uitprobeert inloggen en bepaal wie bij het team hoort. Een klant die een stagingwebsite beoordeelt, laat er direct opmerkingen op achter.

Opgelost door een agent

Een programmeeragent die met DropComments is verbonden, leest elke opmerking en de pagina waarop die is geplaatst, voert de wijziging door en antwoordt. Het antwoord verschijnt in de app.

In de stijl van je app

Het formulier voor gebruikers neemt je kleuren, lettertype en hoekafronding over via een paar CSS-variabelen. Of gebruik je eigen formulier en verstuur de inhoud met één aanroep.

Je sleutel blijft van jou

De sleutel staat op je server, nooit in een pagina. Feedback wordt alleen geaccepteerd vanaf de adressen van je app, met een limiet per persoon, en elk project wordt gekozen op basis van het id.

Naar je Inbox

Elk stukje feedback komt als ticket binnen in de Inbox van het bijbehorende project, klaar om opgepakt te worden.

Vragen

Werkt het met elke app?

Elke webapp met een server en mensen die inloggen: de server vertelt DropComments wie elke persoon is. Games en andere apps die op een canvas worden getekend werken ook; het speelveld komt mee als afbeelding.

Wat wordt er meegestuurd met een opmerking van een teamlid?

Een afbeelding van het scherm zoals het was, waarbij alles wat je met data-dc-hide markeert grijs wordt weergegeven. Vanaf een computer wordt er ook een kopie van de pagina bij gezet (tenzij je data-capture="picture" instelt): met de stijlen en afbeeldingen erin en zonder scripts, met ingevulde velden leeggemaakt en alles wat met data-dc-hide is gemarkeerd weggelaten, plus een afbeelding van de plek. De Drop toont de afbeelding; op een computer kun je overschakelen naar de pagina. Het script tekent de afbeelding op basis van de pagina-indeling, dus die komt dichtbij maar is niet exact: transformaties, filters en inhoud van ::before of ::after worden zonder die opmaak weergegeven. Bij het scherm wordt ook bewaard waar het is gemaakt: het adres van de pagina (zonder het #fragment), de titel, de venstergrootte en de browser.

Kan ik feedback van klanten en het team gescheiden houden?

Ja. Een app kan feedback naar meerdere projecten sturen, en de server bepaalt per persoon naar welk project. Zo komt de feedback van het team in het ene project terecht en die van alle anderen in een ander.

Wat kost het?

Het zit in elk abonnement. Bij het gratis abonnement staat elke Drop met feedback één dag open voor reacties. Daarna begint er een nieuwe; met Pro blijven ze open.

Lees verder

Probeer het met je volgende bestand

In ongeveer tien seconden heb je een link.

Sleep een bestand hierheen