Uwagi w Twojej aplikacji
DropComments SDK
Zbieraj opinie w aplikacji, którą tworzysz — wystarczy jeden znacznik script, jeden endpoint na serwerze i własny przycisk „Opinie”. Zespół przypina komentarze, prostokąty lub rysunki bezpośrednio w aplikacji, a jej użytkownicy wysyłają opinie przez krótki formularz. Wszystko trafia do Twoich projektów tutaj, gdzie Ty i Twój agent AI możecie odpowiadać.
Zainstaluj SDKZacznij za darmo. Klucz aplikacji zostaje na Twoim serwerze.
Zgłaszanie uwag do aplikacji nie powinno zaczynać się od zrzutu ekranu
Gdy ktoś testujący aplikację coś zauważy, robi zrzut ekranu, przycina go, wkleja na czat i pisze „ten element na górze, na drugim ekranie”. Ty szukasz tego ekranu i zgadujesz, o który element chodzi.
Ze skryptem w aplikacji można wskazać ten element dokładnie tam, gdzie jest. Komentarz trafia do Ciebie ze zrzutem ekranu z chwili zgłoszenia, zaznaczonym miejscem i informacją o autorze. Ty lub agent programujący możecie od razu zająć się poprawką, a odpowiedź pojawi się w aplikacji.
Jak to działa
- 1
Dodaj aplikację
Na swoim koncie, w sekcji Aplikacje, podaj jej nazwę, adresy, pod którymi działa, i projekty, do których mają trafiać opinie — na przykład jeden dla zespołu, a drugi dla klientów. Aplikacja otrzyma klucz.
- 2
Dodaj skrypt
Serwer aplikacji przechowuje klucz i przekazuje stronie krótkotrwały token dla zalogowanej osoby, określając, czy należy ona do zespołu. Strona ładuje jeden znacznik script, a Twój własny przycisk „Opinie” otwiera interfejs zgłoszeń. Wklej instrukcje z DropComments agentowi, który tworzy Twoją aplikację, a on doda te elementy.
- 3
Opinie spływają
Osoby z zespołu klikają „Opinie”, przypinają komentarz w wybranym miejscu i piszą. Widzą w aplikacji przypięte komentarze wszystkich osób i każdą odpowiedź na żywo. Pozostali dostają krótki formularz. Każde zgłoszenie trafia jako ekran Dropa do odpowiedniego projektu.
Zainstaluj SDK
Dla aplikacji internetowej z serwerem i logowaniem. Nie trzeba instalować pakietu: wystarczy klucz na serwerze, endpoint przekazujący stronie token, znacznik script i własny przycisk otwierający interfejs zgłoszeń.
Dodaj aplikację w DropComments, w sekcji Aplikacje: podaj jej nazwę, adresy, pod którymi działa (https lub http na localhost i .test podczas tworzenia), oraz projekty, do których mają trafiać opinie. Otrzymasz klucz aplikacji i identyfikator każdego projektu.
Przechowuj klucz na serwerze, w zmiennych środowiskowych lub sekretach:
DROPCOMMENTS_KEY=dc_app_…
Nigdy na stronie, w kodzie trafiającym do przeglądarki ani w commicie. DropComments odrzuca klucz przesłany z przeglądarki.
Dodaj endpoint tokenów. Dla zalogowanej osoby pobiera on token z DropComments i zwraca otrzymany JSON bez zmian. Gdy nikt nie jest zalogowany, zwróć 401 — nic się nie wyświetli.
// 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"}}); }Przykład używa funkcji obsługującej trasę w Next.js; w Worker, Deno lub Bun działa to tak samo. W Express zwróć ten sam status i JSON.
Załaduj skrypt na każdej stronie, przed
</body>:<script src="https://dropcomments.com/live.js" data-token-url="/api/feedback-token"></script>
Skrypt nie wyświetla własnego przycisku, więc na razie nic się nie pojawi.
Dodaj własny przycisk „Opinie”, ukryty do czasu, aż
DropComments.readyzasygnalizuje otrzymanie tokenu. Przycisk otwiera panel dla zespołu i krótki formularz dla pozostałych osób:<button id="feedback" hidden>Feedback</button> const button = document.getElementById("feedback"); if (await DropComments.ready) { button.hidden = false; button.addEventListener("click", () => DropComments.open()); }Umieść go tam, gdzie pasuje do aplikacji: w nagłówku, menu lub na ekranie ustawień. Panel, formularz i przypięte znaczniki zapewnia skrypt.
Jeśli Twoje strony wysyłają nagłówek Content-Security-Policy, zezwól na DropComments:
script-src https://dropcomments.com; connect-src https://dropcomments.com wss://dropcomments.com;
Możesz też zlecić to agentowi programującemu. Po dodaniu aplikacji zobaczysz instrukcję z uzupełnionym kluczem i identyfikatorami projektów. Wklej ją agentowi, który tworzy Twoją aplikację, a on doda endpoint, skrypt i przycisk.
Dokumentacja
Token
Twój serwer wywołuje POST https://dropcomments.com/api/app/token z kluczem aplikacji jako tokenem typu bearer. Pole project jest wymagane i zawiera identyfikator projektu. user to zalogowana osoba; jeśli pominiesz jej imię, panel o nie zapyta. team określa, jakie narzędzia otrzyma. Token jest ważny przez godzinę, a skrypt prosi Twój endpoint o nowy, zanim obecny wygaśnie.
{
"project": "YOUR_PROJECT_ID",
"user": {"id": "u_123", "name": "Sam Lee"},
"team": true
}
// → {"token": "dct.…", "expiresAt": …, "team": true, "project": {…}}Opcje skryptu
data-token-url to Twój endpoint, do którego żądanie jest wysyłane z plikami cookie strony; może zwrócić JSON z tokenem lub token jako zwykły tekst. data-ui="none" niczego nie wyświetla i pozwala użyć własnego formularza: wyślij zebrane dane przez DropComments.send(). Komentarze zespołu wysyłane z komputera zawierają oprócz zrzutu ekranu także kopię strony. W Dropie przycisk strony otwiera tę kopię z możliwością przewijania i zaznaczania tekstu, a agent może odczytać jej treść. data-capture="picture" wysyła tylko zrzut ekranu. Telefony i tablety zawsze wysyłają tylko zrzut.
<script src="https://dropcomments.com/live.js" data-token-url="/api/feedback-token" data-capture="picture"></script>
JavaScript
Po załadowaniu skryptu wszystko jest dostępne w window.DropComments. ready informuje, czy otrzymano token, więc dopiero wtedy pokazujesz swój przycisk.
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 nullWygląd Twojej aplikacji
Wygląd przycisku „Opinie” ustalasz samodzielnie. Ustaw te zmienne w :root, a panel, formularz i przypięte znaczniki też je zastosują. Pozostałe zmienne: --dc-muted, --dc-line, --dc-soft, --dc-on-accent, --dc-accent-text, --dc-pin, --dc-on-pin i --dc-button-radius.
:root {
--dc-font: "Inter", sans-serif;
--dc-surface: #ffffff;
--dc-text: #111827;
--dc-accent: #4f46e5;
--dc-radius: 12px;
}Ochrona prywatności
Komentarz zawiera zrzut ekranu, więc widać na nim to, co na ekranie, także wpisany tekst (hasła jako kropki). Oznacz wszystko, co nigdy nie powinno opuszczać aplikacji — na zrzucie pojawi się w tym miejscu szary prostokąt, a w kopii strony te elementy zostaną pominięte. Kopia nie zawiera skryptów, a pola formularzy pozostają w niej puste.
<div data-dc-hide> Card ending 4242 </div>
Co zyskujesz
Zespół testujący wersję aplikacji
Przypinaj komentarze, zaznaczaj prostokątem lub rysuj w działającej aplikacji, na komputerze albo telefonie. Każdy komentarz zawiera zrzut ekranu z zaznaczonym miejscem, a z komputera także kopię strony, więc wystarczy napisać „tutaj nie działa”.
Osoby korzystające z aplikacji
Krótki formularz z opcją „Wskaż miejsce” i zrzutem ekranu. Użytkownicy nigdy nie widzą cudzych opinii, a ich zrzut jest wysyłany tylko wtedy, gdy zostawią zaznaczoną tę opcję.
Beta testerzy i klienci
Zapewnij logowanie osobom, z którymi testujesz aplikację, i zdecyduj, kto należy do zespołu. Klient przeglądający witrynę w środowisku testowym zostawia uwagi bezpośrednio na niej.
Poprawki od agenta
Agent programujący połączony z DropComments czyta każdy komentarz i stronę, na której go dodano, wprowadza zmianę i odpowiada. Odpowiedź pojawia się w aplikacji.
W stylu Twojej aplikacji
Formularz dla użytkowników przejmuje Twoje kolory, krój pisma i zaokrąglenia z kilku zmiennych CSS. Możesz też użyć własnego formularza i wysłać jego dane jednym wywołaniem.
Twój klucz zostaje u Ciebie
Klucz znajduje się na serwerze, nigdy na stronie. Opinie są przyjmowane tylko z adresów Twojej aplikacji, z limitem na osobę, a każdy projekt jest wskazywany przez identyfikator.
Prosto do skrzynki odbiorczej
Każda uwaga trafia jako zgłoszenie do skrzynki odbiorczej swojego projektu, gotowa, by ktoś się nią zajął.
Pytania
Czy to działa z każdą aplikacją?
Z każdą aplikacją internetową, która ma serwer i logowanie: serwer informuje DropComments, kim jest dana osoba. Gry i inne aplikacje rysowane na elemencie canvas też działają — plansza jest przesyłana jako obraz.
Co jest wysyłane z komentarzem osoby z zespołu?
Obraz ekranu z chwili przesłania, z wyszarzonymi elementami oznaczonymi data-dc-hide. Przy przesyłaniu z komputera obok trafia też kopia strony (chyba że ustawisz data-capture="picture"): z osadzonymi stylami i obrazami, bez skryptów, z pustymi polami formularzy i z pominięciem elementów oznaczonych data-dc-hide, a także obraz wskazanego miejsca. Drop wyświetla obraz, a na komputerze można przełączyć się na stronę. Skrypt rysuje obraz na podstawie układu strony, więc jest on zbliżony do oryginału, ale nie identyczny: transformacje, filtry i treści ::before lub ::after są przedstawiane w uproszczonej postaci. Do ekranu zapisywane są też informacje o miejscu jego utworzenia: adres strony (bez #fragment), jej tytuł, rozmiar okna i przeglądarka.
Czy mogę oddzielić uwagi klientów od uwag zespołu?
Tak. Aplikacja może przesyłać uwagi do kilku projektów, a jej serwer wskazuje projekt dla każdej osoby. Dzięki temu uwagi zespołu trafiają do jednego projektu, a wszystkich pozostałych do innego.
Ile to kosztuje?
Ta funkcja jest dostępna w każdym planie. W planie bezpłatnym każdy Drop z uwagami jest otwarty na komentarze przez dobę, a potem powstaje nowy. W Pro pozostają otwarte.
Czytaj dalej
Wypróbuj przy następnym pliku
Uzyskanie linku zajmuje około dziesięciu sekund.
Wrzuć plik