DropComments

आपके ऐप के अंदर फ़ीडबैक

DropComments SDK

एक स्क्रिप्ट टैग, अपने सर्वर पर एक एंडपॉइंट और अपने फ़ीडबैक बटन से, जो ऐप आप बना रहे हैं उसी के भीतर फ़ीडबैक लें। आपकी टीम सीधे ऐप पर टिप्पणी, बॉक्स या ड्रॉइंग पिन करती है, और उसका इस्तेमाल करने वाले लोग एक छोटे फ़ॉर्म से फ़ीडबैक भेजते हैं। यह सब यहाँ आपके प्रोजेक्ट में आता है, जहाँ आप और आपका AI एजेंट जवाब देते हैं।

SDK इंस्टॉल करें

शुरुआत मुफ़्त है। आपके ऐप की कुंजी आपके सर्वर पर ही रहती है।

किसी ऐप पर फ़ीडबैक देने की शुरुआत स्क्रीनशॉट लेने से नहीं होनी चाहिए

आपका ऐप जाँचते समय किसी को कुछ दिखता है, तो वे स्क्रीनशॉट लेते हैं, उसे काटते हैं, चैट में चिपकाते हैं और लिखते हैं, “दूसरी स्क्रीन पर सबसे ऊपर वाली चीज़”। फिर आप वह स्क्रीन ढूँढ़ते हैं और अंदाज़ा लगाते हैं कि किस चीज़ की बात हो रही है।

ऐप में स्क्रिप्ट लगी हो, तो वे उसी जगह इशारा कर देते हैं। टिप्पणी के साथ उस समय की स्क्रीन की तस्वीर आती है, जिसमें जगह चिह्नित होती है और भेजने वाले का नाम होता है। इससे आप या कोई कोडिंग एजेंट उसे ठीक कर सकते हैं, और जवाब ऐप में दिखाई देता है।

यह कैसे काम करता है

  1. 1

    अपना ऐप जोड़ें

    अपने खाते में ऐप्स के तहत उसका नाम, वे पते जहाँ वह चलता है और वे प्रोजेक्ट जोड़ें जिनमें उसका फ़ीडबैक जाएगा—जैसे एक आपकी टीम के लिए और एक आपके ग्राहकों के लिए। ऐप को एक कुंजी मिलती है।

  2. 2

    स्क्रिप्ट जोड़ें

    ऐप का सर्वर कुंजी अपने पास रखता है और साइन इन किए हुए व्यक्ति के लिए पेज को थोड़े समय तक मान्य रहने वाला टोकन देता है, जिसमें यह बताया जाता है कि वे आपकी टीम में हैं या नहीं। पेज एक स्क्रिप्ट टैग लोड करता है, और आपका अपना फ़ीडबैक बटन उसे खोलता है। DropComments जो जानकारी दिखाता है, उसे अपना ऐप बनाने वाले एजेंट को पेस्ट करके दें और वह इन्हें जोड़ देगा।

  3. 3

    फ़ीडबैक आने लगता है

    आपकी टीम फ़ीडबैक दबाती है, सही जगह पिन लगाती है और लिखती है; उन्हें ऐप पर सभी के पिन और हर जवाब तुरंत दिखाई देते हैं। बाकी सभी को एक छोटा फ़ॉर्म मिलता है। हर फ़ीडबैक अपने प्रोजेक्ट में किसी Drop की स्क्रीन के रूप में आता है।

SDK इंस्टॉल करें

ऐसे वेब ऐप के लिए जिसमें सर्वर हो और लोग साइन इन करते हों। कोई पैकेज इंस्टॉल नहीं करना है: आपके सर्वर पर एक कुंजी, पेज को टोकन देने वाला एक एंडपॉइंट, एक स्क्रिप्ट टैग और उसे खोलने वाला आपका अपना बटन चाहिए।

  1. DropComments में ऐप्स के तहत अपना ऐप जोड़ें: उसका नाम, वे पते जहाँ वह चलता है (https, या बनाते समय localhost और .test पर http) और वे प्रोजेक्ट जिनमें उसका फ़ीडबैक जाएगा। आपको उसकी कुंजी और हर प्रोजेक्ट की आईडी मिलती है।

    अपना ऐप जोड़ें

  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;

या यह काम अपने कोडिंग एजेंट को करने दें। ऐप जोड़ने पर निर्देशों का एक संक्षिप्त विवरण दिखता है, जिसमें आपकी कुंजी और प्रोजेक्ट की आईडी पहले से होती हैं; इसे अपना ऐप बनाने वाले एजेंट को पेस्ट करके दें और वह एंडपॉइंट, स्क्रिप्ट और बटन जोड़ देगा।

