DropComments

รับข้อเสนอแนะในแอปของคุณ

DropComments SDK

รับความคิดเห็นภายในแอปที่คุณกำลังสร้าง ด้วยแท็กสคริปต์หนึ่งแท็ก เอนด์พอยต์หนึ่งจุดบนเซิร์ฟเวอร์ และปุ่มแสดงความคิดเห็นที่คุณสร้างเอง ทีมของคุณปักหมุดความคิดเห็น วาดกรอบ หรือวาดรูปลงบนแอปได้โดยตรง ส่วนผู้ใช้ส่งความคิดเห็นผ่านแบบฟอร์มสั้น ๆ ทุกอย่างจะเข้ามาในโปรเจกต์ของคุณที่นี่ ให้คุณและเอเจนต์ AI ตอบกลับได้

ติดตั้ง SDK

เริ่มใช้ได้ฟรี คีย์ของแอปจะอยู่บนเซิร์ฟเวอร์ของคุณ

การให้ความคิดเห็นเกี่ยวกับแอปไม่ควรต้องเริ่มจากการถ่ายภาพหน้าจอ

เมื่อคนที่ทดสอบแอปเจออะไรบางอย่าง พวกเขาต้องถ่ายภาพหน้าจอ ครอบภาพ วางในแชต แล้วเขียนว่า “ตรงด้านบนของหน้าจอที่สอง” คุณก็ต้องไปหาหน้าจอนั้น แล้วเดาว่าหมายถึงตรงไหน

เมื่อมีสคริปต์อยู่ในแอป พวกเขาก็ชี้ตรงจุดนั้นได้เลย ความคิดเห็นจะมาพร้อมภาพหน้าจอในตอนนั้น เครื่องหมายระบุตำแหน่ง และชื่อผู้ส่ง พร้อมให้คุณหรือเอเจนต์เขียนโค้ดแก้ไข แล้วคำตอบก็จะแสดงในแอป

วิธีใช้งาน

  1. 1

    เพิ่มแอปของคุณ

    ในบัญชีของคุณ ไปที่แอป แล้วระบุชื่อแอป ที่อยู่ที่แอปทำงานอยู่ และโปรเจกต์ที่จะรับความคิดเห็น เช่น โปรเจกต์หนึ่งสำหรับทีม อีกโปรเจกต์สำหรับลูกค้า จากนั้นแอปจะได้รับคีย์

  2. 2

    เพิ่มสคริปต์

    เซิร์ฟเวอร์ของแอปจะเก็บคีย์ไว้ และส่งโทเคนอายุสั้นให้หน้าเว็บสำหรับผู้ที่เข้าสู่ระบบอยู่ โดยระบุด้วยว่าเป็นสมาชิกทีมของคุณหรือไม่ หน้าเว็บโหลดแท็กสคริปต์หนึ่งแท็ก และใช้ปุ่มแสดงความคิดเห็นของคุณเองเปิดใช้งาน คัดลอกสิ่งที่ DropComments แสดงให้ไปวางให้เอเจนต์ที่กำลังสร้างแอป แล้วเอเจนต์จะเพิ่มให้

  3. 3

    ความคิดเห็นส่งเข้ามา

    ทีมของคุณกดแสดงความคิดเห็น ปักหมุดตรงจุด แล้วเขียนข้อความ ทุกคนในทีมจะเห็นหมุดของกันและกันบนแอปและทุกคำตอบแบบเรียลไทม์ ส่วนคนอื่นจะเห็นแบบฟอร์มสั้น ๆ แต่ละรายการจะเข้ามาเป็นหน้าจอหนึ่งของ Drop ในโปรเจกต์ที่กำหนด

ติดตั้ง SDK

สำหรับเว็บแอปที่มีเซิร์ฟเวอร์และมีผู้ใช้เข้าสู่ระบบ ไม่ต้องติดตั้งแพ็กเกจ เพียงมีคีย์บนเซิร์ฟเวอร์ เอนด์พอยต์ที่ส่งโทเคนให้หน้าเว็บ แท็กสคริปต์ และปุ่มที่คุณสร้างเองเพื่อเปิดใช้งาน

  1. เพิ่มแอปของคุณใน DropComments ที่เมนูแอป โดยระบุชื่อ ที่อยู่ที่แอปทำงานอยู่ (https หรือ http บน localhost และ .test ระหว่างพัฒนา) และโปรเจกต์ที่จะรับความคิดเห็น คุณจะได้รับคีย์ของแอปและ id ของแต่ละโปรเจกต์

    เพิ่มแอปของคุณ

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

    ตัวอย่างนี้เขียนเป็น route handler ของ 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;

หรือให้เอเจนต์เขียนโค้ดจัดการให้ เมื่อเพิ่มแอปแล้ว คุณจะเห็นคำแนะนำที่ใส่คีย์และ id โปรเจกต์ไว้ให้แล้ว คัดลอกไปวางให้เอเจนต์ที่กำลังสร้างแอป แล้วเอเจนต์จะเพิ่มเอนด์พอยต์ สคริปต์ และปุ่มให้

เอกสารอ้างอิง

โทเคน

เซิร์ฟเวอร์ของคุณเรียก POST https://dropcomments.com/api/app/token โดยใช้คีย์ของแอปเป็น bearer token ต้องระบุ 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 คือเอนด์พอยต์ของคุณ ซึ่งจะถูกเรียกพร้อมคุกกี้ของหน้าเว็บ โดยตอบกลับเป็น 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 ที่รับความคิดเห็นแต่ละรายการจะเปิดรับเป็นเวลา 1 วัน แล้วจึงเริ่มรายการใหม่ ส่วน Pro จะเปิดรับไว้ต่อเนื่อง

อ่านต่อ

ลองใช้กับไฟล์ถัดไปของคุณ

ใช้เวลาประมาณสิบวินาทีก็ได้ลิงก์แล้ว

วางไฟล์