DropComments

Góp ý ngay trong ứng dụng của bạn

DropComments SDK

Nhận góp ý ngay trong ứng dụng bạn đang xây dựng với một thẻ script, một endpoint trên máy chủ và nút Góp ý do bạn tự tạo. Nhóm của bạn ghim bình luận, khoanh vùng hoặc vẽ ngay trên ứng dụng; người dùng gửi góp ý qua một biểu mẫu ngắn. Tất cả được đưa vào các dự án của bạn tại đây, nơi bạn và agent AI có thể trả lời.

Cài đặt SDK

Bắt đầu miễn phí. Khóa của ứng dụng luôn nằm trên máy chủ của bạn.

Góp ý về ứng dụng không nên bắt đầu bằng ảnh chụp màn hình

Khi người thử nghiệm ứng dụng phát hiện vấn đề, họ chụp màn hình, cắt ảnh, dán vào cuộc trò chuyện rồi viết “cái ở trên cùng, màn hình thứ hai ấy”. Bạn phải tìm màn hình đó rồi đoán xem họ đang nói đến cái nào.

Khi ứng dụng có script, họ chỉ thẳng vào đúng chỗ. Bình luận được gửi đến kèm ảnh chụp màn hình lúc đó, vị trí được đánh dấu và người gửi, để bạn hoặc agent lập trình có thể xử lý. Câu trả lời sẽ hiện ngay trong ứng dụng.

Cách hoạt động

  1. 1

    Thêm ứng dụng của bạn

    Trong tài khoản của bạn, ở mục Ứng dụng: nhập tên, các địa chỉ ứng dụng chạy và các dự án nhận góp ý, chẳng hạn một dự án cho nhóm và một cho khách hàng. Ứng dụng sẽ được cấp một khóa.

  2. 2

    Thêm script

    Máy chủ của ứng dụng giữ khóa và cấp cho trang một token có thời hạn ngắn dành cho người đang đăng nhập, cho biết họ có thuộc nhóm của bạn hay không. Trang tải một thẻ script, và nút Góp ý do bạn tạo sẽ mở giao diện góp ý. Dán nội dung DropComments cung cấp cho agent đang xây dựng ứng dụng để agent thêm các phần này.

  3. 3

    Góp ý được gửi đến

    Nhóm của bạn nhấn Góp ý, ghim đúng vị trí rồi viết; họ thấy các ghim của mọi người trên ứng dụng và từng câu trả lời theo thời gian thực. Những người còn lại thấy một biểu mẫu ngắn. Mỗi góp ý trở thành một màn hình trong một Drop thuộc dự án tương ứng.

Cài đặt SDK

Dành cho ứng dụng web có máy chủ và người dùng đăng nhập. Không cần cài gói nào: chỉ cần một khóa trên máy chủ, một endpoint cấp token cho trang, một thẻ script và một nút do bạn tự tạo để mở giao diện góp ý.

  1. Thêm ứng dụng của bạn trong DropComments, ở mục Ứng dụng: tên, các địa chỉ ứng dụng chạy (https, hoặc http trên localhost và .test khi phát triển) và các dự án nhận góp ý. Bạn sẽ nhận được khóa của ứng dụng và id của từng dự án.

    Thêm ứng dụng của bạn

  2. Giữ khóa trên máy chủ của bạn, trong biến môi trường hoặc kho lưu bí mật:

    DROPCOMMENTS_KEY=dc_app_…

    Tuyệt đối không đặt khóa trong trang, trong mã được gửi đến trình duyệt hay trong commit. DropComments từ chối khóa được gửi từ trình duyệt.

  3. Thêm endpoint cấp token. Với người đang đăng nhập, endpoint yêu cầu DropComments cấp token và trả nguyên JSON nhận được. Nếu chưa có ai đăng nhập, trả về 401 và giao diện sẽ không hiện.

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

    Ví dụ được viết dưới dạng route handler của Next.js; cách làm tương tự trên Worker, Deno hoặc Bun. Với Express, trả về cùng mã trạng thái và JSON.

  4. Tải script trên mọi trang, trước </body>:

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

    Script không tự tạo nút nên lúc này chưa có gì hiển thị.

  5. Thêm nút Góp ý của riêng bạn, ẩn nút cho đến khi DropComments.ready báo đã nhận được token. Nút sẽ mở bảng góp ý cho nhóm và biểu mẫu ngắn cho những người còn lại:

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

    Đặt nút ở bất kỳ đâu phù hợp với ứng dụng: phần đầu trang, menu hay màn hình cài đặt. Bảng góp ý, biểu mẫu và các ghim do script cung cấp.

  6. Nếu các trang của bạn gửi Content-Security-Policy, hãy cho phép DropComments:

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

Hoặc để agent lập trình làm giúp bạn. Sau khi thêm ứng dụng, bạn sẽ thấy bản hướng dẫn đã có sẵn khóa và id các dự án; dán nội dung đó cho agent đang xây dựng ứng dụng để agent thêm endpoint, script và nút.

Tài liệu tham khảo

Token

Máy chủ của bạn gọi POST https://dropcomments.com/api/app/token với khóa của ứng dụng làm bearer token. Bắt buộc có project, được xác định bằng id. user là người đang đăng nhập; nếu không truyền tên, bảng góp ý sẽ yêu cầu họ nhập tên. team quyết định họ được dùng những công cụ nào. Token có hiệu lực trong một giờ, và script sẽ yêu cầu endpoint của bạn cấp token mới trước khi token cũ hết hạn.

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

Tùy chọn script

