DropComments

Zpětná vazba ve vaší aplikaci

DropComments SDK

Sbírejte zpětnou vazbu přímo v aplikaci, kterou vyvíjíte. Stačí jedna značka script, jeden endpoint na vašem serveru a vlastní tlačítko Zpětná vazba. Váš tým připne komentář, obdélník nebo kresbu přímo v aplikaci a její uživatelé pošlou zpětnou vazbu přes krátký formulář. Vše se shromáždí tady ve vašich projektech, kde můžete odpovídat vy i váš AI agent.

Nainstalujte SDK

Začněte zdarma. Klíč vaší aplikace zůstává na vašem serveru.

Zpětná vazba k aplikaci by neměla začínat snímkem obrazovky

Když někdo při testování vaší aplikace na něco narazí, pořídí snímek obrazovky, ořízne ho, vloží do chatu a napíše „ta věc nahoře, na druhé obrazovce“. Vy pak hledáte danou obrazovku a hádáte, kterou věc myslí.

Se skriptem v aplikaci ukáže přímo na dané místo. Komentář dorazí se snímkem obrazovky v okamžiku odeslání, označeným místem a údajem o tom, kdo ho poslal. Vy nebo programovací agent se tak můžete rovnou pustit do opravy a odpověď se zobrazí v aplikaci.

Jak to funguje

  1. 1

    Přidejte svou aplikaci

    Ve svém účtu v části Aplikace zadejte její název, adresy, na kterých běží, a projekty, do kterých má zpětná vazba chodit. Třeba jeden pro tým a druhý pro zákazníky. Aplikace dostane vlastní klíč.

  2. 2

    Přidejte skript

    Server aplikace uchovává klíč a stránce poskytuje krátkodobý token pro právě přihlášeného uživatele s údajem, zda patří do vašeho týmu. Stránka načte jedinou značku script a vaše vlastní tlačítko Zpětná vazba otevře rozhraní. Zkopírujte to, co vám DropComments zobrazí, agentovi, který vaši aplikaci vyvíjí, a on vše přidá.

  3. 3

    Zpětná vazba přichází

    Členové týmu stisknou Zpětná vazba, připnou komentář na dané místo a napíšou ho. V aplikaci vidí připnuté komentáře všech členů i každou odpověď, živě. Všem ostatním se zobrazí krátký formulář. Každé odeslání se uloží jako obrazovka Dropu v příslušném projektu.

Nainstalujte SDK

Pro webovou aplikaci se serverem a přihlašováním uživatelů. Žádný balíček se neinstaluje: stačí klíč na vašem serveru, endpoint, který stránce předá token, značka script a vlastní tlačítko pro otevření rozhraní.

  1. Přidejte svou aplikaci v DropComments v části Aplikace: její název, adresy, na kterých běží (https, při vývoji také http na localhost a .test), a projekty, do kterých má zpětná vazba chodit. Získáte její klíč a ID každého projektu.

    Přidat aplikaci

  2. Uchovávejte klíč na svém serveru, v proměnných prostředí nebo v úložišti tajných údajů:

    DROPCOMMENTS_KEY=dc_app_…

    Nikdy na stránce, v kódu, který se dostane do prohlížeče, ani v commitu. DropComments ho z prohlížeče odmítne.

  3. Přidejte endpoint pro tokeny. Pro právě přihlášeného uživatele požádá DropComments o token a vrátí jeho JSON beze změny. Pokud není nikdo přihlášený, vraťte stav 401 a nic se nezobrazí.

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

    Ukázka je napsaná jako obsluha routy v Next.js; ve Workeru, Deno nebo Bun je postup stejný. V Express vraťte stejný stav a JSON.

  4. Načtěte skript na každé stránce před </body>:

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

    Skript nevytváří vlastní tlačítko, takže se zatím nic nezobrazí.

  5. Přidejte vlastní tlačítko Zpětná vazba. Nechte ho skryté, dokud DropComments.ready nepotvrdí přijetí tokenu. Týmu otevře panel, všem ostatním krátký formulář:

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

    Umístěte ho tam, kde se do vaší aplikace hodí: do záhlaví, nabídky nebo na obrazovku nastavení. Panel, formulář a připnuté komentáře zajišťuje skript.

  6. Pokud vaše stránky posílají Content-Security-Policy, povolte DropComments:

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

Nebo to nechte na svém programovacím agentovi. Po přidání aplikace se zobrazí zadání s už vyplněným klíčem a ID projektů. Zkopírujte ho agentovi, který vaši aplikaci vyvíjí, a on přidá endpoint, skript i tlačítko.

Referenční dokumentace

Token

Váš server volá POST https://dropcomments.com/api/app/token s klíčem aplikace jako bearer tokenem. project je povinný a zadává se jako ID. user je právě přihlášený uživatel; pokud vynecháte jméno, panel si ho vyžádá. team určuje, jaké nástroje bude mít uživatel k dispozici. Token platí hodinu a skript si před vypršením platnosti vyžádá od vašeho endpointu nový.

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

