DropComments

Masukan di dalam aplikasi Anda

DropComments SDK

Terima masukan di dalam aplikasi yang sedang Anda bangun dengan satu tag skrip, satu endpoint di server Anda, dan tombol Masukan buatan Anda sendiri. Tim Anda menyematkan komentar, kotak, atau gambar langsung pada aplikasi, sementara penggunanya mengirim masukan lewat formulir singkat. Semuanya masuk ke proyek Anda di sini, tempat Anda dan agen AI Anda membalas.

Instal SDK

Gratis untuk mulai. Kunci aplikasi Anda tetap tersimpan di server Anda.

Masukan tentang aplikasi seharusnya tak perlu diawali dengan tangkapan layar

Saat orang yang menguji aplikasi Anda menemukan sesuatu, mereka mengambil tangkapan layar, memotongnya, menempelkannya di obrolan, lalu menulis “yang di atas itu, di layar kedua”. Anda pun mencari layar tersebut dan menebak bagian mana yang dimaksud.

Dengan skrip di dalam aplikasi, mereka menunjuk langsung ke tempatnya. Komentar masuk beserta gambar layar saat itu, lokasi yang ditandai, dan identitas pengirimnya, siap ditangani oleh Anda atau agen pemrograman. Balasannya muncul di dalam aplikasi.

Cara kerja

  1. 1

    Tambahkan aplikasi Anda

    Di akun Anda, pada bagian Aplikasi: masukkan nama aplikasi, alamat tempat aplikasi berjalan, dan proyek tujuan masukannya, misalnya satu untuk tim dan satu untuk pelanggan. Aplikasi akan mendapat kunci.

  2. 2

    Tambahkan skrip

    Server aplikasi menyimpan kunci dan memberikan token berumur singkat ke halaman untuk siapa pun yang sedang masuk, dengan keterangan apakah mereka anggota tim Anda. Halaman memuat satu tag skrip, dan tombol Masukan buatan Anda membukanya. Tempelkan petunjuk yang ditampilkan DropComments ke agen yang membangun aplikasi Anda, lalu agen akan menambahkannya.

  3. 3

    Masukan masuk

    Tim Anda menekan Masukan, menyematkannya di lokasi yang dimaksud, lalu menulis; mereka melihat semua sematan dan balasan di aplikasi secara langsung. Pengguna lain mendapat formulir singkat. Setiap masukan masuk sebagai layar dalam sebuah Drop di proyeknya.

Instal SDK

Untuk aplikasi web yang memiliki server dan pengguna yang masuk ke akun. Tidak ada paket yang perlu dipasang: cukup kunci di server Anda, endpoint yang memberikan token ke halaman, tag skrip, dan tombol buatan Anda sendiri untuk membukanya.

  1. Tambahkan aplikasi Anda di DropComments, pada bagian Aplikasi: nama aplikasi, alamat tempat aplikasi berjalan (https, atau http pada localhost dan .test selama pengembangan), serta proyek tujuan masukannya. Anda akan mendapat kunci aplikasi dan id setiap proyek.

    Tambahkan aplikasi Anda

  2. Simpan kunci di server Anda, dalam variabel lingkungan atau penyimpanan rahasianya:

    DROPCOMMENTS_KEY=dc_app_…

    Jangan pernah menyimpannya di halaman, kode yang dikirim ke browser, atau commit. DropComments menolak kunci yang dikirim dari browser.

  3. Tambahkan endpoint token. Untuk siapa pun yang sedang masuk, endpoint ini meminta token ke DropComments dan mengembalikan JSON-nya apa adanya. Jika tidak ada yang masuk, kirim respons 401 dan tidak ada yang ditampilkan.

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

    Ditulis sebagai route handler Next.js; caranya sama di Worker, Deno, atau Bun. Di Express, kembalikan status dan JSON yang sama.

  4. Muat skrip di setiap halaman, sebelum </body>:

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

    Skrip tidak menampilkan tombol sendiri, jadi belum ada yang terlihat.

  5. Tambahkan tombol Masukan Anda sendiri, yang disembunyikan hingga DropComments.ready menyatakan token sudah diterima. Tombol ini membuka panel untuk tim Anda dan formulir singkat untuk pengguna lain:

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

    Letakkan di tempat yang sesuai dengan aplikasi Anda: header, menu, atau layar pengaturan. Panel, formulir, dan sematan disediakan oleh skrip.

  6. Jika halaman Anda mengirim Content-Security-Policy, izinkan DropComments:

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

Atau serahkan kepada agen pemrograman Anda. Setelah aplikasi ditambahkan, akan muncul petunjuk yang sudah berisi kunci dan id proyek Anda; tempelkan ke agen yang membangun aplikasi Anda, lalu agen akan menambahkan endpoint, skrip, dan tombolnya.

Referensi

Token

Server Anda memanggil POST https://dropcomments.com/api/app/token dengan kunci aplikasi sebagai bearer token. project wajib diisi dengan id proyek. user adalah siapa pun yang sedang masuk; jika nama tidak disertakan, panel akan memintanya. team menentukan alat yang tersedia bagi mereka. Token berlaku selama satu jam, dan skrip meminta token baru ke endpoint Anda sebelum masa berlakunya habis.

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

Opsi skrip

