Σχόλια μέσα στην εφαρμογή σας
DropComments SDK
Συλλέξτε σχόλια μέσα στην εφαρμογή που φτιάχνετε, με μία ετικέτα script, ένα endpoint στον διακομιστή σας και ένα δικό σας κουμπί «Σχόλια». Η ομάδα σας καρφιτσώνει σχόλια, πλαίσια ή σχέδια πάνω στην ίδια την εφαρμογή, ενώ όσοι τη χρησιμοποιούν στέλνουν σχόλια από μια σύντομη φόρμα. Όλα καταλήγουν στα έργα σας εδώ, όπου απαντάτε εσείς και ο πράκτορας AI σας.
Εγκαταστήστε το SDKΞεκινήστε δωρεάν. Το κλειδί της εφαρμογής σας μένει στον διακομιστή σας.
Τα σχόλια για μια εφαρμογή δεν θα έπρεπε να ξεκινούν με στιγμιότυπο οθόνης
Όταν κάποιος δοκιμάζει την εφαρμογή σας και εντοπίζει κάτι, βγάζει ένα στιγμιότυπο οθόνης, το περικόπτει, το επικολλά σε μια συνομιλία και γράφει «αυτό πάνω πάνω, στη δεύτερη οθόνη». Εσείς βρίσκετε εκείνη την οθόνη και μαντεύετε τι εννοεί.
Με το script μέσα στην εφαρμογή, υποδεικνύει το σημείο επιτόπου. Το σχόλιο φτάνει με μια εικόνα της οθόνης όπως ήταν, το σημείο σημειωμένο και το όνομα του αποστολέα, έτοιμο για να κάνετε τη διόρθωση εσείς ή ένας πράκτορας προγραμματισμού. Η απάντηση εμφανίζεται μέσα στην εφαρμογή.
Πώς λειτουργεί
- 1
Προσθέστε την εφαρμογή σας
Στον λογαριασμό σας, στην ενότητα «Εφαρμογές»: το όνομά της, τις διευθύνσεις στις οποίες λειτουργεί και τα έργα στα οποία θα πηγαίνουν τα σχόλιά της, για παράδειγμα ένα για την ομάδα σας και ένα για τους πελάτες σας. Η εφαρμογή αποκτά ένα κλειδί.
- 2
Προσθέστε το script
Ο διακομιστής της κρατά το κλειδί και δίνει στη σελίδα ένα token μικρής διάρκειας για τον συνδεδεμένο χρήστη, δηλώνοντας αν ανήκει στην ομάδα σας. Η σελίδα φορτώνει μία ετικέτα script και το δικό σας κουμπί «Σχόλια» ανοίγει το εργαλείο. Επικολλήστε όσα σας δείχνει το DropComments στον πράκτορα που φτιάχνει την εφαρμογή σας και θα τα προσθέσει.
- 3
Τα σχόλια αρχίζουν να φτάνουν
Τα μέλη της ομάδας σας πατούν «Σχόλια», καρφιτσώνουν στο σημείο και γράφουν· βλέπουν τις καρφίτσες όλων πάνω στην εφαρμογή και κάθε απάντηση, ζωντανά. Οι υπόλοιποι βλέπουν μια σύντομη φόρμα. Κάθε υποβολή καταλήγει ως οθόνη ενός Drop στο αντίστοιχο έργο.
Εγκαταστήστε το SDK
Για διαδικτυακές εφαρμογές με διακομιστή και χρήστες που συνδέονται. Δεν υπάρχει πακέτο για εγκατάσταση: ένα κλειδί στον διακομιστή σας, ένα endpoint που δίνει στη σελίδα ένα token, μια ετικέτα script και ένα δικό σας κουμπί που ανοίγει το εργαλείο.
Προσθέστε την εφαρμογή σας στο DropComments, στην ενότητα «Εφαρμογές»: το όνομά της, τις διευθύνσεις στις οποίες λειτουργεί (https ή http σε localhost και .test κατά την ανάπτυξη) και τα έργα στα οποία θα πηγαίνουν τα σχόλιά της. Παίρνετε το κλειδί της και το αναγνωριστικό κάθε έργου.
Κρατήστε το κλειδί στον διακομιστή σας, στις μεταβλητές περιβάλλοντος ή στα secrets του:
DROPCOMMENTS_KEY=dc_app_…
Ποτέ σε σελίδα, σε κώδικα που φτάνει στο πρόγραμμα περιήγησης ή σε commit. Το DropComments το απορρίπτει αν σταλεί από πρόγραμμα περιήγησης.
Προσθέστε ένα endpoint για token. Ζητά από το DropComments ένα token για τον συνδεδεμένο χρήστη και επιστρέφει το JSON του αυτούσιο. Αν δεν έχει συνδεθεί κανείς, επιστρέψτε 401 και δεν εμφανίζεται τίποτα.
// 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"}}); }Είναι γραμμένο ως route handler του Next.js· η λογική είναι ίδια σε Worker, Deno ή Bun. Στο Express, επιστρέψτε τον ίδιο κωδικό κατάστασης και το ίδιο JSON.
Φορτώστε το script σε κάθε σελίδα, πριν από το
</body>:<script src="https://dropcomments.com/live.js" data-token-url="/api/feedback-token"></script>
Δεν εμφανίζει δικό του κουμπί, οπότε προς το παρόν δεν φαίνεται τίποτα.
Προσθέστε το δικό σας κουμπί «Σχόλια», κρυφό μέχρι το
DropComments.readyνα δηλώσει ότι ελήφθη token. Το κουμπί ανοίγει το πλαίσιο για την ομάδα σας και τη σύντομη φόρμα για όλους τους άλλους:<button id="feedback" hidden>Feedback</button> const button = document.getElementById("feedback"); if (await DropComments.ready) { button.hidden = false; button.addEventListener("click", () => DropComments.open()); }Βάλτε το όπου ταιριάζει στην εφαρμογή σας: στην κεφαλίδα, σε ένα μενού, σε μια οθόνη ρυθμίσεων. Το πλαίσιο, η φόρμα και οι καρφίτσες παρέχονται από το script.
Αν οι σελίδες σας στέλνουν Content-Security-Policy, επιτρέψτε το DropComments:
script-src https://dropcomments.com; connect-src https://dropcomments.com wss://dropcomments.com;
Ή αφήστε τον πράκτορα προγραμματισμού σας να το κάνει. Μόλις προσθέσετε την εφαρμογή σας, εμφανίζονται συνοπτικές οδηγίες με το κλειδί και τα αναγνωριστικά των έργων σας ήδη συμπληρωμένα· επικολλήστε τις στον πράκτορα που φτιάχνει την εφαρμογή σας και θα προσθέσει το endpoint, το script και το κουμπί.
Τεκμηρίωση αναφοράς
Το token
Ο διακομιστής σας καλεί το POST https://dropcomments.com/api/app/token με το κλειδί της εφαρμογής ως bearer token. Το project είναι υποχρεωτικό και δίνεται με το αναγνωριστικό του. Το user είναι ο συνδεδεμένος χρήστης· αν παραλείψετε το όνομα, το πλαίσιο θα ζητήσει ένα. Το team καθορίζει ποια εργαλεία θα έχει στη διάθεσή του. Το token ισχύει για μία ώρα και το script ζητά νέο από το endpoint σας πριν λήξει.
{
"project": "YOUR_PROJECT_ID",
"user": {"id": "u_123", "name": "Sam Lee"},
"team": true
}
// → {"token": "dct.…", "expiresAt": …, "team": true, "project": {…}}Επιλογές του script
Το data-token-url είναι το endpoint σας, στο οποίο γίνεται αίτημα με τα cookies της σελίδας· μπορεί να επιστρέφει το JSON του token ή το token ως απλό κείμενο. Το data-ui="none" δεν εμφανίζει τίποτα, ώστε να χρησιμοποιήσετε δική σας φόρμα: στείλτε όσα συλλέγει με το DropComments.send(). Από υπολογιστή, τα σχόλια της ομάδας συνοδεύονται από ένα αντίγραφο της σελίδας μαζί με την εικόνα: μέσα στο Drop, το κουμπί της σελίδας το εμφανίζει με δυνατότητα κύλισης και επιλογής κειμένου, και ένας πράκτορας μπορεί να διαβάσει το κείμενό του. Το data-capture="picture" στέλνει μόνο την εικόνα. Τα κινητά και τα tablet στέλνουν πάντα μόνο την εικόνα.
<script src="https://dropcomments.com/live.js" data-token-url="/api/feedback-token" data-capture="picture"></script>
JavaScript
Όλα είναι διαθέσιμα στο window.DropComments μόλις φορτωθεί το script. Το ready δηλώνει αν ελήφθη token, ώστε να εμφανίζετε το κουμπί σας μόνο τότε.
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Η εμφάνιση της εφαρμογής σας
Δίνετε στο κουμπί «Σχόλια» το στυλ που θέλετε. Ορίστε αυτές τις μεταβλητές στο :root και θα τις υιοθετήσουν και το πλαίσιο, η φόρμα και οι καρφίτσες. Οι υπόλοιπες: --dc-muted, --dc-line, --dc-soft, --dc-on-accent, --dc-accent-text, --dc-pin, --dc-on-pin και --dc-button-radius.
:root {
--dc-font: "Inter", sans-serif;
--dc-surface: #ffffff;
--dc-text: #111827;
--dc-accent: #4f46e5;
--dc-radius: 12px;
}Προστασία ιδιωτικών στοιχείων
Ένα σχόλιο συνοδεύεται από εικόνα της οθόνης, οπότε φαίνεται ό,τι υπάρχει πάνω της, μαζί με το πληκτρολογημένο κείμενο (οι κωδικοί πρόσβασης εμφανίζονται ως τελείες). Επισημάνετε ό,τι δεν πρέπει ποτέ να φύγει από την εφαρμογή σας: στην εικόνα θα εμφανιστεί ως γκρίζο πλαίσιο και θα παραλειφθεί από το αντίγραφο της σελίδας. Το αντίγραφο δεν περιέχει scripts και αφήνει κενά τα πεδία στα οποία έχει πληκτρολογηθεί κείμενο.
<div data-dc-hide> Card ending 4242 </div>
Τι σας προσφέρει
Η ομάδα σας δοκιμάζει μια έκδοση
Καρφιτσώστε, βάλτε πλαίσιο ή σχεδιάστε πάνω στην εφαρμογή καθώς λειτουργεί, από υπολογιστή ή κινητό. Κάθε σχόλιο συνοδεύεται από εικόνα της οθόνης με το σημείο σημειωμένο και, από υπολογιστή, από αντίγραφο της σελίδας, οπότε αρκεί ένα «εδώ δεν λειτουργεί».
Όσοι τη χρησιμοποιούν
Μια σύντομη φόρμα με την επιλογή «Υποδείξτε το σημείο» και μια εικόνα της οθόνης. Δεν βλέπουν ποτέ τα σχόλια άλλων και η εικόνα τους στέλνεται μόνο αν αφήσουν επιλεγμένο το αντίστοιχο πλαίσιο.
Δοκιμαστές beta και πελάτες
Δώστε δυνατότητα σύνδεσης σε όσους δοκιμάζουν την εφαρμογή μαζί σας και αποφασίστε ποιοι θεωρούνται μέλη της ομάδας. Ένας πελάτης που ελέγχει έναν ιστότοπο σε περιβάλλον δοκιμών αφήνει σημειώσεις απευθείας πάνω του.
Διόρθωση από πράκτορα
Ένας πράκτορας προγραμματισμού συνδεδεμένος στο DropComments διαβάζει κάθε σχόλιο και τη σελίδα στην οποία έγινε, κάνει την αλλαγή και απαντά. Η απάντηση εμφανίζεται μέσα στην εφαρμογή.
Με την εμφάνιση της εφαρμογής σας
Η φόρμα των χρηστών υιοθετεί τα χρώματα, τη γραμματοσειρά και τις γωνίες σας από λίγες μεταβλητές CSS. Εναλλακτικά, χρησιμοποιήστε δική σας φόρμα και στείλτε τα στοιχεία της με μία κλήση.
Το κλειδί σας μένει σε εσάς
Το κλειδί παραμένει στον διακομιστή σας, ποτέ σε σελίδα. Τα σχόλια γίνονται δεκτά μόνο από τις διευθύνσεις της εφαρμογής σας, με όριο ανά άτομο, και κάθε έργο επιλέγεται με το αναγνωριστικό του.
Στα Εισερχόμενά σου
Κάθε σχόλιο φτάνει ως αίτημα στα Εισερχόμενα του έργου του, έτοιμο να το αναλάβει κάποιος.
Ερωτήσεις
Λειτουργεί με οποιαδήποτε εφαρμογή;
Με οποιαδήποτε διαδικτυακή εφαρμογή διαθέτει διακομιστή και χρήστες που συνδέονται: ο διακομιστής ενημερώνει το DropComments για το ποιος είναι κάθε χρήστης. Λειτουργούν επίσης παιχνίδια και άλλες εφαρμογές που σχεδιάζονται σε canvas· η επιφάνειά τους μεταφέρεται ως εικόνα.
Τι στέλνει ένα σχόλιο μέλους της ομάδας;
Μια εικόνα της οθόνης όπως ήταν, με ό,τι έχετε επισημάνει με data-dc-hide καλυμμένο με γκρι. Από υπολογιστή, αποθηκεύεται δίπλα της και ένα αντίγραφο της σελίδας (εκτός αν ορίσετε data-capture="picture"): με ενσωματωμένα τα στιλ και τις εικόνες της, χωρίς script, με κενά τα πεδία όπου πληκτρολογήθηκε κείμενο και χωρίς ό,τι έχει επισημανθεί με data-dc-hide, μαζί με μια εικόνα του σημείου. Το Drop εμφανίζει την εικόνα, ενώ σε υπολογιστή μπορείτε να μεταβείτε στην προβολή της σελίδας. Το script δημιουργεί την εικόνα από τη διάταξη της σελίδας, οπότε είναι κοντά στο πρωτότυπο αλλά όχι ακριβής: οι μετασχηματισμοί, τα φίλτρα και το περιεχόμενο των ::before ή ::after αποδίδονται χωρίς τα εφέ τους. Για κάθε οθόνη αποθηκεύονται επίσης τα στοιχεία της προέλευσής της: η διεύθυνση της σελίδας (χωρίς το #fragment), ο τίτλος της, το μέγεθος του παραθύρου και το πρόγραμμα περιήγησης.
Μπορώ να κρατήσω χωριστά τα σχόλια των πελατών και της ομάδας;
Ναι. Μια εφαρμογή μπορεί να στέλνει σχόλια σε πολλά έργα και ο διακομιστής της ορίζει το έργο για κάθε άτομο, ώστε τα σχόλια της ομάδας να πηγαίνουν σε ένα και όλων των άλλων σε άλλο.
Πόσο κοστίζει;
Περιλαμβάνεται σε όλα τα πακέτα. Στο δωρεάν πακέτο, κάθε Drop σχολίων μένει ανοιχτό για μία ημέρα και μετά ξεκινά ένα νέο· με το Pro παραμένουν ανοιχτά.
Διαβάστε περισσότερα
Δοκιμάστε το με το επόμενο αρχείο σας
Χρειάζονται περίπου δέκα δευτερόλεπτα για να αποκτήσετε έναν σύνδεσμο.
Σύρετε ένα αρχείο