Комментарии внутри вашего приложения
DropComments SDK
Собирайте отзывы прямо в приложении, которое создаёте: для этого нужны один тег script, один эндпоинт на сервере и ваша кнопка «Обратная связь». Команда может прикрепить комментарий, рамку или рисунок к нужному месту в приложении, а пользователи — отправить отзыв через короткую форму. Всё попадает в ваши проекты здесь, где вы и ваш ИИ-агент можете ответить.
Установить SDKНачать можно бесплатно. Ключ приложения остаётся на вашем сервере.
Чтобы сообщить о проблеме в приложении, не должно быть нужно делать скриншот
Когда человек тестирует ваше приложение и что-то замечает, он делает скриншот, обрезает его, вставляет в чат и пишет: «Вот эта штука сверху, на втором экране». Вы ищете нужный экран и гадаете, какую именно штуку он имел в виду.
Со скриптом в приложении можно указать прямо на нужное место. Комментарий приходит со снимком экрана в тот момент, отмеченным местом и данными отправителя — всё готово, чтобы вы или агент для разработки внесли исправление. А ответ появляется в приложении.
Как это работает
- 1
Добавьте приложение
В разделе «Приложения» вашего аккаунта укажите название, адреса, по которым работает приложение, и проекты для отзывов — например, один для команды и один для клиентов. Приложение получит ключ.
- 2
Добавьте скрипт
Сервер приложения хранит ключ и выдаёт странице краткосрочный токен для вошедшего пользователя с указанием, входит ли он в команду. Страница загружает скрипт через один тег, а ваша кнопка «Обратная связь» открывает его интерфейс. Передайте инструкции из DropComments агенту, который разрабатывает ваше приложение, и он всё добавит.
- 3
Получайте отзывы
Участники команды нажимают «Обратная связь», отмечают нужное место и пишут комментарий. Они сразу видят в приложении отметки всех участников и каждый ответ. Для остальных открывается короткая форма. Каждый отзыв попадает в свой проект как экран в Drop.
Установите SDK
Для веб-приложения с сервером и входом в аккаунт. Устанавливать пакет не нужно: достаточно ключа на сервере, эндпоинта, который выдаёт странице токен, тега script и вашей кнопки для открытия интерфейса.
Добавьте приложение в разделе «Приложения» в DropComments: укажите название, адреса, по которым оно работает (https или http на localhost и .test во время разработки), и проекты для отзывов. Вы получите ключ приложения и id каждого проекта.
Храните ключ на сервере, в переменных окружения или хранилище секретов:
DROPCOMMENTS_KEY=dc_app_…
Никогда не размещайте его на странице, в коде, который попадает в браузер, или в коммите. DropComments не принимает этот ключ из браузера.
Добавьте эндпоинт выдачи токенов. Для вошедшего пользователя он запрашивает токен у 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.
Загрузите скрипт на каждой странице перед
</body>:<script src="https://dropcomments.com/live.js" data-token-url="/api/feedback-token"></script>
Скрипт не добавляет собственную кнопку, поэтому пока ничего не появится.
Добавьте свою кнопку «Обратная связь» и скрывайте её, пока
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()); }Разместите её там, где удобно в вашем приложении: в шапке, меню или на экране настроек. Панель, форму и отметки создаёт скрипт.
Если ваши страницы отправляют 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 они остаются открытыми.
Читать дальше
Попробуйте со следующим файлом
Получить ссылку можно примерно за десять секунд.
Загрузить файл