Feedback inde i din app
DropComments SDK
Modtag feedback i den app, du bygger, med ét script-tag, ét endpoint på din server og din egen Feedback-knap. Dit team fastgør en kommentar, en boks eller en tegning direkte i appen, og brugerne sender feedback via en kort formular. Det hele lander i dine projekter her, hvor du og din AI-agent svarer.
Installér SDK'etGratis at komme i gang. Din apps nøgle bliver på din server.
Feedback om en app bør ikke starte med et skærmbillede
Når en person, der tester din app, finder noget, tager de et skærmbillede, beskærer det, indsætter det i en chat og skriver »den ting øverst på den anden skærm«. Du finder skærmen og gætter på, hvilken ting de mener.
Med scriptet i appen peger de på det, dér hvor det er. Kommentaren kommer med et billede af skærmen, som den så ud, stedet markeret og oplysninger om, hvem der sendte den. Så er du eller en kodeagent klar til at rette det, og svaret vises i appen.
Sådan fungerer det
- 1
Tilføj din app
På din konto under Apps: dens navn, de adresser, den kører på, og de projekter, dens feedback skal ind i, for eksempel ét til dit team og ét til dine kunder. Den får en nøgle.
- 2
Tilføj scriptet
Appens server opbevarer nøglen og giver siden et kortlivet token til den person, der er logget ind, med angivelse af, om personen er på dit team. Siden indlæser ét script-tag, og din egen Feedback-knap åbner det. Kopiér det, DropComments viser dig, ind til agenten, der bygger din app, så tilføjer den det hele.
- 3
Feedback kommer ind
Dit team trykker på Feedback, fastgør en kommentar på stedet og skriver; de ser alles markører i appen og alle svar live. Alle andre får en kort formular. Hver tilbagemelding lander som en skærm i et Drop i det tilhørende projekt.
Installér SDK'et
Til en webapp med en server og brugere, der logger ind. Der er ingen pakke at installere: en nøgle på din server, et endpoint, der giver siden et token, et script-tag og din egen knap, der åbner det.
Tilføj din app i DropComments under Apps: dens navn, de adresser, den kører på (https eller http på localhost og .test under udvikling), og de projekter, dens feedback skal ind i. Du får dens nøgle og hvert projekts id.
Opbevar nøglen på din server, i dens miljøvariabler eller secrets:
DROPCOMMENTS_KEY=dc_app_…
Aldrig på en side, i kode, der når browseren, eller i et commit. DropComments afviser den fra en browser.
Tilføj et token-endpoint. Det beder DropComments om et token til den person, der er logget ind, og returnerer dets JSON uændret. Hvis ingen er logget ind, skal det svare med 401, så vises der 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"}}); }Skrevet som en Next.js route handler; det fungerer på samme måde i en Worker, Deno eller Bun. I Express skal du returnere samme status og JSON.
Indlæs scriptet på hver side før
</body>:<script src="https://dropcomments.com/live.js" data-token-url="/api/feedback-token"></script>
Det viser ikke sin egen knap, så der vises ingenting endnu.
Tilføj din egen Feedback-knap, skjult indtil
DropComments.readyangiver, at der er modtaget et token. Den åbner panelet for dit team og den korte formular 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()); }Placér den, hvor den passer i din app: i en sideheader, en menu eller en indstillingsskærm. Panelet, formularen og markørerne kommer fra scriptet.
Hvis dine sider sender en Content-Security-Policy, skal du tillade DropComments:
script-src https://dropcomments.com; connect-src https://dropcomments.com wss://dropcomments.com;
Eller lad din kodeagent gøre det. Når du tilføjer din app, vises en vejledning, hvor din nøgle og dine projekt-id'er allerede er indsat. Kopiér den ind til agenten, der bygger din app, så tilføjer den endpointet, scriptet og knappen.
Reference
Tokenet
Din server kalder POST https://dropcomments.com/api/app/token med appens nøgle som bearer-token. project er påkrævet og angives med id. user er den person, der er logget ind; udelad navnet, så beder panelet om et. team afgør, hvilke værktøjer personen får. Et token gælder i en time, og scriptet beder dit endpoint om et nyt, før det udløber.
{
"project": "YOUR_PROJECT_ID",
"user": {"id": "u_123", "name": "Sam Lee"},
"team": true
}
// → {"token": "dct.…", "expiresAt": …, "team": true, "project": {…}}Scriptindstillinger
data-token-url er dit endpoint, som kaldes med sidens cookies; det kan svare med tokenets JSON eller tokenet som ren tekst. data-ui="none" viser slet ingenting og er til din egen formular: send det, den indsamler, med DropComments.send(). Fra en computer indeholder teamets kommentarer både billedet og en kopi af siden: I Droppet viser sideknappen kopien, som kan rulles, og hvor teksten kan markeres, og en agent kan læse teksten. data-capture="picture" sender kun billedet. Det gør telefoner og tablets altid.
<script src="https://dropcomments.com/live.js" data-token-url="/api/feedback-token" data-capture="picture"></script>
JavaScript
Alt findes på window.DropComments, når scriptet er indlæst. ready angiver, om der er modtaget et token, så du først viser din knap derefter.
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 nullDin apps udseende
Du bestemmer selv, hvordan din Feedback-knap skal se ud. Angiv disse på :root, så bruger panelet, formularen og markørerne 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 oplysninger private
En kommentar indeholder et billede af skærmen, så det viser det, der er på den, også indtastet tekst (adgangskoder som prikker). Markér alt, der aldrig må forlade din app, så bliver det til en grå boks på billedet og udelades fra kopien af siden. Kopien indeholder ingen scripts og lader felter med indtastet tekst være tomme.
<div data-dc-hide> Card ending 4242 </div>
Det får du
Dit team tester en version
Fastgør kommentarer, tegn bokse eller tegn frit i appen, mens den kører, på en computer eller telefon. Hver kommentar indeholder et billede af skærmen med stedet markeret og fra en computer også en kopi af siden, så »det virker ikke her« er nok.
Dem, der bruger den
En kort formular med Peg på det og et billede af skærmen. De ser aldrig andres feedback, og deres billede bliver kun sendt, hvis de lader afkrydsningen stå.
Betatestere og kunder
Lad dem, du afprøver appen med, logge ind, og vælg, hvem der tæller som en del af teamet. En kunde, der gennemgår et testsite, skriver noter direkte på det.
Rettet af en agent
En kodeagent, der er forbundet til DropComments, læser hver kommentar og den side, den blev skrevet på, foretager ændringen og svarer. Svaret vises i appen.
Med din apps udseende
Brugernes formular får dine farver, din skrifttype og dine hjørner fra nogle få CSS-variabler, eller du kan bruge din egen formular og sende indholdet med ét kald.
Din nøgle forbliver din
Nøglen ligger på din server, aldrig på en side. Feedback modtages kun fra din apps adresser, med en grænse pr. person, og hvert projekt vælges ud fra sit id.
Direkte i din indbakke
Hvert stykke feedback lander som en opgave i projektets indbakke, klar til at nogen tager den.
Spørgsmål
Virker det med alle apps?
Alle webapps med en server og brugere, der logger ind: Serveren fortæller DropComments, hvem hver person er. Spil og andre apps, der tegnes på et canvas, virker også; lærredet kommer med som et billede.
Hvad sender en kommentar fra teamet med?
Et billede af skærmen, som den så ud, med alt, du markerer med data-dc-hide, gråtonet. Fra en computer følger der også en kopi af siden med (medmindre du indstiller data-capture="picture"): med sidens typografi og billeder indlejret og uden scripts, med indtastningsfelter tømt og alt markeret med data-dc-hide udeladt, samt et billede af stedet. Dit Drop viser billedet, og på en computer kan man skifte til siden. Billedet tegnes af scriptet ud fra sidens layout, så det ligner, men er ikke helt præcist: transformationer, filtre og indhold fra ::before eller ::after gengives uden effekter. Skærmen gemmer også oplysninger om, hvor den blev lavet: sidens adresse (uden dens #fragment), dens titel, vinduets størrelse og browseren.
Kan jeg holde kundernes og teamets feedback adskilt?
Ja. En app kan sende til flere projekter, og dens server angiver projektet for hver person, så teamets feedback havner i ét projekt og alle andres i et andet.
Hvad koster det?
Det er med i alle abonnementer. På det gratis abonnement er hvert Drop med feedback åbent i et døgn, hvorefter et nyt starter; Pro holder dem åbne.
Læs videre
Prøv det med din næste fil
Det tager cirka ti sekunder at få et link.
Slip en fil