संदर्भ

टोकन

आपका सर्वर ऐप की कुंजी को बेयरर टोकन बनाकर POST https://dropcomments.com/api/app/token को कॉल करता है। project देना ज़रूरी है, उसकी आईडी के रूप में। user वह व्यक्ति है जो साइन इन है; नाम न दें तो पैनल नाम पूछता है। team तय करता है कि उन्हें कौन-से टूल मिलेंगे। टोकन एक घंटे तक मान्य रहता है, और उसकी अवधि खत्म होने से पहले स्क्रिप्ट आपके एंडपॉइंट से नया टोकन माँग लेती है।

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

स्क्रिप्ट के विकल्प

data-token-url आपका एंडपॉइंट है, जिसे पेज की कुकीज़ के साथ अनुरोध भेजा जाता है; यह टोकन का 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 वेरिएबल से आपके रंग, फ़ॉन्ट और कोनों का आकार अपना लेता है। या अपना फ़ॉर्म इस्तेमाल करें और एक कॉल से उसकी जानकारी भेजें।

आपकी कुंजी आपके पास रहती है

कुंजी आपके सर्वर पर रहती है, कभी किसी पेज में नहीं। फ़ीडबैक केवल आपके ऐप के पतों से स्वीकार किया जाता है, हर व्यक्ति के लिए उसकी सीमा होती है, और हर प्रोजेक्ट उसकी आईडी से चुना जाता है।

सीधे आपके इनबॉक्स में

हर फ़ीडबैक अपने प्रोजेक्ट के इनबॉक्स में टिकट बनकर आता है, ताकि कोई उसकी ज़िम्मेदारी ले सके।

सवाल

क्या यह किसी भी ऐप के साथ काम करता है?

किसी भी ऐसे वेब ऐप के साथ जिसमें सर्वर हो और लोग साइन इन करते हों: सर्वर DropComments को बताता है कि हर व्यक्ति कौन है। गेम और कैनवस पर बनाए गए दूसरे ऐप भी काम करते हैं; बोर्ड तस्वीर के रूप में आता है।

टीम की टिप्पणी के साथ क्या भेजा जाता है?

स्क्रीन जैसी थी, उसकी एक तस्वीर, जिसमें data-dc-hide से चिह्नित हर चीज़ धूसर कर दी जाती है। कंप्यूटर से भेजने पर साथ में पेज की एक कॉपी भी मिलती है (जब तक आप data-capture="picture" सेट न करें): उसमें स्टाइल और तस्वीरें शामिल रहती हैं, लेकिन स्क्रिप्ट नहीं होतीं, भरे गए फ़ील्ड खाली कर दिए जाते हैं और data-dc-hide से चिह्नित चीज़ें हटा दी जाती हैं। साथ में उस जगह की एक तस्वीर भी होती है। Drop में तस्वीर दिखती है और डेस्कटॉप पर पेज देखने का विकल्प भी मिलता है। स्क्रिप्ट पेज के लेआउट से तस्वीर बनाती है, इसलिए वह काफ़ी मिलती-जुलती होती है, पर हूबहू नहीं: ट्रांसफ़ॉर्म, फ़िल्टर और ::before या ::after की सामग्री साधारण रूप में दिखती है। स्क्रीन के साथ यह जानकारी भी रहती है कि उसे कहाँ बनाया गया था: पेज का पता (उसके #fragment के बिना), उसका शीर्षक, विंडो का आकार और ब्राउज़र।

क्या मैं ग्राहकों और टीम की प्रतिक्रियाएँ अलग रख सकता हूँ?

हाँ। एक ऐप कई प्रोजेक्ट में प्रतिक्रियाएँ भेज सकता है। उसका सर्वर हर व्यक्ति के लिए प्रोजेक्ट तय करता है, ताकि टीम की प्रतिक्रियाएँ एक में और बाकी सभी की दूसरे में जाएँ।

इसकी कीमत क्या है?

यह हर प्लान में शामिल है। मुफ़्त प्लान में प्रतिक्रिया वाला हर Drop एक दिन तक टिप्पणियों के लिए खुला रहता है, फिर नया Drop शुरू होता है। Pro में वे खुले रहते हैं।

आगे पढ़ें

अपनी अगली फ़ाइल के साथ आज़माएँ

लिंक पाने में करीब दस सेकंड लगते हैं।

फ़ाइल डालें