DropComments

Feedback in deiner App

DropComments SDK

Sammle Feedback direkt in der App, die du entwickelst: mit einem Skript-Tag, einem Endpunkt auf deinem Server und einem eigenen Feedback-Button. Dein Team platziert Kommentare, Rahmen oder Zeichnungen direkt auf der App. Die Menschen, die sie nutzen, senden Feedback über ein kurzes Formular. Alles landet hier in deinen Projekten, wo du und dein KI-Agent antworten könnt.

SDK installieren

Kostenlos starten. Der Schlüssel deiner App bleibt auf deinem Server.

Feedback zu einer App sollte nicht mit einem Screenshot anfangen

Jemand entdeckt beim Testen deiner App etwas, macht einen Screenshot, schneidet ihn zu, fügt ihn in einen Chat ein und schreibt: „Das Ding ganz oben auf dem zweiten Bildschirm.“ Du suchst den Bildschirm und rätst, welches Ding gemeint ist.

Mit dem Skript in der App lässt sich die Stelle direkt markieren. Der Kommentar kommt mit einem Bild des Bildschirms zum Zeitpunkt des Kommentars, der markierten Stelle und der Angabe, von wem er stammt. So kannst du oder ein Coding-Agent das Problem beheben, und die Antwort erscheint in der App.

So funktioniert’s

  1. 1

    App hinzufügen

    In deinem Konto unter Apps: ihr Name, die Adressen, unter denen sie läuft, und die Projekte, in denen ihr Feedback landen soll – etwa eines für dein Team und eines für deine Kunden. Die App erhält einen Schlüssel.

  2. 2

    Skript einbinden

    Der Server deiner App verwahrt den Schlüssel und gibt der Seite ein kurzlebiges Token für die angemeldete Person, das auch angibt, ob sie zu deinem Team gehört. Die Seite lädt ein Skript-Tag, und dein eigener Feedback-Button öffnet die Oberfläche. Gib dem Agenten, der deine App entwickelt, die Angaben aus DropComments, und er fügt alles hinzu.

  3. 3

    Feedback kommt an

    Dein Team klickt auf Feedback, pinnt es an die passende Stelle und schreibt los. Alle sehen die Pins des gesamten Teams und jede Antwort live in der App. Alle anderen erhalten ein kurzes Formular. Jedes Feedback landet als Bildschirm eines Drops im zugehörigen Projekt.

SDK installieren

Für eine Web-App mit Server und angemeldeten Nutzern. Du musst kein Paket installieren: Ein Schlüssel auf deinem Server, ein Endpunkt, der der Seite ein Token gibt, ein Skript-Tag und ein eigener Button zum Öffnen reichen aus.

  1. Füge deine App hinzu, in DropComments unter Apps: ihren Namen, die Adressen, unter denen sie läuft (https oder während der Entwicklung http auf localhost und .test), und die Projekte, in denen ihr Feedback landen soll. Du erhältst den Schlüssel der App und die ID jedes Projekts.

    App hinzufügen

  2. Bewahre den Schlüssel auf deinem Server auf, in dessen Umgebungsvariablen oder Secrets:

    DROPCOMMENTS_KEY=dc_app_…

    Niemals in einer Seite, in Code, der im Browser ankommt, oder in einem Commit. DropComments lehnt den Schlüssel ab, wenn er aus einem Browser gesendet wird.

  3. Füge einen Token-Endpunkt hinzu. Er fordert für die angemeldete Person ein Token bei DropComments an und gibt dessen JSON unverändert zurück. Ist niemand angemeldet, antworte mit 401; dann wird nichts angezeigt.

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

    Als Next.js Route Handler geschrieben; in einem Worker, Deno oder Bun funktioniert es genauso. In Express gibst du denselben Status und dasselbe JSON zurück.

  4. Lade das Skript auf jeder Seite vor </body>:

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

    Es zeigt keinen eigenen Button an, daher ist zunächst noch nichts zu sehen.

  5. Füge deinen eigenen Feedback-Button hinzu. Blende ihn erst ein, wenn DropComments.ready meldet, dass ein Token angekommen ist. Er öffnet für dein Team das Panel und für alle anderen das kurze Formular:

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

    Platziere ihn dort, wo er in deine App passt: in der Kopfzeile, in einem Menü oder in den Einstellungen. Das Panel, das Formular und die Pins kommen vom Skript.

  6. Wenn deine Seiten eine Content-Security-Policy senden, erlaube DropComments:

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

Oder lass deinen Coding-Agenten das übernehmen. Wenn du deine App hinzufügst, erscheint eine Anleitung, in der dein Schlüssel und die Projekt-IDs bereits eingetragen sind. Gib sie dem Agenten, der deine App entwickelt, und er fügt den Endpunkt, das Skript und den Button hinzu.

Referenz

Das Token

Dein Server ruft POST https://dropcomments.com/api/app/token mit dem Schlüssel der App als Bearer-Token auf. project ist erforderlich und wird als ID angegeben. user ist die angemeldete Person. Lässt du den Namen weg, fragt das Panel danach. team bestimmt, welche Werkzeuge die Person erhält. Ein Token gilt eine Stunde, und das Skript fordert vor Ablauf bei deinem Endpunkt ein neues an.

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

Skript-Optionen

