DropComments

Uygulamanızın içinde geri bildirim

DropComments SDK

Tek bir betik etiketi, sunucunuzda bir uç nokta ve kendi Geri Bildirim düğmenizle geliştirdiğiniz uygulamanın içinde geri bildirim alın. Ekibiniz doğrudan uygulamanın üzerine yorum veya kutu sabitleyebilir, çizim yapabilir; kullanıcılarınız ise kısa bir formla geri bildirim gönderebilir. Hepsi burada, projelerinizde toplanır; siz ve yapay zekâ ajanınız da buradan yanıt verirsiniz.

SDK’yı yükleyin

Başlamak ücretsiz. Uygulamanızın anahtarı sunucunuzda kalır.

Bir uygulama hakkındaki geri bildirim ekran görüntüsüyle başlamamalı

Uygulamanızı test eden biri bir sorun bulduğunda ekran görüntüsü alır, kırpar, sohbete yapıştırır ve “ikinci ekranda, üstteki şey” diye yazar. Siz de o ekranı bulup hangi şeyi kastettiğini tahmin etmeye çalışırsınız.

Betik uygulamanın içindeyken doğrudan ilgili yeri işaretlerler. Yorum; ekranın o anki görüntüsü, işaretlenmiş konum ve gönderenin bilgisiyle gelir. Siz veya bir kodlama ajanı sorunu çözmeye başlayabilirsiniz; yanıt da uygulamanın içinde görünür.

Nasıl çalışır?

  1. 1

    Uygulamanızı ekleyin

    Hesabınızın Uygulamalar bölümüne adını, çalıştığı adresleri ve geri bildirimlerin gideceği projeleri girin; örneğin ekibiniz için bir proje, müşterileriniz için başka bir proje. Uygulamanıza bir anahtar verilir.

  2. 2

    Betiği ekleyin

    Uygulamanızın sunucusu anahtarı saklar ve sayfaya, oturum açan kişinin ekibinizden olup olmadığını belirten kısa ömürlü bir token verir. Sayfa tek bir betik etiketi yükler; kendi Geri Bildirim düğmeniz de arayüzü açar. DropComments'ın gösterdiği talimatları uygulamanızı geliştiren ajana yapıştırın, gerekenleri eklesin.

  3. 3

    Geri bildirimler gelsin

    Ekibiniz Geri Bildirim'e basar, ilgili noktaya bir işaret sabitler ve yazar; uygulama üzerinde herkesin işaretlerini ve tüm yanıtları anında görür. Diğer herkese kısa bir form açılır. Her geri bildirim, ilgili projedeki bir Drop'un ekranı olarak kaydedilir.

SDK’yı yükleyin

Sunucusu olan ve kullanıcıların oturum açtığı web uygulamaları için. Kurulacak paket yok: sunucunuzda bir anahtar, sayfaya token veren bir uç nokta, bir betik etiketi ve arayüzü açan kendi düğmeniz yeterli.

  1. DropComments'ın Uygulamalar bölümünde uygulamanızı ekleyin: adını, çalıştığı adresleri (https veya geliştirme sırasında localhost ve .test üzerinde http) ve geri bildirimlerin gideceği projeleri girin. Uygulamanızın anahtarını ve her projenin kimliğini alırsınız.

    Uygulamanızı ekleyin

  2. Anahtarı sunucunuzda saklayın; ortam değişkenlerinde veya gizli bilgiler bölümünde:

    DROPCOMMENTS_KEY=dc_app_…

    Asla bir sayfaya, tarayıcıya ulaşan koda veya bir commit'e koymayın. DropComments, tarayıcıdan gelen bu anahtarı kabul etmez.

  3. Bir token uç noktası ekleyin. Oturum açan kişi için DropComments'tan token istesin ve gelen JSON'u olduğu gibi döndürsün. Oturum açan kimse yoksa 401 yanıtı verin; hiçbir şey görünmez.

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

    Örnek, Next.js rota işleyicisi olarak yazılmıştır; Worker, Deno veya Bun'da da aynıdır. Express'te aynı durum kodunu ve JSON'u döndürün.

  4. Her sayfada, </body> etiketinden önce betiği yükleyin:

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

    Kendi düğmesini oluşturmadığı için henüz hiçbir şey görünmez.

  5. DropComments.ready token'ın geldiğini bildirene kadar gizli kalan, ekibiniz için paneli ve diğer herkes için kısa formu açan kendi Geri Bildirim düğmenizi ekleyin:

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

    Uygulamanıza uygun bir yere koyun: üst bilgiye, menüye veya ayarlar ekranına. Paneli, formu ve konum işaretlerini betik sağlar.

  6. Sayfalarınız Content-Security-Policy gönderiyorsa DropComments'a izin verin:

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

Ya da bunu kodlama ajanınıza bırakın. Uygulamanızı eklediğinizde, anahtarınızın ve proje kimliklerinizin hazır bulunduğu bir talimat metni gösterilir. Bunu uygulamanızı geliştiren ajana yapıştırın; uç noktayı, betiği ve düğmeyi eklesin.

Başvuru kaynağı

Token

Sunucunuz, uygulamanın anahtarını bearer token olarak kullanıp POST https://dropcomments.com/api/app/token çağrısı yapar. project zorunludur ve kimlikle belirtilir. user oturum açan kişidir; adı eklemezseniz panel bir ad ister. team kişinin hangi araçları kullanabileceğini belirler. Token bir saat geçerlidir; betik, süresi dolmadan önce uç noktanızdan yenisini ister.

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

Betik seçenekleri

