আপনার অ্যাপের ভেতরেই মতামত
DropComments SDK
একটি স্ক্রিপ্ট ট্যাগ, আপনার সার্ভারে একটি এন্ডপয়েন্ট ও আপনার নিজস্ব মতামত বোতাম দিয়ে তৈরি করতে থাকা অ্যাপের ভেতরেই মতামত নিন। আপনার টিম অ্যাপের ওপরেই মন্তব্য, বক্স বা আঁকা দাগ পিন করে, আর ব্যবহারকারীরা ছোট একটি ফর্মে মতামত পাঠান। সবই এখানে আপনার প্রজেক্টগুলোতে জমা হয়, যেখানে আপনি ও আপনার AI এজেন্ট উত্তর দেন।
SDK ইনস্টল করুনবিনামূল্যে শুরু করুন। আপনার অ্যাপের কী আপনার সার্ভারেই থাকে।
অ্যাপ নিয়ে মতামত দেওয়ার শুরুতেই স্ক্রিনশট নিতে হওয়া উচিত নয়
আপনার অ্যাপ পরীক্ষা করতে গিয়ে কেউ কিছু পেলে স্ক্রিনশট নেন, কেটে ছোট করেন, চ্যাটে পেস্ট করেন আর লেখেন, “দ্বিতীয় স্ক্রিনের ওপরের জিনিসটা”। আপনি সেই স্ক্রিন খুঁজে বের করে আন্দাজ করেন, কোন জিনিসটার কথা বলা হচ্ছে।
অ্যাপে স্ক্রিপ্ট থাকলে তাঁরা জিনিসটা যেখানে আছে, সেখানেই দেখিয়ে দেন। মন্তব্যের সঙ্গে আসে তখনকার স্ক্রিনের ছবি, চিহ্নিত জায়গা ও প্রেরকের পরিচয়। আপনি বা কোনো কোডিং এজেন্ট তা দেখে ঠিক করতে পারেন, আর উত্তরটি অ্যাপেই দেখা যায়।
যেভাবে কাজ করে
- 1
আপনার অ্যাপ যোগ করুন
আপনার অ্যাকাউন্টের অ্যাপস বিভাগে দিন: অ্যাপের নাম, যে ঠিকানাগুলোতে এটি চলে এবং যে প্রজেক্টগুলোতে এর মতামত জমা হবে—যেমন, একটি আপনার টিমের জন্য, আরেকটি গ্রাহকদের জন্য। অ্যাপটির জন্য একটি কী পাবেন।
- 2
স্ক্রিপ্ট যোগ করুন
অ্যাপের সার্ভারে কী রাখা থাকে। যে ব্যক্তি সাইন ইন করেছেন, তাঁর জন্য সার্ভার পেজকে অল্প সময়ের একটি টোকেন দেয়, যাতে বলা থাকে তিনি আপনার টিমের সদস্য কি না। পেজে একটি স্ক্রিপ্ট ট্যাগ লোড হয়, আর আপনার নিজস্ব মতামত বোতাম দিয়ে সেটি খোলে। DropComments যা দেখায়, তা আপনার অ্যাপ তৈরি করা এজেন্টকে পেস্ট করে দিন; সে এগুলো যোগ করে দেবে।
- 3
মতামত আসতে থাকে
আপনার টিম মতামত বোতামে চাপ দিয়ে নির্দিষ্ট জায়গায় পিন করে লেখে; অ্যাপে সবার পিন ও প্রতিটি উত্তর সঙ্গে সঙ্গে দেখা যায়। অন্য সবাই ছোট একটি ফর্ম পায়। প্রতিটি মতামত সংশ্লিষ্ট প্রজেক্টে একটি Drop-এর স্ক্রিন হিসেবে জমা হয়।
SDK ইনস্টল করুন
যেসব ওয়েব অ্যাপে সার্ভার আছে এবং ব্যবহারকারীরা সাইন ইন করেন, সেগুলোর জন্য। ইনস্টল করার কোনো প্যাকেজ নেই: আপনার সার্ভারে একটি কী, পেজকে টোকেন দেওয়ার একটি এন্ডপয়েন্ট, একটি স্ক্রিপ্ট ট্যাগ ও সেটি খোলার জন্য আপনার নিজস্ব একটি বোতাম।
DropComments-এর অ্যাপস বিভাগে আপনার অ্যাপ যোগ করুন: অ্যাপের নাম, যে ঠিকানাগুলোতে এটি চলে (https, অথবা তৈরির সময় localhost ও .test-এ http) এবং যে প্রজেক্টগুলোতে এর মতামত জমা হবে। আপনি অ্যাপের কী ও প্রতিটি প্রজেক্টের আইডি পাবেন।
কী আপনার সার্ভারে রাখুন, সার্ভারের এনভায়রনমেন্ট বা সিক্রেটসে:
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"}}); }এটি 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;
অথবা আপনার কোডিং এজেন্টকে কাজটি করতে দিন। অ্যাপ যোগ করলে আপনার কী ও প্রজেক্টের আইডি আগে থেকেই বসানো একটি নির্দেশনা দেখা যায়; আপনার অ্যাপ তৈরি করা এজেন্টকে সেটি পেস্ট করে দিন। সে এন্ডপয়েন্ট, স্ক্রিপ্ট ও বোতাম যোগ করে দেবে।
রেফারেন্স
টোকেন
আপনার সার্ভার অ্যাপের কী বেয়ারার টোকেন হিসেবে দিয়ে 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 এক দিন মন্তব্যের জন্য খোলা থাকে, তারপর নতুন একটি শুরু হয়; Pro সেগুলো খোলা রাখে।
আরও পড়ুন
আপনার পরের ফাইলটি দিয়ে চেষ্টা করুন
লিংক পেতে প্রায় দশ সেকেন্ড লাগে।
একটি ফাইল দিন