Debug 面板

接線卡住時的救命指南

在後台一鍵打開 Debug 面板，看到 Widget 跟後端最近 3 個 endpoint 的完整 HTTP 互動。有錯誤碼對照表，有 cURL 一鍵複製，有「整份 log 餵給 AI 求救」的 prompt 範本 — 工程師、AI 都好用。

為什麼需要 Debug 面板？

Widget 嵌入後若沒反應，工程師會問三件事：...

登入客戶後台 → 進入您要 debug 的 Web Bot → ...

打開後會看到三大區塊：...

🔍 Widget 接線 Debug

Tokenweb_xxxxxxxx

最後一次成功 pingchungtair.com · 3 分鐘前

⚡ 立即測試連線📋 複製整份 Debug

📡 最近的請求（每種 endpoint 各 1 筆）

14:32:18POST/api/widget/message200 ✅

Originhttps://chungtair.com

IP1.2.3.4

Request{"token":"web_abc","message":"hi"}

Response{"success":true,"reply":"您好！..."}

耗時1.2 s

📋 複製為 cURL📋 複製為文字

14:32:15POST/api/widget/ping200 ✅

14:32:15GET/api/widget/config200 ✅

Status	訊息	Endpoint	可能原因	解法
`200`	success	`config/ping/message`	一切正常	無
`200`	客服暫停服務中	`message`	Bot 在後台被 owner 停用（enabled=false）	到後台啟用該 Bot
`400`	bad json	`ping`	Request body 不是合法 JSON	檢查 widget.js 是否被竄改 / 確認 Content-Type
`400`	reply: ""	`message`	訊息為空、不是字串、或超過 300 字	訊息控制在 1-300 字
`404`	invalid token	`config/ping`	Widget token 不存在或格式錯	Token 必須是 32 字小寫 hex；複製貼上不可被截斷
`404`	Widget 設定無效或已被刪除	`message`	同 invalid token，或該 Bot 已被刪	重新從後台複製嵌入代碼貼到網站
`429`	請求過於頻繁	`message`	IP 每分鐘 > 20 則訊息	訪客洗版或被攻擊；確認流量正常 / 加 IP 黑名單
`429`	請求過於頻繁	`ping`	IP 每分鐘 > 30 ping	通常是訪客瘋狂重整網頁；正常使用不會觸發
`500`	系統錯誤，請稍後再試	`message`	AI 那層出錯（OpenAI / RAG / handoff write）	稍候重試；若持續，看後台告警 / 聯絡客服

Debug 面板的「📋 複製整份 Debug」按鈕產生的純文字格式特別為 AI 設計...

我把忠台AI客服的 Widget 嵌入代碼貼到我的網站...