在你的應用程式內收集回饋
DropComments SDK
只要一個指令碼標籤、伺服器上的一個端點,以及你自己的「意見回饋」按鈕,就能在正在開發的應用程式內收集意見。團隊可直接在應用程式上釘選留言、畫框或繪圖,使用者則透過簡短表單提交意見。所有回饋都會送到這裡的專案中,讓你和 AI 代理回覆。
安裝 SDK免費開始使用。應用程式的金鑰會留在你的伺服器上。
對應用程式提意見,不該從截圖開始
測試應用程式的人發現問題時,得先截圖、裁切、貼到聊天室,再寫下「第二個畫面上面那個東西」。接著你得找出那個畫面,猜他指的是哪個東西。
在應用程式加入指令碼後,他們就能直接指出所在位置。送來的留言會附上當時的畫面截圖、標記的位置和提交者,讓你或程式開發代理著手修正,回覆也會顯示在應用程式內。
使用方式
- 1
新增應用程式
在帳戶的「應用程式」中,填入名稱、運作網址,以及接收意見回饋的專案,例如團隊用一個、客戶用另一個。新增後就會取得一組金鑰。
- 2
加入指令碼
伺服器保管金鑰,並依目前登入者向網頁提供短效權杖,註明對方是否屬於團隊。網頁載入一個指令碼標籤,再由你自己的「意見回饋」按鈕開啟。將 DropComments 顯示的內容貼給正在開發應用程式的代理,它就會幫你加入。
- 3
收到意見回饋
團隊按下「意見回饋」,在對應位置釘選並留言;所有人的標記和每則回覆,都會即時顯示在應用程式上。其他人則會看到簡短表單。每筆回饋都會成為所屬專案中某個 Drop 的畫面。
安裝 SDK
適用於有伺服器、且使用者會登入的網頁應用程式。不必安裝套件:只需伺服器上的金鑰、提供權杖給網頁的端點、一個指令碼標籤,以及你自己用來開啟它的按鈕。
在 DropComments 的「應用程式」中新增應用程式:填入名稱、運作網址(使用 https,開發時 localhost 和 .test 可使用 http),以及接收意見回饋的專案。你會取得應用程式的金鑰和各專案的 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"}}); }此處以 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 的說明;將它貼給正在開發應用程式的代理,它就會加入端點、指令碼和按鈕。
參考資料
權杖
伺服器以應用程式金鑰作為 bearer 權杖,呼叫 POST https://dropcomments.com/api/app/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 是你的端點,請求時會帶上網頁的 cookies;它可以回傳權杖的 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>
你能獲得什麼
團隊測試開發版本
在電腦或手機上,直接對運作中的應用程式釘選、畫框或繪圖。每則留言都會附上標記位置的畫面截圖,從電腦提交時還會附上網頁副本,所以只要說「這裡壞了」就夠了。
使用應用程式的人
簡短表單,附有「指出位置」功能和畫面截圖。他們不會看到其他人的意見回饋,而且只有在保留勾選時,才會傳送截圖。
Beta 測試者和客戶
讓一起試用的人登入,並決定誰算是團隊成員。客戶審閱測試站時,就能直接在上面留下意見。
由代理修正
連接 DropComments 的程式開發代理會讀取每則留言及留言所在的網頁,進行修改並回覆。回覆會顯示在應用程式內。
搭配應用程式的外觀
使用者表單會透過幾個 CSS 變數套用你的配色、字型和圓角;你也可以使用自己的表單,只需呼叫一次就能傳送。
金鑰由你保管
金鑰存放在你的伺服器上,絕不放在網頁中。只接受來自應用程式網址的意見回饋,每人都有提交數量限制,且各專案皆透過 ID 指定。
回饋直達收件匣
每則回饋都會成為所屬專案收件匣中的一張工單,等人接手。
常見問題
任何應用程式都能用嗎?
只要是有伺服器、且使用者會登入的網頁應用程式都可以:伺服器會告訴 DropComments 每個人的身分。遊戲和其他以 canvas 繪製畫面的應用程式也能使用;畫布會以圖片形式傳送。
團隊留言會傳送哪些內容?
一張保留當時畫面樣貌的圖片,其中標記為 data-dc-hide 的內容會以灰色遮蔽。從電腦送出時,還會附上網頁副本(除非你設定 data-capture="picture"):內含樣式與圖片,不含指令碼,已輸入的欄位會留白,標記為 data-dc-hide 的內容則會省略,另外還有該位置的局部圖片。Drop 會顯示圖片,使用電腦時也能切換成網頁。圖片是由指令碼根據網頁版面繪製,因此接近原貌,但不會完全一致:變形、濾鏡及 ::before 或 ::after 內容都會以一般樣式呈現。該畫面也會保留擷取時的資訊:網頁網址(不含 #fragment)、標題、視窗大小及瀏覽器。
可以將客戶和團隊的回饋分開嗎?
可以。一個應用程式可以將回饋送到多個專案,由伺服器依每個人的身分指定專案,讓團隊的回饋進入一個專案,其他人的回饋則進入另一個。
費用是多少?
所有方案都能使用。免費方案的每個回饋 Drop 會開放留言一天,之後會建立新的 Drop;Pro 則會持續開放。
繼續閱讀
下一份檔案,就用它試試
只要大約十秒,就能取得分享連結。
拖入檔案