Nastavení skriptu

data-token-url je váš endpoint, na který se posílá požadavek s cookies stránky; může vrátit JSON s tokenem nebo token jako prostý text. data-ui="none" nezobrazí vůbec nic a slouží pro vlastní formulář: to, co sesbírá, odešlete pomocí DropComments.send(). U komentářů týmu odeslaných z počítače se vedle snímku přikládá i kopie stránky: v Dropu ji zobrazí tlačítko stránky, lze v ní posouvat obsah a vybírat text a agent si může přečíst její text. data-capture="picture" odešle pouze snímek. Telefony a tablety vždy odesílají pouze snímek.

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

JavaScript

Po načtení skriptu je vše dostupné přes window.DropComments. ready oznamuje, zda dorazil token, takže své tlačítko zobrazíte až poté.

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

Vzhled vaší aplikace

Vzhled svého tlačítka Zpětná vazba si určujete sami. Nastavte tyto proměnné na :root a převezmou je i panel, formulář a připnuté komentáře. Další proměnné: --dc-muted, --dc-line, --dc-soft, --dc-on-accent, --dc-accent-text, --dc-pin, --dc-on-pin a --dc-button-radius.

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

Ochrana soukromí

Ke komentáři se přikládá snímek obrazovky, takže zachycuje vše, co je na ní vidět, včetně zadaného textu (hesla jako tečky). Označte vše, co nesmí vaši aplikaci nikdy opustit. Na snímku to nahradí šedý obdélník a v kopii stránky to bude vynecháno. Kopie neobsahuje žádné skripty a vyplněná pole v ní zůstávají prázdná.

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

Co získáte

Váš tým při testování verze

Připínejte komentáře, označujte místa obdélníkem nebo kreslete přímo v běžící aplikaci, na počítači i telefonu. Každý komentář obsahuje snímek obrazovky s označeným místem a při odeslání z počítače také kopii stránky, takže stačí napsat „tady to nefunguje“.

Lidé, kteří aplikaci používají

Krátký formulář s možností Ukázat na místo a snímkem obrazovky. Uživatelé nikdy nevidí zpětnou vazbu ostatních a jejich snímek se odešle jen tehdy, pokud nechají tuto možnost zaškrtnutou.

Beta testeři a klienti

Nechte lidi, se kterými aplikaci zkoušíte, přihlásit a určete, kdo patří do týmu. Klient, který kontroluje web v testovacím prostředí, může psát poznámky přímo na něm.

Opravy od agenta

Programovací agent připojený k DropComments si přečte každý komentář i stránku, na které vznikl, provede změnu a odpoví. Odpověď se zobrazí v aplikaci.

Ve stylu vaší aplikace

Formulář pro uživatele převezme vaše barvy, písmo a zaoblení rohů z několika CSS proměnných. Nebo použijte vlastní formulář a odešlete ho jediným voláním.

Váš klíč zůstává u vás

Klíč je uložený na vašem serveru, nikdy na stránce. Zpětná vazba se přijímá jen z adres vaší aplikace, s limitem pro každého uživatele, a každý projekt se vybírá podle ID.

Přímo do vaší schránky

Každá připomínka se objeví jako úkol ve schránce svého projektu, připravená k převzetí.

Otázky

Funguje to s jakoukoli aplikací?

S jakoukoli webovou aplikací se serverem a přihlašováním uživatelů: server sdělí DropComments, kdo je který uživatel. Fungují i hry a další aplikace vykreslované na plátno canvas; obsah plátna se přenese jako snímek.

Co se odešle s komentářem člena týmu?

Snímek obrazovky v podobě, jakou měla v danou chvíli, se zašedlým obsahem označeným data-dc-hide. Při odeslání z počítače také kopii stránky vedle snímku (pokud nenastavíte data-capture="picture"): s vloženými styly a obrázky, bez skriptů, s prázdnými vstupními poli a bez obsahu označeného data-dc-hide, a navíc snímek daného místa. Drop zobrazuje snímek a na počítači lze přepnout na stránku. Snímek vykresluje skript podle rozvržení stránky, takže se originálu blíží, ale není přesný: transformace, filtry a obsah ::before nebo ::after se zobrazí bez efektů. U obrazovky se také uchovává kontext jejího vzniku: adresa stránky (bez části #fragment), její název, velikost okna a prohlížeč.

Můžu oddělit zpětnou vazbu zákazníků od zpětné vazby týmu?

Ano. Aplikace může posílat zpětnou vazbu do více projektů a její server pro každého člověka určí, do kterého patří. Zpětná vazba týmu tak jde do jednoho a všech ostatních do jiného.

Kolik to stojí?

Funkce je součástí všech tarifů. V bezplatném tarifu je každý Drop se zpětnou vazbou otevřený pro komentáře jeden den a poté vznikne nový; s Pro zůstávají otevřené.

Čtěte dál

Vyzkoušejte to s dalším souborem

Získat odkaz trvá asi deset sekund.

Nahrajte soubor