data-token-url, sayfanın çerezleriyle istek yapılan uç noktanızdır; token'ın JSON'unu veya token'ı düz metin olarak döndürebilir. Kendi formunuzu kullanmanız için data-ui="none" hiçbir şey göstermez: formun topladıklarını DropComments.send() ile gönderin. Bilgisayardan gönderilen ekip yorumları, görüntünün yanında sayfanın bir kopyasını da içerir: Drop'taki sayfa düğmesi bu kopyayı kaydırılabilir ve metni seçilebilir şekilde gösterir; bir ajan da içindeki metni okuyabilir. data-capture="picture" yalnızca görüntüyü gönderir. Telefon ve tabletlerde her zaman yalnızca görüntü gönderilir.

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

JavaScript

Betik yüklendiğinde her şey window.DropComments üzerinde bulunur. ready token'ın gelip gelmediğini belirtir; böylece düğmenizi yalnızca geldiğinde gösterirsiniz.

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

Uygulamanızın görünümü

Geri Bildirim düğmenizi dilediğiniz gibi biçimlendirebilirsiniz. Bunları :root üzerinde ayarlayın; panel, form ve konum işaretleri de aynı değerleri kullanır. Diğerleri: --dc-muted, --dc-line, --dc-soft, --dc-on-accent, --dc-accent-text, --dc-pin, --dc-on-pin ve --dc-button-radius.

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

Bilgileri gizli tutmak

Yorum, ekranın bir görüntüsünü içerir; bu yüzden yazılan metinler dâhil ekrandakiler görünür (parolalar nokta olarak gösterilir). Uygulamanızdan asla çıkmaması gereken her şeyi işaretleyin; görüntüde gri bir kutu olarak görünür ve sayfanın kopyasına eklenmez. Kopyada betik bulunmaz ve yazı girilen alanlar boş bırakılır.

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

Neler sunar?

Bir sürümü test eden ekibiniz

Bilgisayarda veya telefonda, çalışan uygulamanın üzerine konum işareti ya da kutu ekleyin, çizim yapın. Her yorum, ilgili noktanın işaretlendiği bir ekran görüntüsü içerir; bilgisayardan gönderildiyse sayfanın bir kopyası da eklenir. Böylece “burası bozuk” demek yeter.

Uygulamanızı kullananlar

“Yerini işaretle” seçeneği ve ekran görüntüsü içeren kısa bir form. Başkalarının geri bildirimlerini asla görmezler; ekran görüntüleri de yalnızca ilgili kutuyu işaretli bırakırlarsa gönderilir.

Beta test kullanıcıları ve müşteriler

Uygulamayı birlikte denediğiniz kişilerin oturum açmasını sağlayın ve kimlerin ekipten sayılacağına karar verin. Test ortamındaki siteyi inceleyen bir müşteri, notlarını doğrudan siteye bırakır.

Ajanın yaptığı düzeltmeler

DropComments'a bağlı bir kodlama ajanı her yorumu ve yorumun yapıldığı sayfayı okur, değişikliği yapar ve yanıt verir. Yanıt uygulamanın içinde görünür.

Uygulamanızla aynı görünümde

Kullanıcı formu, birkaç CSS değişkeninden renklerinizi, yazı tipinizi ve köşe biçiminizi alır. İsterseniz kendi formunuzu kullanıp tek bir çağrıyla gönderebilirsiniz.

Anahtarınız sizde kalır

Anahtar sunucunuzda saklanır, asla bir sayfada bulunmaz. Geri bildirimler yalnızca uygulamanızın adreslerinden alınır, kişi başına sınırlandırılır ve her proje kimliğiyle seçilir.

Gelen Kutunuza gelsin

Her geri bildirim, birinin üstlenmesi için projesinin Gelen Kutusuna iş kaydı olarak gelir.

Sorular

Her uygulamada çalışır mı?

Sunucusu olan ve kullanıcıların oturum açtığı her web uygulamasında çalışır: sunucu, DropComments'a her kişinin kim olduğunu bildirir. Oyunlar ve canvas üzerine çizilen diğer uygulamalar da desteklenir; tuvalin içeriği görüntü olarak iletilir.

Bir ekip yorumu neler gönderir?

Ekranın o anki görüntüsü; data-dc-hide ile işaretlediğiniz her şey grileştirilir. Bilgisayardan gönderildiğinde, yanına sayfanın bir kopyası da eklenir (data-capture="picture" ayarlamadıysanız): stilleri ve görselleri içinde yer alır, betikler bulunmaz, doldurulmuş alanlar boş bırakılır ve data-dc-hide ile işaretlenenler çıkarılır. Ayrıca ilgili noktanın bir görüntüsü de eklenir. Drop görüntüyü gösterir; masaüstünde sayfa görünümüne geçilebilir. Görüntüyü betik, sayfanın düzeninden oluşturur; bu yüzden aslına yakındır ama birebir değildir: dönüşümler, filtreler ve ::before veya ::after içeriği sade biçimde görünür. Ekran ayrıca nerede oluşturulduğunu da saklar: sayfanın adresi (#fragment kısmı olmadan), başlığı, pencere boyutu ve tarayıcı.

Müşterilerin ve ekibin geri bildirimlerini ayrı tutabilir miyim?

Evet. Bir uygulama birden fazla projeye gönderim yapabilir ve sunucusu her kişi için hangi projenin kullanılacağını belirtir. Böylece ekibin geri bildirimleri bir projeye, diğer herkesinki başka bir projeye gider.

Ücreti ne kadar?

Tüm planlara dahildir. Ücretsiz planda her geri bildirim Drop’u bir gün boyunca yoruma açık kalır, ardından yenisi başlar; Pro ise açık tutar.

Okumaya devam edin

Bir sonraki dosyanızla deneyin

Bağlantı oluşturmak yaklaşık on saniye sürer.

Bir dosya bırakın