DropComments

Комментарии внутри вашего приложения

DropComments SDK

Собирайте отзывы прямо в приложении, которое создаёте: для этого нужны один тег script, один эндпоинт на сервере и ваша кнопка «Обратная связь». Команда может прикрепить комментарий, рамку или рисунок к нужному месту в приложении, а пользователи — отправить отзыв через короткую форму. Всё попадает в ваши проекты здесь, где вы и ваш ИИ-агент можете ответить.

Установить SDK

Начать можно бесплатно. Ключ приложения остаётся на вашем сервере.

Чтобы сообщить о проблеме в приложении, не должно быть нужно делать скриншот

Когда человек тестирует ваше приложение и что-то замечает, он делает скриншот, обрезает его, вставляет в чат и пишет: «Вот эта штука сверху, на втором экране». Вы ищете нужный экран и гадаете, какую именно штуку он имел в виду.

Со скриптом в приложении можно указать прямо на нужное место. Комментарий приходит со снимком экрана в тот момент, отмеченным местом и данными отправителя — всё готово, чтобы вы или агент для разработки внесли исправление. А ответ появляется в приложении.

Как это работает

  1. 1

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

    В разделе «Приложения» вашего аккаунта укажите название, адреса, по которым работает приложение, и проекты для отзывов — например, один для команды и один для клиентов. Приложение получит ключ.

  2. 2

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

    Сервер приложения хранит ключ и выдаёт странице краткосрочный токен для вошедшего пользователя с указанием, входит ли он в команду. Страница загружает скрипт через один тег, а ваша кнопка «Обратная связь» открывает его интерфейс. Передайте инструкции из DropComments агенту, который разрабатывает ваше приложение, и он всё добавит.

  3. 3

    Получайте отзывы

    Участники команды нажимают «Обратная связь», отмечают нужное место и пишут комментарий. Они сразу видят в приложении отметки всех участников и каждый ответ. Для остальных открывается короткая форма. Каждый отзыв попадает в свой проект как экран в Drop.

Установите SDK

Для веб-приложения с сервером и входом в аккаунт. Устанавливать пакет не нужно: достаточно ключа на сервере, эндпоинта, который выдаёт странице токен, тега script и вашей кнопки для открытия интерфейса.

  1. Добавьте приложение в разделе «Приложения» в DropComments: укажите название, адреса, по которым оно работает (https или http на localhost и .test во время разработки), и проекты для отзывов. Вы получите ключ приложения и id каждого проекта.

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

  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;

Или поручите это агенту для разработки. После добавления приложения вы увидите инструкции, в которых уже подставлены ключ и id проектов. Передайте их агенту, который разрабатывает ваше приложение, и он добавит эндпоинт, скрипт и кнопку.

Справочник

Токен

Ваш сервер вызывает POST https://dropcomments.com/api/app/token, передавая ключ приложения как bearer-токен. Поле project обязательно: в нём указывается id проекта. user — вошедший пользователь; если не передать имя, панель попросит его указать. team определяет доступные инструменты. Токен действует час, и до истечения срока скрипт запрашивает новый через ваш эндпоинт.

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

Параметры скрипта

data-token-url — ваш эндпоинт, к которому скрипт обращается с cookie страницы; он может вернуть 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-переменных. Или используйте свою форму и отправляйте данные одним вызовом.

Ваш ключ остаётся у вас

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

Сразу во «Входящие»

Каждое замечание поступает как задача во «Входящие» своего проекта — остаётся только взяться за неё.

Вопросы

Это работает с любым приложением?

С любым веб-приложением, у которого есть сервер и вход в аккаунт: сервер сообщает DropComments, кто каждый пользователь. Игры и другие приложения, отрисованные на canvas, тоже поддерживаются — их содержимое передаётся как снимок.

Что отправляется с комментарием участника команды?

Снимок экрана в том виде, в каком он был, с закрашенными серым элементами, помеченными data-dc-hide. При отправке с компьютера рядом сохраняется и копия страницы (если не задано data-capture="picture"): со встроенными стилями и изображениями, без скриптов, с пустыми полями ввода и без элементов, помеченных data-dc-hide, а также снимок отмеченного места. В Drop показывается снимок, а на компьютере можно переключиться на страницу. Скрипт создаёт снимок по структуре страницы, поэтому он близок к оригиналу, но не повторяет его в точности: трансформации, фильтры и содержимое ::before или ::after отображаются без оформления. Вместе с экраном сохраняются сведения о том, где он был создан: адрес страницы (без #fragment), её заголовок, размер окна и браузер.

Можно ли разделить отзывы клиентов и команды?

Да. Приложение может отправлять отзывы в несколько проектов, а его сервер определяет проект для каждого пользователя: отзывы команды попадают в один, а всех остальных — в другой.

Сколько это стоит?

Функция доступна на всех тарифах. На бесплатном тарифе каждый Drop с отзывами открыт для комментариев в течение суток, после чего создаётся новый. На Pro они остаются открытыми.

Читать дальше

Попробуйте со следующим файлом

Получить ссылку можно примерно за десять секунд.

Загрузить файл