รับข้อเสนอแนะในแอปของคุณ
DropComments SDK
รับความคิดเห็นภายในแอปที่คุณกำลังสร้าง ด้วยแท็กสคริปต์หนึ่งแท็ก เอนด์พอยต์หนึ่งจุดบนเซิร์ฟเวอร์ และปุ่มแสดงความคิดเห็นที่คุณสร้างเอง ทีมของคุณปักหมุดความคิดเห็น วาดกรอบ หรือวาดรูปลงบนแอปได้โดยตรง ส่วนผู้ใช้ส่งความคิดเห็นผ่านแบบฟอร์มสั้น ๆ ทุกอย่างจะเข้ามาในโปรเจกต์ของคุณที่นี่ ให้คุณและเอเจนต์ AI ตอบกลับได้
ติดตั้ง SDKเริ่มใช้ได้ฟรี คีย์ของแอปจะอยู่บนเซิร์ฟเวอร์ของคุณ
การให้ความคิดเห็นเกี่ยวกับแอปไม่ควรต้องเริ่มจากการถ่ายภาพหน้าจอ
เมื่อคนที่ทดสอบแอปเจออะไรบางอย่าง พวกเขาต้องถ่ายภาพหน้าจอ ครอบภาพ วางในแชต แล้วเขียนว่า “ตรงด้านบนของหน้าจอที่สอง” คุณก็ต้องไปหาหน้าจอนั้น แล้วเดาว่าหมายถึงตรงไหน
เมื่อมีสคริปต์อยู่ในแอป พวกเขาก็ชี้ตรงจุดนั้นได้เลย ความคิดเห็นจะมาพร้อมภาพหน้าจอในตอนนั้น เครื่องหมายระบุตำแหน่ง และชื่อผู้ส่ง พร้อมให้คุณหรือเอเจนต์เขียนโค้ดแก้ไข แล้วคำตอบก็จะแสดงในแอป
วิธีใช้งาน
- 1
เพิ่มแอปของคุณ
ในบัญชีของคุณ ไปที่แอป แล้วระบุชื่อแอป ที่อยู่ที่แอปทำงานอยู่ และโปรเจกต์ที่จะรับความคิดเห็น เช่น โปรเจกต์หนึ่งสำหรับทีม อีกโปรเจกต์สำหรับลูกค้า จากนั้นแอปจะได้รับคีย์
- 2
เพิ่มสคริปต์
เซิร์ฟเวอร์ของแอปจะเก็บคีย์ไว้ และส่งโทเคนอายุสั้นให้หน้าเว็บสำหรับผู้ที่เข้าสู่ระบบอยู่ โดยระบุด้วยว่าเป็นสมาชิกทีมของคุณหรือไม่ หน้าเว็บโหลดแท็กสคริปต์หนึ่งแท็ก และใช้ปุ่มแสดงความคิดเห็นของคุณเองเปิดใช้งาน คัดลอกสิ่งที่ DropComments แสดงให้ไปวางให้เอเจนต์ที่กำลังสร้างแอป แล้วเอเจนต์จะเพิ่มให้
- 3
ความคิดเห็นส่งเข้ามา
ทีมของคุณกดแสดงความคิดเห็น ปักหมุดตรงจุด แล้วเขียนข้อความ ทุกคนในทีมจะเห็นหมุดของกันและกันบนแอปและทุกคำตอบแบบเรียลไทม์ ส่วนคนอื่นจะเห็นแบบฟอร์มสั้น ๆ แต่ละรายการจะเข้ามาเป็นหน้าจอหนึ่งของ Drop ในโปรเจกต์ที่กำหนด
ติดตั้ง SDK
สำหรับเว็บแอปที่มีเซิร์ฟเวอร์และมีผู้ใช้เข้าสู่ระบบ ไม่ต้องติดตั้งแพ็กเกจ เพียงมีคีย์บนเซิร์ฟเวอร์ เอนด์พอยต์ที่ส่งโทเคนให้หน้าเว็บ แท็กสคริปต์ และปุ่มที่คุณสร้างเองเพื่อเปิดใช้งาน
เพิ่มแอปของคุณใน DropComments ที่เมนูแอป โดยระบุชื่อ ที่อยู่ที่แอปทำงานอยู่ (https หรือ http บน localhost และ .test ระหว่างพัฒนา) และโปรเจกต์ที่จะรับความคิดเห็น คุณจะได้รับคีย์ของแอปและ id ของแต่ละโปรเจกต์
เก็บคีย์ไว้บนเซิร์ฟเวอร์ของคุณ ในตัวแปรสภาพแวดล้อมหรือที่เก็บความลับ:
DROPCOMMENTS_KEY=dc_app_…
ห้ามใส่ไว้ในหน้าเว็บ ในโค้ดที่ส่งถึงเบราว์เซอร์ หรือในคอมมิต DropComments จะปฏิเสธคีย์ที่ส่งจากเบราว์เซอร์
เพิ่มเอนด์พอยต์โทเคน เอนด์พอยต์นี้จะขอโทเคนจาก 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 เดียวกันกลับไป
โหลดสคริปต์ในทุกหน้า ก่อน
</body>:<script src="https://dropcomments.com/live.js" data-token-url="/api/feedback-token"></script>
สคริปต์ไม่ได้สร้างปุ่มให้ จึงยังไม่มีอะไรแสดงขึ้นมา
เพิ่มปุ่มแสดงความคิดเห็นของคุณเอง โดยซ่อนไว้จนกว่า
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()); }วางปุ่มตรงไหนก็ได้ที่เหมาะกับแอป เช่น ส่วนหัว เมนู หรือหน้าการตั้งค่า ส่วนแผง แบบฟอร์ม และหมุดมาจากสคริปต์
หากหน้าเว็บของคุณส่ง 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 จะเปิดรับไว้ต่อเนื่อง
อ่านต่อ
ลองใช้กับไฟล์ถัดไปของคุณ
ใช้เวลาประมาณสิบวินาทีก็ได้ลิงก์แล้ว
วางไฟล์