DropComments

Обратна връзка в твоето приложение

DropComments SDK

Събирайте обратна връзка в приложението, което разработвате, с един скриптов таг, една крайна точка на сървъра си и собствен бутон „Обратна връзка“. Екипът ви поставя коментар, рамка или рисунка върху самото приложение, а потребителите му изпращат обратна връзка чрез кратък формуляр. Всичко се събира в проектите ви тук, където вие и вашият AI агент отговаряте.

Инсталирай SDK

Започнете безплатно. Ключът на приложението ви остава на вашия сървър.

Обратната връзка за приложение не бива да започва с екранна снимка

Когато някой тества приложението ви и забележи нещо, прави екранна снимка, изрязва я, поставя я в чат и пише „онова горе, на втория екран“. Вие намирате екрана и гадаете кое точно има предвид.

Със скрипта в приложението човекът посочва мястото направо там. Коментарът пристига със снимка на екрана във вида му тогава, отбелязано място и информация кой го е изпратил. Така вие или агент за програмиране можете да направите поправката, а отговорът се появява в приложението.

Как работи

  1. 1

    Добавете приложението си

    В профила си, в „Приложения“, въведете името му, адресите, на които работи, и проектите, в които да постъпва обратната връзка — например един за екипа и един за клиентите ви. Приложението получава ключ.

  2. 2

    Добавете скрипта

    Сървърът на приложението пази ключа и дава на страницата краткотраен токен за влезлия потребител, който указва дали той е част от екипа ви. Страницата зарежда един скриптов таг, а вашият бутон „Обратна връзка“ отваря интерфейса. Копирайте показаното от DropComments и го дайте на агента, който разработва приложението ви, за да добави всичко необходимо.

  3. 3

    Обратната връзка пристига

    Хората от екипа ви натискат „Обратна връзка“, отбелязват мястото и пишат; виждат всички маркери в приложението и всеки отговор на живо. Всички останали получават кратък формуляр. Всяко изпращане се добавя като екран в Drop в съответния проект.

Инсталирай SDK

За уеб приложение със сървър и потребители, които влизат в профилите си. Няма пакет за инсталиране: само ключ на сървъра ви, крайна точка, която подава токен на страницата, скриптов таг и ваш собствен бутон, който отваря интерфейса.

  1. Добавете приложението си в DropComments, в „Приложения“: името му, адресите, на които работи (https или http за localhost и .test по време на разработката), и проектите, в които да постъпва обратната връзка. Получавате ключа му и идентификатора на всеки проект.

    Добавете приложението си

  2. Пазете ключа на сървъра си, в променливите на средата или хранилището за тайни:

    DROPCOMMENTS_KEY=dc_app_…

    Никога в страница, в код, който достига до браузъра, или в комит. DropComments отказва да го приеме от браузър.

  3. Добавете крайна точка за токени. За всеки влязъл потребител тя иска токен от DropComments и връща получения 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"}});
    }

    Примерът е написан като обработчик на маршрут в Next.js; същото важи за Worker, Deno или Bun. В Express върнете същия статус и JSON.

  4. Заредете скрипта във всяка страница, преди </body>:

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

    Той не добавя собствен бутон, затова засега нищо не се показва.

  5. Добавете собствен бутон „Обратна връзка“, скрит, докато DropComments.ready не покаже, че е получен токен. Бутонът отваря панела за екипа ви и краткия формуляр за всички останали:

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

    Поставете го там, където е подходящо за приложението ви: в горната лента, в меню или на екран с настройки. Панелът, формулярът и маркерите се осигуряват от скрипта.

  6. Ако страниците ви изпращат Content-Security-Policy, разрешете DropComments:

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

Или оставете това на агента си за програмиране. След добавянето на приложението се показват кратки инструкции с вече попълнени ключ и идентификатори на проектите. Дайте ги на агента, който разработва приложението ви, и той ще добави крайната точка, скрипта и бутона.

Справочник

Токенът

Сървърът ви извиква POST https://dropcomments.com/api/app/token с ключа на приложението като bearer токен. project е задължителен и се задава чрез идентификатора на проекта. user е влезлият потребител; ако пропуснете името, панелът ще поиска да бъде въведено. team определя кои инструменти са достъпни за потребителя. Токенът е валиден един час, а скриптът иска нов от вашата крайна точка, преди да изтече.

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

