Feedback nella tua app
DropComments SDK
Raccogli feedback dentro l’app che stai creando con un tag script, un endpoint sul tuo server e un tuo pulsante Feedback. Il team aggiunge un commento, un riquadro o un disegno direttamente sull’app, mentre chi la usa invia feedback con un breve modulo. Tutto arriva nei tuoi progetti qui, dove tu e il tuo agente AI potete rispondere.
Installa l’SDKInizia gratis. La chiave della tua app resta sul tuo server.
Il feedback su un’app non dovrebbe iniziare da uno screenshot
Quando chi prova la tua app trova qualcosa, fa uno screenshot, lo ritaglia, lo incolla in chat e scrive «quella cosa in alto, nella seconda schermata». Tu cerchi la schermata e provi a indovinare di cosa si tratta.
Con lo script nell’app, basta indicare il punto esatto. Il commento arriva con un’immagine della schermata com’era in quel momento, il punto segnato e il nome di chi l’ha inviato: tutto pronto perché tu o un agente di programmazione possiate intervenire. La risposta compare nell’app.
Come funziona
- 1
Aggiungi la tua app
Nel tuo account, nella sezione App: il nome, gli indirizzi su cui è disponibile e i progetti in cui far arrivare i feedback, per esempio uno per il team e uno per i clienti. L’app riceve una chiave.
- 2
Aggiungi lo script
Il server dell’app conserva la chiave e fornisce alla pagina un token di breve durata per chi ha effettuato l’accesso, specificando se fa parte del team. La pagina carica un tag script e il tuo pulsante Feedback ne apre l’interfaccia. Incolla ciò che ti mostra DropComments all’agente che sta creando la tua app: aggiungerà tutto lui.
- 3
Arrivano i feedback
I membri del team premono Feedback, segnano il punto e scrivono; vedono tutti i segnaposto sull’app e ogni risposta, in tempo reale. Tutti gli altri vedono un breve modulo. Ogni feedback arriva come schermata di un Drop nel suo progetto.
Installa l’SDK
Per un’app web con un server e utenti che effettuano l’accesso. Nessun pacchetto da installare: una chiave sul tuo server, un endpoint che fornisce un token alla pagina, un tag script e un tuo pulsante che ne apre l’interfaccia.
Aggiungi la tua app in DropComments, nella sezione App: il nome, gli indirizzi su cui è disponibile (https, oppure http su localhost e .test durante lo sviluppo) e i progetti in cui far arrivare i feedback. Ricevi la chiave dell’app e l’id di ogni progetto.
Conserva la chiave sul tuo server, nelle variabili d’ambiente o nei segreti:
DROPCOMMENTS_KEY=dc_app_…
Mai in una pagina, nel codice che arriva al browser o in un commit. DropComments la rifiuta se proviene da un browser.
Aggiungi un endpoint per i token. Per chi ha effettuato l’accesso, richiede un token a DropComments e ne restituisce il JSON così com’è. Se nessuno ha effettuato l’accesso, rispondi con 401 e non viene mostrato nulla.
// 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"}}); }Scritto come route handler di Next.js; funziona allo stesso modo in un Worker, Deno o Bun. In Express, restituisci lo stesso stato e lo stesso JSON.
Carica lo script in ogni pagina, prima di
</body>:<script src="https://dropcomments.com/live.js" data-token-url="/api/feedback-token"></script>
Non aggiunge un proprio pulsante, quindi per ora non compare nulla.
Aggiungi un tuo pulsante Feedback, nascosto finché
DropComments.readynon segnala l’arrivo di un token, che apra il pannello per il team e il breve modulo per tutti gli altri:<button id="feedback" hidden>Feedback</button> const button = document.getElementById("feedback"); if (await DropComments.ready) { button.hidden = false; button.addEventListener("click", () => DropComments.open()); }Mettilo dove si adatta alla tua app: nell’intestazione, in un menu, nella schermata delle impostazioni. Il pannello, il modulo e i segnaposto sono forniti dallo script.
Se le tue pagine inviano una Content-Security-Policy, consenti DropComments:
script-src https://dropcomments.com; connect-src https://dropcomments.com wss://dropcomments.com;
Oppure lascia fare al tuo agente di programmazione. Quando aggiungi l’app, compare un riepilogo con la chiave e gli id dei progetti già inseriti; incollalo all’agente che sta creando la tua app e aggiungerà l’endpoint, lo script e il pulsante.
Documentazione di riferimento
Il token
Il tuo server chiama POST https://dropcomments.com/api/app/token usando la chiave dell’app come token bearer. project è obbligatorio e va indicato tramite id. user è la persona che ha effettuato l’accesso; se ometti il nome, il pannello ne chiede uno. team determina quali strumenti avrà a disposizione. Un token dura un’ora e lo script ne richiede uno nuovo al tuo endpoint prima della scadenza.
{
"project": "YOUR_PROJECT_ID",
"user": {"id": "u_123", "name": "Sam Lee"},
"team": true
}
// → {"token": "dct.…", "expiresAt": …, "team": true, "project": {…}}Opzioni dello script
data-token-url è il tuo endpoint, chiamato con i cookie della pagina; può restituire il JSON del token o il token come testo semplice. data-ui="none" non mostra nulla, per consentirti di usare un tuo modulo: invia ciò che raccoglie con DropComments.send(). Da computer, i commenti del team includono una copia della pagina oltre all’immagine: nel Drop, il pulsante della pagina la mostra, con scorrimento e testo selezionabile, e un agente può leggerne le parole. data-capture="picture" invia solo l’immagine. Telefoni e tablet inviano sempre solo l’immagine.
<script src="https://dropcomments.com/live.js" data-token-url="/api/feedback-token" data-capture="picture"></script>
JavaScript
Tutto è disponibile su window.DropComments una volta caricato lo script. ready segnala se è arrivato un token, così mostri il pulsante solo a quel punto.
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 nullLo stile della tua app
Puoi personalizzare lo stile del tuo pulsante Feedback. Imposta queste variabili su :root e anche il pannello, il modulo e i segnaposto le useranno. Le altre: --dc-muted, --dc-line, --dc-soft, --dc-on-accent, --dc-accent-text, --dc-pin, --dc-on-pin e --dc-button-radius.
:root {
--dc-font: "Inter", sans-serif;
--dc-surface: #ffffff;
--dc-text: #111827;
--dc-accent: #4f46e5;
--dc-radius: 12px;
}Proteggere i dati privati
Un commento include un’immagine della schermata, quindi mostra ciò che contiene, anche il testo digitato (le password appaiono come puntini). Contrassegna tutto ciò che non deve mai uscire dalla tua app: nell’immagine diventa un riquadro grigio e viene escluso dalla copia della pagina. La copia non contiene script e lascia vuoti i campi compilati.
<div data-dc-hide> Card ending 4242 </div>
Cosa ottieni
Il tuo team prova una build
Aggiungi segnaposto, riquadri o disegni sull’app mentre è in funzione, da computer o telefono. Ogni commento include un’immagine della schermata con il punto segnato e, da computer, anche una copia della pagina: così basta dire «qui non funziona».
Le persone che la usano
Un breve modulo con Indica il punto e un’immagine della schermata. Non vedono mai i feedback altrui e l’immagine viene inviata solo se lasciano selezionata la relativa casella.
Beta tester e clienti
Fai accedere le persone con cui stai provando l’app e decidi chi fa parte del team. Un cliente che revisiona un sito di staging lascia note direttamente sul sito.
Un agente si occupa delle correzioni
Un agente di programmazione collegato a DropComments legge ogni commento e la pagina su cui è stato lasciato, apporta la modifica e risponde. La risposta compare nell’app.
Con lo stile della tua app
Il modulo per gli utenti riprende colori, font e angoli della tua app da poche variabili CSS. Oppure usa un tuo modulo e invia i dati con una sola chiamata.
La tua chiave resta tua
La chiave resta sul tuo server, mai in una pagina. I feedback vengono accettati solo dagli indirizzi della tua app, con un limite per persona e ogni progetto selezionato tramite il suo id.
Nella tua Posta in arrivo
Ogni feedback arriva come ticket nella Posta in arrivo del suo progetto, pronto perché qualcuno se ne occupi.
Domande
Funziona con qualsiasi app?
Con qualsiasi app web che abbia un server e utenti che effettuano l’accesso: il server comunica a DropComments chi è ogni persona. Funziona anche con giochi e altre app disegnate su un canvas; l’area di gioco viene inviata come immagine.
Cosa invia un commento del team?
Un’immagine della schermata così com’era, con tutto ciò che contrassegni con data-dc-hide oscurato in grigio. Da computer, anche una copia della pagina accanto all’immagine (a meno che tu non imposti data-capture="picture"): con stili e immagini inclusi e senza script, con i campi compilati lasciati vuoti e gli elementi contrassegnati con data-dc-hide esclusi, più un’immagine del punto. Il Drop mostra l’immagine e da computer si può passare alla pagina. Lo script ricrea l’immagine a partire dal layout della pagina, quindi è simile ma non identica: trasformazioni, filtri e contenuti ::before o ::after vengono resi senza effetti. La schermata conserva anche il contesto in cui è stata creata: l’indirizzo della pagina (senza il #fragment), il titolo, le dimensioni della finestra e il browser.
Posso tenere separati i feedback dei clienti da quelli del team?
Sì. Un’app può inviare feedback a più progetti e il suo server indica quale usare per ogni persona, così quelli del team finiscono in un progetto e quelli di tutti gli altri in un altro.
Quanto costa?
È incluso in tutti i piani. Con il piano gratuito, ogni Drop di feedback resta aperto per un giorno, poi ne inizia uno nuovo; Pro li mantiene aperti.
Continua a leggere
Provalo con il tuo prossimo file
Bastano circa dieci secondi per ottenere un link.
Trascina un file