data-token-url ist dein Endpunkt und wird mit den Cookies der Seite aufgerufen. Er kann das JSON des Tokens oder das Token als Klartext zurückgeben. data-ui="none" zeigt gar nichts an, damit du dein eigenes Formular verwenden kannst: Sende dessen Eingaben mit DropComments.send(). Bei Kommentaren deines Teams vom Computer wird neben dem Bild auch eine Kopie der Seite mitgesendet. Im Drop zeigt der Seiten-Button diese Kopie an: scrollbar und mit auswählbarem Text, den ein Agent lesen kann. data-capture="picture" sendet nur das Bild. Auf Smartphones und Tablets wird immer nur das Bild gesendet.

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

JavaScript

Sobald das Skript geladen ist, steht alles unter window.DropComments bereit. ready gibt an, ob ein Token angekommen ist. Zeige deinen Button also erst dann an.

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

Das Aussehen deiner App

Deinen Feedback-Button gestaltest du selbst. Setze diese Variablen auf :root, dann übernehmen auch das Panel, das Formular und die Pins sie. Die weiteren Variablen: --dc-muted, --dc-line, --dc-soft, --dc-on-accent, --dc-accent-text, --dc-pin, --dc-on-pin und --dc-button-radius.

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

Vertrauliches schützen

Ein Kommentar enthält ein Bild des Bildschirms und zeigt damit alles, was darauf zu sehen ist – auch eingegebenen Text (Passwörter als Punkte). Markiere alles, was deine App niemals verlassen darf: Es erscheint im Bild als grauer Kasten und wird aus der Seitenkopie weggelassen. Die Kopie enthält keine Skripte und lässt Eingabefelder leer.

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

Das bekommst du

Dein Team beim Testen eines Builds

Setzt Pins, zieht Rahmen oder zeichnet direkt auf der laufenden App, am Computer oder Smartphone. Jeder Kommentar enthält ein Bild des Bildschirms mit der markierten Stelle und am Computer zusätzlich eine Kopie der Seite. So reicht „Hier funktioniert etwas nicht“.

Die Menschen, die deine App nutzen

Ein kurzes Formular mit „Stelle markieren“ und einem Bild des Bildschirms. Sie sehen niemals das Feedback anderer, und ihr Bild wird nur mitgesendet, wenn sie das Häkchen gesetzt lassen.

Betatester und Kunden

Lass die Menschen, mit denen du die App testest, sich anmelden, und entscheide, wer zum Team gehört. Kunden, die eine Staging-Website prüfen, hinterlassen ihre Anmerkungen direkt darauf.

Von einem Agenten behoben

Ein mit DropComments verbundener Coding-Agent liest jeden Kommentar und die Seite, auf der er hinterlassen wurde, nimmt die Änderung vor und antwortet. Die Antwort erscheint in der App.

Im Stil deiner App

Das Formular für deine Nutzer übernimmt über wenige CSS-Variablen deine Farben, Schrift und Eckenradien. Oder nutze dein eigenes Formular und sende die Eingaben mit einem einzigen Aufruf.

Dein Schlüssel bleibt bei dir

Der Schlüssel liegt auf deinem Server, niemals in einer Seite. Feedback wird nur von den Adressen deiner App angenommen, pro Person begrenzt und dem jeweils per ID ausgewählten Projekt zugeordnet.

Direkt in deinen Posteingang

Jede Rückmeldung landet als Ticket im Posteingang des zugehörigen Projekts und kann direkt übernommen werden.

Fragen

Funktioniert das mit jeder App?

Mit jeder Web-App, die einen Server und angemeldete Nutzer hat: Der Server teilt DropComments mit, wer die jeweilige Person ist. Spiele und andere Apps, die auf einem Canvas gezeichnet werden, funktionieren ebenfalls; die Zeichenfläche wird als Bild übertragen.

Was wird bei einem Kommentar aus dem Team mitgesendet?

Ein Bild des Bildschirms zum Zeitpunkt der Aufnahme, auf dem alles ausgegraut ist, was du mit data-dc-hide markierst. Am Computer kommt eine Kopie der Seite dazu (außer du setzt data-capture="picture"): mit eingebetteten Stilen und Bildern, ohne Skripte, mit leeren Eingabefeldern und ohne alles, was mit data-dc-hide markiert ist. Dazu kommt ein Bild der betreffenden Stelle. Der Drop zeigt das Bild; am Desktop lässt sich zur Seite wechseln. Das Skript zeichnet das Bild anhand des Seitenlayouts, deshalb ist es ähnlich, aber nicht exakt: Transformationen, Filter und Inhalte von ::before oder ::after werden vereinfacht dargestellt. Zum Screen wird außerdem gespeichert, wo er aufgenommen wurde: die Seitenadresse (ohne ihr #fragment), der Seitentitel, die Fenstergröße und der Browser.

Kann ich Feedback von Kunden und vom Team getrennt halten?

Ja. Eine App kann Feedback an mehrere Projekte senden. Ihr Server legt für jede Person fest, in welches Projekt es kommt. So landet das Feedback des Teams in einem Projekt und das aller anderen in einem anderen.

Was kostet das?

Die Funktion ist in jedem Tarif enthalten. Im kostenlosen Tarif ist jeder Feedback-Drop einen Tag lang für Kommentare offen, danach beginnt ein neuer. Mit Pro bleiben sie offen.

Weiterlesen

Probier’s mit deiner nächsten Datei

In etwa zehn Sekunden hast du einen Link.

Datei ablegen