data-token-url là endpoint của bạn, được gọi kèm cookie của trang; endpoint có thể trả về JSON của token hoặc token dưới dạng văn bản thuần. data-ui="none" không hiển thị gì, để bạn dùng biểu mẫu riêng: gửi dữ liệu biểu mẫu thu thập được bằng DropComments.send(). Khi gửi từ máy tính, bình luận của nhóm kèm cả bản sao trang bên cạnh ảnh chụp: trong Drop, nút xem trang mở bản sao có thể cuộn và chọn văn bản, còn agent có thể đọc nội dung chữ trên đó. data-capture="picture" chỉ gửi ảnh chụp. Điện thoại và máy tính bảng luôn chỉ gửi ảnh chụp.

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

JavaScript

Mọi thứ đều có trên window.DropComments sau khi script tải xong. ready cho biết đã nhận được token hay chưa, để bạn chỉ hiển thị nút khi đã có token.

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

Giao diện ứng dụng của bạn

Bạn toàn quyền định kiểu cho nút Góp ý của mình. Đặt các biến này trên :root để bảng góp ý, biểu mẫu và các ghim cũng dùng chúng. Các biến còn lại: --dc-muted, --dc-line, --dc-soft, --dc-on-accent, --dc-accent-text, --dc-pin, --dc-on-pin và --dc-button-radius.

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

Giữ riêng tư

Bình luận có kèm ảnh chụp màn hình nên ảnh sẽ hiển thị nội dung trên màn hình, kể cả văn bản đã nhập (mật khẩu hiện dưới dạng dấu chấm). Đánh dấu mọi nội dung tuyệt đối không được gửi ra khỏi ứng dụng: chúng sẽ thành ô màu xám trong ảnh và bị loại khỏi bản sao trang. Bản sao không chứa script và để trống các trường nhập liệu.

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

Bạn nhận được gì

Nhóm của bạn thử nghiệm bản dựng

Ghim, khoanh vùng hoặc vẽ trên ứng dụng đang chạy, bằng máy tính hay điện thoại. Mỗi bình luận kèm ảnh chụp màn hình có đánh dấu vị trí, và nếu gửi từ máy tính thì có cả bản sao trang, nên chỉ cần nói “chỗ này bị lỗi” là đủ.

Người dùng ứng dụng

Một biểu mẫu ngắn với tùy chọn Chỉ vị trí và ảnh chụp màn hình. Họ không bao giờ thấy góp ý của người khác, và ảnh của họ chỉ được gửi khi họ giữ nguyên dấu chọn.

Người thử nghiệm beta và khách hàng

Cho những người cùng bạn thử nghiệm đăng nhập và quyết định ai được tính là thành viên nhóm. Khách hàng duyệt trang trên môi trường staging có thể để lại ghi chú ngay trên đó.

Để agent sửa

Agent lập trình kết nối với DropComments đọc từng bình luận cùng trang nơi bình luận được tạo, thực hiện thay đổi rồi trả lời. Câu trả lời hiện ngay trong ứng dụng.

Đồng bộ với giao diện ứng dụng

Biểu mẫu dành cho người dùng lấy màu sắc, phông chữ và kiểu bo góc của bạn qua vài biến CSS. Hoặc dùng biểu mẫu riêng và gửi bằng một lệnh gọi.

Khóa luôn do bạn giữ

Khóa nằm trên máy chủ của bạn, không bao giờ nằm trong trang. Góp ý chỉ được tiếp nhận từ các địa chỉ của ứng dụng, có giới hạn theo từng người, và mỗi dự án được chọn bằng id.

Đưa vào Hộp thư

Mỗi phản hồi được đưa vào Hộp thư của dự án dưới dạng phiếu công việc, sẵn sàng để có người nhận xử lý.

Câu hỏi

Có dùng được với mọi ứng dụng không?

Mọi ứng dụng web có máy chủ và người dùng đăng nhập đều dùng được: máy chủ cho DropComments biết từng người là ai. Trò chơi và các ứng dụng khác được vẽ trên canvas cũng dùng được; nội dung trên canvas được gửi dưới dạng ảnh chụp.

Bình luận của thành viên nhóm gửi kèm những gì?

Một ảnh chụp màn hình tại thời điểm đó, với mọi nội dung bạn đánh dấu data-dc-hide được phủ xám. Nếu gửi từ máy tính, còn có một bản sao của trang bên cạnh (trừ khi bạn đặt data-capture="picture"): chứa sẵn các kiểu định dạng và hình ảnh, không có mã script, để trống các ô đã nhập và bỏ mọi nội dung được đánh dấu data-dc-hide, kèm một ảnh chụp vị trí đó. Drop hiển thị ảnh chụp, còn trên máy tính, bạn có thể chuyển sang xem trang. Ảnh được script dựng từ bố cục trang nên gần giống nhưng không hoàn toàn chính xác: các phép biến đổi, bộ lọc và nội dung ::before hoặc ::after đều hiển thị ở dạng thông thường. Màn hình đó cũng lưu thông tin nơi tạo: địa chỉ trang (không có phần #fragment), tiêu đề trang, kích thước cửa sổ và trình duyệt.

Tôi có thể tách riêng góp ý của khách hàng và của nhóm không?

Có. Một ứng dụng có thể gửi vào nhiều dự án, và máy chủ của ứng dụng sẽ chỉ định dự án cho từng người, để góp ý của nhóm vào một dự án và của những người khác vào một dự án khác.

Chi phí là bao nhiêu?

Tính năng này có trong mọi gói. Với gói miễn phí, mỗi Drop góp ý mở nhận bình luận trong một ngày, sau đó một Drop mới sẽ được tạo; Pro giữ các Drop mở.

Đọc tiếp

Thử với tệp tiếp theo của bạn

Chỉ mất khoảng mười giây để có liên kết.

Thả tệp vào