Настройки на скрипта

data-token-url е вашата крайна точка, към която се изпраща заявка с бисквитките на страницата; тя може да върне JSON с токена или самия токен като обикновен текст. data-ui="none" не показва нищо и ви позволява да използвате собствен формуляр: изпратете събраното с DropComments.send(). При коментари от екипа, изпратени от компютър, заедно със снимката се изпраща и копие на страницата: в Drop бутонът за страница го показва с възможност за превъртане и избиране на текст, а агент може да прочете съдържанието му. data-capture="picture" изпраща само снимката. Телефоните и таблетите винаги изпращат само снимка.

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

JavaScript

Всичко е достъпно чрез window.DropComments, след като скриптът се зареди. ready показва дали е получен токен, така че да покажете бутона си едва тогава.

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;
}

Защита на поверителната информация

Коментарът включва снимка на екрана, затова на нея се вижда съдържанието му, включително въведеният текст (паролите са показани като точки). Отбележете всичко, което никога не бива да напуска приложението ви, и то ще бъде заменено със сив правоъгълник на снимката и пропуснато в копието на страницата. Копието не съдържа скриптове, а полетата за въвеждане остават празни.

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

Какво получаваш

Екипът ви тества версия на приложението

Поставяйте маркери, очертавайте рамки или рисувайте върху работещото приложение от компютър или телефон. Всеки коментар включва снимка на екрана с отбелязано място, а когато е изпратен от компютър — и копие на страницата. Така „тук не работи“ е достатъчно.

Хората, които го използват

Кратък формуляр с „Посочете мястото“ и снимка на екрана. Потребителите никога не виждат чуждата обратна връзка, а снимката им се изпраща само ако оставят отметката.

Бета тестери и клиенти

Осигурете вход на хората, с които изпробвате приложението, и решете кого да включите в екипа. Клиент, който преглежда сайт в тестова среда, оставя бележки направо върху него.

Поправки от агент

Агент за програмиране, свързан с DropComments, прочита всеки коментар и страницата, на която е оставен, прави промяната и отговаря. Отговорът се появява в приложението.

С визията на приложението ви

Формулярът за потребителите приема вашите цветове, шрифт и заобляне на ъглите чрез няколко CSS променливи. Можете и да използвате собствен формуляр и да изпратите съдържанието му с едно извикване.

Ключът ви остава само при вас

Ключът се съхранява на сървъра ви, никога в страница. Обратна връзка се приема само от адресите на приложението ви, с ограничение за всеки потребител, а всеки проект се избира по идентификатора му.

Директно във „Входящи“

Всяка обратна връзка пристига като задача във „Входящи“ на съответния проект, готова някой да я поеме.

Въпроси

Работи ли с всяко приложение?

С всяко уеб приложение със сървър и потребители, които влизат в профилите си: сървърът казва на DropComments кой е всеки потребител. Работи и с игри и други приложения, изобразени върху canvas; съдържанието се получава като снимка.

Какво се изпраща с коментар от екипа?

Изображение на екрана във вида, в който е бил, като всичко, отбелязано с data-dc-hide, е покрито със сиво. От компютър се запазва и копие на страницата до него (освен ако не зададете data-capture="picture"): с включени стилове и изображения, без скриптове, с празни полета за въвеждане и без всичко, отбелязано с data-dc-hide, плюс изображение на конкретното място. Drop показва изображението, а на компютър може да се превключи към страницата. Скриптът рисува изображението по оформлението на страницата, затова то е близко до оригинала, но не е точно копие: трансформациите, филтрите и съдържанието на ::before или ::after се показват без специално оформление. Към екрана се запазва и информация откъде е създаден: адресът на страницата (без нейния #fragment), заглавието ѝ, размерът на прозореца и браузърът.

Мога ли да държа обратната връзка от клиентите отделно от тази на екипа?

Да. Едно приложение може да изпраща обратна връзка в няколко проекта, а сървърът му определя проекта за всеки човек. Така обратната връзка от екипа отива в един проект, а от всички останали — в друг.

Колко струва?

Функцията е включена във всеки план. При безплатния план всеки Drop за обратна връзка е отворен за един ден, след което започва нов; с Pro остават отворени.

Прочети още

Опитай със следващия си файл

Получаваш връзка за около десет секунди.

Пусни файл