data-token-url adalah endpoint Anda, yang diakses menggunakan cookie halaman; endpoint dapat mengembalikan JSON token atau token sebagai teks biasa. data-ui="none" tidak menampilkan apa pun, agar Anda bisa memakai formulir sendiri: kirim data yang dikumpulkannya dengan DropComments.send(). Dari komputer, komentar tim menyertakan salinan halaman beserta gambarnya: di dalam Drop, tombol halaman menampilkan salinan yang bisa digulir dan teksnya bisa dipilih, serta agen bisa membaca isinya. data-capture="picture" hanya mengirim gambar. Ponsel dan tablet selalu hanya mengirim gambar.

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

JavaScript

Semuanya tersedia di window.DropComments setelah skrip dimuat. ready menyatakan apakah token sudah diterima, jadi tampilkan tombol Anda hanya setelah itu.

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

Tampilan aplikasi Anda

Anda bebas mengatur gaya tombol Masukan Anda. Tetapkan variabel ini pada :root, lalu panel, formulir, dan sematan juga akan menggunakannya. Variabel lainnya: --dc-muted, --dc-line, --dc-soft, --dc-on-accent, --dc-accent-text, --dc-pin, --dc-on-pin, dan --dc-button-radius.

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

Menjaga privasi

Komentar menyertakan gambar layar, jadi apa pun yang ada di layar akan terlihat, termasuk teks yang diketik (kata sandi tampil sebagai titik). Tandai apa pun yang tidak boleh keluar dari aplikasi Anda, dan bagian itu akan menjadi kotak abu-abu pada gambar serta tidak disertakan dalam salinan halaman. Salinan halaman tidak memiliki skrip, dan kolom isian yang telah diketik dibiarkan kosong.

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

Yang Anda dapatkan

Tim Anda, menguji versi aplikasi

Beri sematan, kotak, atau gambar pada aplikasi yang sedang berjalan, di komputer maupun ponsel. Setiap komentar menyertakan gambar layar dengan lokasi yang ditandai, serta salinan halaman jika dikirim dari komputer, jadi cukup tulis “bagian ini bermasalah”.

Orang yang menggunakannya

Formulir singkat dengan fitur Tunjuk bagiannya dan gambar layar. Mereka tidak pernah melihat masukan pengguna lain, dan gambar mereka hanya dikirim jika opsi gambarnya tetap dicentang.

Penguji beta dan klien

Minta orang yang ikut mencoba aplikasi untuk masuk, lalu tentukan siapa yang termasuk tim. Klien yang meninjau situs staging dapat meninggalkan catatan langsung di situs itu.

Diperbaiki oleh agen

Agen pemrograman yang terhubung ke DropComments membaca setiap komentar dan halaman tempat komentar dibuat, melakukan perubahan, lalu membalas. Balasannya muncul di dalam aplikasi.

Sesuai tampilan aplikasi Anda

Formulir pengguna mengikuti warna, font, dan bentuk sudut aplikasi Anda lewat beberapa variabel CSS, atau gunakan formulir sendiri dan kirim isinya dengan satu panggilan.

Kunci Anda tetap milik Anda

Kunci tersimpan di server Anda, tidak pernah di halaman. Masukan hanya diterima dari alamat aplikasi Anda, dibatasi per orang, dan setiap proyek dipilih berdasarkan id-nya.

Masuk ke Kotak masuk Anda

Setiap masukan masuk sebagai tiket di Kotak masuk proyeknya, siap diambil untuk ditangani.

Pertanyaan

Apakah bisa digunakan dengan aplikasi apa saja?

Semua aplikasi web yang memiliki server dan pengguna yang masuk ke akun: server memberi tahu DropComments identitas setiap orang. Game dan aplikasi lain yang digambar pada canvas juga bisa; area canvas dikirim sebagai gambar.

Apa saja yang dikirim bersama komentar tim?

Gambar layar seperti saat diambil, dengan semua yang Anda tandai data-dc-hide ditutupi warna abu-abu. Dari komputer, salinan halaman juga disertakan (kecuali Anda mengatur data-capture="picture"): lengkap dengan gaya tampilan dan gambarnya, tanpa skrip, kolom isian dikosongkan dan semua yang ditandai data-dc-hide dihilangkan, ditambah gambar area yang dimaksud. Drop menampilkan gambar tersebut, dan di komputer Anda bisa beralih ke halaman. Gambar dibuat oleh skrip berdasarkan tata letak halaman, jadi hasilnya mirip tetapi tidak persis: transformasi, filter, dan konten ::before atau ::after tampil tanpa efeknya. Layar tersebut juga menyimpan informasi tempat pembuatannya: alamat halaman (tanpa #fragment), judulnya, ukuran jendela, dan browser.

Bisakah saya memisahkan masukan pelanggan dan tim?

Bisa. Aplikasi dapat mengirim masukan ke beberapa proyek, dan servernya menentukan proyek untuk setiap orang, sehingga masukan tim masuk ke satu proyek dan masukan orang lain ke proyek lainnya.

Berapa biayanya?

Tersedia di semua paket. Di paket gratis, setiap Drop masukan terbuka selama satu hari, lalu Drop baru dimulai setelahnya; Pro membuatnya tetap terbuka.

Baca selengkapnya

Coba dengan file Anda berikutnya

Hanya perlu sekitar sepuluh detik untuk mendapatkan tautan.

Unggah file